Licenciamento

Recursos, 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 os recursos são concedidos 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

EstadoAbre documentos?Marca d'águaRecursos
Licença completa (paga) (esta compilação foi lançada antes da data de assinatura)SimNenhumaAs adquiridas (Has* flags)
Licença temporária (Desenvolvedor/NFR — a licença de avaliação, antes da data de expiração)SimNenhuma no visualizador base; a saída do plugin tem marca d'águaTodas — concessão total (o funil de avaliação)
Licença temporária expirada (após sua data LicenseExpiry)SimMarca d'água de avaliaçãoNenhum concedido
Nenhum arquivo de licençaSimMarca d'água de avaliaçãoNenhum concedido
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 expirou continua funcionando — limpa, com seus recursos — 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 nenhum recurso (pesquisa, anotação, plugins) está ativo. 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; mas implantar uma compilação lançada depois da data de assinatura da licença é rejeitado e falha rapidamente com um LicenseException, assim você a captura na implantação — não enviando silenciosamente saída com marca d'água. Essa exceção (de OpenDocumentAsync) traz o motivo de License.RejectionMessage.

Recursos

Doconut controla a funcionalidade opcional por recurso. Ele abrange os recursos embutidos Search e Annotation e os plugins opcionais Converter, Dicom e Signer, cada um concedido pela sua licença. O visualizador base não é um recurso — é o pré-requisito, exposto como IsViewerLicensed:

csharp
var lic = app.Services.GetRequiredService<IDoconutLicenseService>();
bool viewerLicensed = lic.IsViewerLicensed; // licença non-TRIAL presente E cobrindo a versão da build

O único ponto de controle que todo o pipeline usa é IsCapabilityGranted:

csharp
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 todos os recursos — incluindo recursos que ainda não têm uma bandeira de compra dedicada; uma licença comprada real concede exatamente suas bandeiras 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 rígida:

MembroSignificado
IsTemporaryUma tag ExpiryNote está presente (a detecção é por presença da tag — nunca corresponde ao texto da nota, é dinâmico)
ExpiryNoteTexto informativo incorporado na licença
LicenseExpiryA 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 data LicenseExpiry (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 seus recursos.

Referência IDoconutLicenseService

Injete IDoconutLicenseService (namespace Doconut.Core.Interfaces; registrado como singleton — a licença é analisada uma vez na inicialização):

MembroSignificado
LicenseInstantâneo completo DoconutLicenseInfo (abaixo)
IsTrialUm arquivo legado do tipo TRIAL (tratado como não licenciado — não é um direito)
IsTemporary / ExpiryNote / LicenseExpiryMarcadores de licença temporária
IsExpiredExpirada conforme as regras de nível acima
IsVersionValidEsta compilação está dentro da janela de suporte da licença
IsViewerLicensedArquivo não-TRIAL encontrado e versão coberta — pré-requisito base
IsCapabilityGranted(cap)O único ponto de controle de recurso
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUma bandeira por recurso: adquirida por uma licença que cobre esta compilação, ou concedida por uma licença Temporária ativa. IsCapabilityGranted responde a mesma pergunta por recurso
IsValidForDomain(host)Cobertura de host; licenças V4 usam o curinga *.*
LicenseRejectionReasonNã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 bandeiras Has*, os campos de licença temporária, e RejectionMessage.

csharp
// 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:

csharp
app.MapHealthChecks("/health");

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 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 (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 e reinicie a aplicação para que AddDoconut() carregue a nova licença.

Esta página foi útil?