Licenciamento
Capacidades, níveis de licença e o serviço de licença
Esta página é a referência em tempo de execução de como uma licença molda o comportamento do Doconut: o que cada estado de licença permite, como as capacidades são concedidas e como inspecionar tudo isso a partir do código. (Para carregar uma licença, veja Configuração de Licença.)
Estados de licença e o que eles fazem
| Estado | Abre documentos? | Marca d'água | Capacidades |
|---|---|---|---|
| Licença completa (paga) (esta compilação foi lançada antes da data de assinatura) | Sim | Nenhuma | As adquiridas (Has* flags) |
| Licença temporária (Desenvolvedor/NFR — a licença de avaliação, antes da data de expiração) | Sim | Nenhuma no visualizador base; a saída do plugin tem marca d'água | Todas — concessão total (o funil de avaliação) |
Licença temporária expirada (após sua data LicenseExpiry) | Sim | Marca d'água de avaliação | Nenhuma concedida |
| Nenhum arquivo de licença | Sim | Marca d'água de avaliação | Nenhuma concedida |
| Encontrada mas rejeitada (assinatura inválida, adulterada, na lista negra, ou uma compilação lançada após a data de assinatura da licença) | Não — LicenseException em cada abertura | — | — |
Uma licença paga cuja data de assinatura já passou continua funcionando — limpa, com suas capacidades — em todas as compilações lançadas antes dessa data. Apenas uma compilação lançada depois dela é rejeitada.
Duas consequências que vale a pena internalizar:
- Uma licença ausente não é uma licença temporária. Sem arquivo de licença, as páginas são exibidas com marca d'água e nenhuma capacidade (pesquisa, anotação, plugins) está ativa. A experiência completa, sem marca d'água, requer uma Licença temporária (obtenha uma).
- Só uma licença rejeitada bloqueia a abertura. Uma Licença Temporária expirada mantém o aplicativo em execução com a marca d'água de avaliação, e uma licença paga após sua data de assinatura continua renderizando limpa nas compilações que cobre; porém, implantar uma compilação lançada depois da data de assinatura da licença é rejeitado e falha rapidamente com um
LicenseException, assim você a detecta na implantação — não enviando silenciosamente saída com marca d'água. Essa exceção (deOpenDocumentAsync) traz o motivo deLicense.RejectionMessage.
Capacidades
O Doconut controla a funcionalidade opcional por capacidade. Ele abrange os recursos internos Search e Annotation e os plugins opcionais Converter, Dicom e Signer, cada um concedido pela sua licença. O visualizador base não é uma capacidade — é o pré-requisito, exposto como IsViewerLicensed:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licença non-TRIAL presente E cobrindo a versão da buildO único ponto de controle que todo o pipeline usa é IsCapabilityGranted:
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
bool searchGranted = lic.IsCapabilityGranted(LicenseCapability.Search);Sua lógica, literalmente da implementação: uma licença Temporária ativa (não expirada) concede todas as capacidades — incluindo capacidades que ainda não têm uma flag de compra dedicada; uma licença realmente comprada concede exatamente suas flags Has* e tem negação padrão para qualquer coisa não mapeada. (Um arquivo legado do tipo TRIAL não é um direito — ele é tratado como não licenciado: com marca d'água, nada concedido.)
Licenças temporárias
As licenças temporárias (Desenvolvedor/NFR) são marcadas por uma tag ExpiryNote e possuem uma data de expiração rígida:
| Membro | Significado |
|---|---|
IsTemporary | Uma tag ExpiryNote está presente (a detecção é pela presença da tag — nunca corresponde ao texto da nota, é dinâmico) |
ExpiryNote | Texto informativo incorporado na licença |
LicenseExpiry | A data de expiração rígida (DateTime?) |
A semântica de expiração difere por nível: uma licença temporária expira na sua LicenseExpiry apenas data (sua janela de assinatura é ignorada; uma licença temporária sem a data é tratada como expirada, à prova de falhas). Todas as outras licenças expiram na data da janela de assinatura/atualização; para uma licença paga, IsExpired apenas relata que essa data passou — compilações lançadas antes dela permanecem limpas e mantêm suas capacidades.
Referência do IDoconutLicenseService
Resolva IDoconutLicenseService (namespace Doconut.Core.Interfaces) de DoconutHost.Services. É um singleton — a licença é analisada uma vez, em DoconutHost.Initialize:
| Membro | Significado |
|---|---|
License | Instantâneo completo do DoconutLicenseInfo (abaixo) |
IsTrial | Um arquivo legado do tipo TRIAL (tratado como não licenciado — não é um direito) |
IsTemporary / ExpiryNote / LicenseExpiry | Marcadores de licença temporária |
IsExpired | Expirado de acordo com as regras de nível acima |
IsVersionValid | Esta compilação está dentro da janela de suporte da licença |
IsViewerLicensed | Arquivo não-TRIAL encontrado e versão coberta — pré-requisito básico |
IsCapabilityGranted(cap) | O único portão de capacidade |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Um sinalizador por capacidade: adquirido por uma licença que cobre esta compilação, ou concedido por uma licença Temporária ativa. IsCapabilityGranted responde à mesma pergunta por capacidade |
IsValidForDomain(host) | Cobertura de host; licenças V4 usam o curinga *.* |
LicenseRejectionReason | Não vazio ⇒ a abertura é bloqueada com esta mensagem |
DoconutLicenseInfo expõe o instantâneo amigável para exibição nos painéis de administração: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, os sinalizadores Has*, os campos de licença temporária e RejectionMessage.
// GET /Features - feature-flag sua UI a partir da mesma fonte de verdade que o SDK usa
public ActionResult Index()
{
var lic = Doconut.DoconutHost.Services.GetRequiredService<IDoconutLicenseService>();
return Json(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}, JsonRequestBehavior.AllowGet);
}Verificação de saúde
Doconut registra uma verificação de saúde "doconut" que relata o estado da licença. O Classic ASP.NET não possui um endpoint de saúde próprio, portanto exponha‑o a partir de um controlador:
// GET /Health - Doconut registra uma "doconut" verificação de saúde que relata o estado da licença:
// Saudável (válido), Degradado (teste ou sem arquivo de licença), Não saudável (rejeitado ou expirado).
public async Task<ActionResult> Index()
{
var health = Doconut.DoconutHost.Services.GetRequiredService<HealthCheckService>();
HealthReport report = await health.CheckHealthAsync();
Response.StatusCode = report.Status == HealthStatus.Unhealthy ? 503 : 200;
return Content(report.Status.ToString(), "text/plain");
}Integre‑a ao seu monitoramento e uma assinatura que está expirando se torna um alerta em vez de um ticket de suporte. A verificação relata Unhealthy quando a licença é rejeitada ou IsExpired é verdadeiro; para uma licença paga, isso significa que a data de assinatura passou e um pacote lançado depois dela será rejeitado — a compilação atual continua renderizando corretamente. Veja DoconutHost para os valores de status.
Atualizações de versão
Uma licença cobre uma janela de versão. Atualizar o pacote NuGet para uma compilação mais recente que essa janela torna a licença inválida para esta compilação: IsVersionValid transforma false e a abertura é bloqueada com um LicenseException (o motivo está em License.RejectionMessage) — falha rápida deliberada, para que uma compilação obsoleta ou não licenciada seja detectada na implantação em vez de marcar silenciosamente a saída de produção. Renove a assinatura, substitua o .lic em wwwroot e recicle o pool de aplicativos para que DoconutHost.Initialize carregue a nova licença.
Esta página foi útil?