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 Primeiros Passos → 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 sua data de assinatura) | Sim | Nenhuma | As compradas (flags Has*) |
| Licença temporária (Desenvolvedor/NFR — a licença de avaliação, antes da sua 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 renderizadas 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, de modo que você o captura na implantação — não ao enviar silenciosamente saída com marca d'água. Essa exceção (deOpenDocumentAsync) traz a razão deLicense.RejectionMessage.
Capacidades
Doconut controla a funcionalidade opcional por capacidade. Ela abrange os recursos integrados de Pesquisa e Anotação e os plugins opcionais Conversor, Dicom e Assinador, cada um concedido pela sua licença. O visualizador base não é uma capacidade — é o pré-requisito, exposto como IsViewerLicensed:
var lic = app.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 = app.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 possuem 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
Licenças temporárias (Desenvolvedor/NFR) são marcadas por uma tag ExpiryNote e possuem uma data de expiração fixa:
| 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 fixa (DateTime?) |
A semântica de expiração difere por nível: uma licença temporária expira na sua data LicenseExpiry (sua janela de assinatura é ignorada; uma licença temporária sem a data é tratada como expirada, segurança de falha). 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 IDoconutLicenseService
Injete IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrado como singleton — a licença é analisada uma vez na inicialização):
| Membro | Significado |
|---|---|
License | Instantâneo completo 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 | Expirada conforme 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 base |
IsCapabilityGranted(cap) | O único ponto de controle de capacidade |
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressor | Uma flag por capacidade: comprada por uma licença que cobre esta compilação, ou concedida por uma licença Temporária ativa. IsCapabilityGranted responde a 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 em painéis de administração: Owner, LicenseType, Domain, IsLicenseFileFound, IsVersionValid, IsTrial, IsExpired, as flags Has*, os campos de licença temporária, e RejectionMessage.
// Feature-flag sua UI a partir da mesma fonte de verdade que o SDK usa
app.MapGet("/api/features", (IDoconutLicenseService lic) => Results.Ok(new
{
viewer = lic.IsViewerLicensed || lic.IsTemporary,
search = lic.IsCapabilityGranted(LicenseCapability.Search),
annotation = lic.IsCapabilityGranted(LicenseCapability.Annotation),
conversion = lic.HasConverter,
dicom = lic.HasDicom,
}));Verificação de saúde
AddDoconut() registra uma verificação de saúde "doconut" que relata o estado da licença/expiração através do mecanismo padrão do ASP.NET Core:
app.MapHealthChecks("/health");Integre-a ao seu monitoramento e uma assinatura que está expirando se torna um alerta ao invés 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 limpa.
Atualizações de versão
Uma licença cobre uma janela de versão. Atualizar o pacote NuGet para uma compilação mais nova que essa janela torna a licença inválida para esta compilação: IsVersionValid transforma false e a abertura é bloqueada com um LicenseException (a razão está em License.RejectionMessage) — falha rápida deliberada, para que uma compilação obsoleta ou não licenciada seja detectada na implantação ao invés de marcar silenciosamente a saída de produção. Renove a assinatura, substitua o .lic e reinicie a aplicação para que AddDoconut() carregue a nova licença.
Esta página foi útil?