---
title: "Habilitando o LAPP"
description: "Como habilitar o LAPP em cada produto da Lacuna: PkiConfig.LappEnabled no PKI SDK, lappEnabled no PKI Express, LacunaPki.LappEnabled no Rest PKI e PkiSuite:LappEnabled no Rest PKI Core, Signer, Amplia, GeCert, PSC e TSA."
canonical: "https://docs.lacunasoftware.com/articles/lapp/configuration"
locale: "pt-BR"
product: "LAPP"
last_updated: "2026-10-22"
---

# 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](https://lacuna.help) 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](https://docs.lacunasoftware.com/articles/lapp#check).

| Produto | Configuração |
|---|---|
| [PKI SDK](https://docs.lacunasoftware.com/articles/lapp/configuration#pki-sdk) | `PkiConfig.LappEnabled = true` |
| [PKI Express](https://docs.lacunasoftware.com/articles/lapp/configuration#pki-express) | `pkie config --set lappEnabled=true` |
| [Rest PKI (on-premises)](https://docs.lacunasoftware.com/articles/lapp/configuration#rest-pki) | `LacunaPki.LappEnabled` no `AppSettings.config` |
| [Rest PKI Core, Signer, Amplia, GeCert, PSC e TSA (on-premises)](https://docs.lacunasoftware.com/articles/lapp/configuration#pkisuite) | `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`](https://docs.lacunasoftware.com/api/Lacuna.Pki/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.

```csharp
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

```sh
pkie config --set lappEnabled=true
```

Veja [Integração com o LAPP - PKI Express](https://docs.lacunasoftware.com/articles/pki-express/config/lapp) e as demais [configurações do PKI Express](https://docs.lacunasoftware.com/articles/pki-express/config).

## Rest PKI (on-premises)

No arquivo `AppSettings.config` da sua instância [on-premises do Rest PKI](https://docs.lacunasoftware.com/articles/rest-pki/on-premises), defina:

```xml
<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`):

```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):

```ini
[PkiSuite]
SdkLicense=...
LappEnabled=true
```

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

```sh
PkiSuite__LappEnabled=true
```

Onde cada produto guarda a seção `PkiSuite`:

| Produto | Onde |
|---|---|
| Rest PKI Core | [Windows Server](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/windows-server): `C:\ProgramData\Lacuna Software\Rest PKI Core\appsettings.ini`. [Linux](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/linux/install-ubuntu): `/etc/restpkicore/appsettings.conf`. [Azure](https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/azure/install): app settings do App Service |
| Signer | [Linux](https://docs.lacunasoftware.com/articles/signer/on-premises/linux/install-ubuntu): `/etc/lacuna-signer/appsettings.linux.json`. [Windows Server](https://docs.lacunasoftware.com/articles/signer/on-premises/windows): `appsettings.iis.json`. [Docker](https://docs.lacunasoftware.com/articles/signer/on-premises/docker) e [Azure](https://docs.lacunasoftware.com/articles/signer/on-premises/azure): variáveis de ambiente |
| Amplia | O arquivo de configuração ou as variáveis de ambiente da sua [instalação](https://docs.lacunasoftware.com/articles/amplia/on-premises) |
| GeCert | As configurações da sua [instalação](https://docs.lacunasoftware.com/articles/gecert/on-premises) |
| PSC, TSA | As configurações da sua instalação ([PSC](https://docs.lacunasoftware.com/articles/psc/on-premises), [TSA](https://docs.lacunasoftware.com/articles/tsa/on-premises)) |

## 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](https://docs.lacunasoftware.com/articles/lapp/troubleshooting).