Habilitando o LAPP

O LAPP vem desligado em todos os produtos. Para ligá-lo, são dois passos:

1. Defina a configuração de LAPP do produto como true, como mostrado abaixo para cada produto.
2. Entre em contato com o suporte e peça que autorizem o LAPP para a sua licença do PKI SDK. Enquanto isso não acontece, o LAPP recusa as suas requisições e a configuração não tem efeito.

Antes de começar, verifique se o servidor acessa o LAPP.

Produto	Configuração
PKI SDK	PkiConfig.LappEnabled = true
PKI Express	pkie config --set lappEnabled=true
Rest PKI (on-premises)	LacunaPki.LappEnabled no AppSettings.config
Rest PKI Core, Signer, Amplia, GeCert, PSC e TSA (on-premises)	LappEnabled na seção PkiSuite, ou a variável de ambiente PkiSuite__LappEnabled

Nos serviços em nuvem da Lacuna (Rest PKI Core, Signer, Amplia e outros hospedados pela Lacuna Software) não há nada a fazer: o LAPP é infraestrutura da própria Lacuna.

PKI SDK

Defina PkiConfig.LappEnabled uma vez, na inicialização da aplicação, depois de carregar a licença. As requisições ao LAPP trazem o ID e o nome do licenciado da licença, então ela precisa já estar carregada.

using Lacuna.Pki;

PkiConfig.LoadLicense(Convert.FromBase64String(sdkLicenseBase64));
PkiConfig.LappEnabled = true;

As requisições ao LAPP usam as mesmas configurações dos downloads do próprio SDK:

Propriedade de PkiConfig	Efeito no LAPP
CrlDownloadTimeout	Tempo limite de uma requisição de LCR ao LAPP
CAIssuersDownloadTimeout	Tempo limite de uma requisição de certificado de AC ao LAPP
WebProxy	O proxy por onde passam as requisições ao LAPP

O SDK só recorre ao LAPP depois que o download da URL da própria AC falha, então uma validação que cai no LAPP leva até dois timeouts: o do download direto e o da requisição ao LAPP. Se o firewall descarta os pacotes enviados às URLs das ACs em vez de rejeitá-los, cada download direto espera o timeout inteiro antes que o SDK tente o LAPP.

PKI Express

pkie config --set lappEnabled=true

Veja Integração com o LAPP - PKI Express e as demais configurações do PKI Express.

Rest PKI (on-premises)

No arquivo AppSettings.config da sua instância on-premises do Rest PKI, defina:

<add key="LacunaPki.LappEnabled" value="True" />

Depois reinicie o site.

Rest PKI Core, Signer, Amplia, GeCert, PSC e TSA (on-premises)

Esses servidores leem as configurações do PKI SDK da seção PkiSuite, a mesma que contém a configuração SdkLicense. Acrescente LappEnabled a ela, no formato do arquivo de configuração da sua instalação, e reinicie o serviço.

Arquivo de configuração JSON (appsettings.*.json):

"PkiSuite": {
    "SdkLicense": "...",
    "LappEnabled": true
}

Arquivo de configuração INI (o appsettings.ini do Rest PKI Core no Windows e o /etc/restpkicore/appsettings.conf no Linux):

[PkiSuite]
SdkLicense=...
LappEnabled=true

Variável de ambiente (Docker, app settings do Azure App Service):

PkiSuite__LappEnabled=true

Onde cada produto guarda a seção PkiSuite:

Produto	Onde
Rest PKI Core	Windows Server: C:\ProgramData\Lacuna Software\Rest PKI Core\appsettings.ini. Linux: /etc/restpkicore/appsettings.conf. Azure: app settings do App Service
Signer	Linux: /etc/lacuna-signer/appsettings.linux.json. Windows Server: appsettings.iis.json. Docker e Azure: variáveis de ambiente
Amplia	O arquivo de configuração ou as variáveis de ambiente da sua instalação
GeCert	As configurações da sua instalação
PSC, TSA	As configurações da sua instalação (PSC, TSA)

Depois de habilitar

O LAPP só entra em ação quando um download da URL de uma AC falha, então uma instalação que funciona não mostra diferença no dia a dia. Para vê-lo funcionando, valide um certificado cuja URL de LCR o servidor não acessa: a validação deve dar certo em vez de terminar com o status de revogação desconhecido. Se ela continuar falhando, veja Solução de problemas.