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

EstadoAbre documentos?Marca d'águaCapacidades
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çãoNenhuma concedida
Nenhum arquivo de licençaSimMarca d'água de avaliaçãoNenhuma 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 (de OpenDocumentAsync) traz o motivo de License.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:

csharp
var lic = Doconut.DoconutHost.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 = 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:

MembroSignificado
IsTemporaryUma tag ExpiryNote está presente (a detecção é pela 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 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:

MembroSignificado
LicenseInstantâneo completo do 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
IsExpiredExpirado de acordo com 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 básico
IsCapabilityGranted(cap)O único portão de capacidade
HasSearch HasAnnotation HasEditor HasConverter HasDicom HasDocumentTools HasSigner HasRedactor HasComparer HasForms HasProtector HasCompressorUm 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 *.*
LicenseRejectionReasonNã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.

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

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