---
title: "GeCert *on premises*"
description: "GeCert on-premises: instância hospedada pela Lacuna ou na sua infraestrutura (Windows Server, Linux ou Docker), os pré-requisitos (SQL Server, GrantID, licença do PKI SDK) e as seções de configuração."
canonical: "https://docs.lacunasoftware.com/articles/gecert/on-premises"
locale: "pt-BR"
product: "GeCert"
last_updated: "2026-10-13"
---

# GeCert *on premises*

O [GeCert](https://docs.lacunasoftware.com/articles/gecert) pode ser usado em uma instância hospedada pela Lacuna ou você pode ter uma instância na sua própria
infraestrutura ("on premises").

## Ambientes suportados

O GeCert é uma aplicação ASP.NET Core (.NET 6), distribuída como pacote para instalação ou como imagem Docker, compatível com os seguintes
ambientes:

* Windows Server
* Linux
* Docker

> **Observação**
>
> As instruções de instalação encontram-se em construção. Se você precisar de instruções ainda indisponíveis, por favor contate-nos.

## Pré-requisitos

* Um banco de dados **SQL Server**, informado na *connection string* `ConnectionStrings:DefaultConnection`. O modelo do banco é criado e
  atualizado pela própria aplicação. 
* Uma assinatura do **[GrantID](https://docs.lacunasoftware.com/articles/grant-id)**, em nuvem ou on-premises, para a autenticação dos usuários. Veja
  [Configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc).
* Uma licença do **[PKI SDK](https://docs.lacunasoftware.com/articles/pki-sdk)**, em Base64, na configuração `PkiSuite:SdkLicense`.
* Um repositório de chaves, além do banco de dados, se você for guardar as chaves em um HSM, no Azure Key Vault ou em um dispositivo
  PKCS #11. Veja [Configuração de repositórios de chaves](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-key-stores).
* Para os usuários, o [Gecert Connect](https://docs.lacunasoftware.com/articles/gecert/gecert-connect) instalado no Windows, apontando para a instância. Veja
  [Configuração do Gecert Connect no servidor](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-gecert-connect).

## Configuração

A configuração fica no arquivo `appsettings.json` da aplicação, em um arquivo `.ini` ou `.conf` ou em variáveis de ambiente, como nos
demais produtos da Lacuna: a seção `Oidc` corresponde à variável `Oidc__Authority`, e assim por diante. 

| Seção | O que configura |
|---|---|
| `ConnectionStrings:DefaultConnection` | A *connection string* do SQL Server |
| `General` | `SiteUrl`, o endereço público da instância; `SiteName`, o nome exibido na tela de entrada (padrão: `Gecert`); `EncryptionKey`, a chave que protege os dados sensíveis guardados pela aplicação |
| `Oidc` | A integração com o GrantID. Veja [Configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc) |
| `KeyStores` | Os repositórios de chaves. Veja [Configuração de repositórios de chaves](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-key-stores) |
| `GecertConnect` | O que o Gecert Connect lê do servidor. Veja [Configuração do Gecert Connect no servidor](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-gecert-connect) |
| `PkiSuite:SdkLicense` | A licença do PKI SDK, em Base64 |
| `BlobStorage` | Onde a aplicação guarda os arquivos enviados (os PKCS #12 e certificados, apagados depois de importados) e as CSRs das chaves: `Type` `FileSystem` com `Path`, ou um armazenamento em nuvem com `ConnectionString` e `ContainerName`, como no [Amplia](https://docs.lacunasoftware.com/articles/amplia/on-premises/configure-blob-storage) |
| `Email` | O servidor SMTP usado para os convites de usuários: `ServerHost`, `SenderAddress`, `SenderName`, `Username` e `Password`, como no [Amplia](https://docs.lacunasoftware.com/articles/amplia/on-premises/configure-email) |
| `Serilog` | Os logs da aplicação |

## Veja também

* [Configuração de repositórios de chaves](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-key-stores)
* [Configuração do Gecert Connect no servidor](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-gecert-connect)
* [Configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc)
* [Verificando a versão instalada do GeCert](https://docs.lacunasoftware.com/articles/gecert/on-premises/check-version)
* [Histórico de versões](https://docs.lacunasoftware.com/articles/gecert/changelog)