---
title: "Configuração do Gecert Connect no servidor - GeCert"
description: "Configuração da seção GecertConnect do servidor GeCert: a aplicação do GrantID para o Gecert Connect, o endereço do servidor, a versão mínima do aplicativo e o modo de manutenção."
canonical: "https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-gecert-connect"
locale: "pt-BR"
product: "GeCert"
last_updated: "2026-10-13"
---

# Configuração do Gecert Connect no servidor - GeCert

O [Gecert Connect](https://docs.lacunasoftware.com/articles/gecert/gecert-connect) lê do servidor [GeCert](https://docs.lacunasoftware.com/articles/gecert), sem autenticação, o endereço a usar e os dados para o login
pelo GrantID. Esses dados ficam na seção **GecertConnect** da configuração do servidor.

## Aplicação do Gecert Connect no GrantID

O Gecert Connect faz o login pelo OpenID Connect com os escopos `openid`, `profile`, `offline_access` e o escopo da API do GeCert (o mesmo
`ApiName` da [configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc)). Ele precisa de uma aplicação própria no GrantID, diferente da aplicação
da interface web, com:

* o fluxo *authorization code* com PKCE, próprio de aplicativos nativos;
* acesso *offline* permitido, para que o aplicativo receba um *refresh token* e renove a sessão sem pedir a senha de novo;
* o escopo de API do GeCert entre os escopos de API permitidos;
* uma URI de redirecionamento. O Gecert Connect intercepta a navegação para essa URI dentro da própria janela de login, de modo que ela
  não precisa responder: pode ser, por exemplo, `https://endereco-do-seu-gecert/gecert-connect/callback`.

Crie a aplicação no console do GrantID como descrito na [configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc), anotando o *App-id* dela.

## Seção GecertConnect

* **ServerUrl**: o endereço público da instância do GeCert, que o Gecert Connect passa a usar, por exemplo `https://gecert.suaempresa.com.br/`
* **GrantIdAuthority**: a autoridade OIDC do GrantID (o mesmo valor de `Oidc:Authority`)
* **GrantIdClientAppId**: o *App-id* da aplicação do Gecert Connect no GrantID
* **GrantIdApiName**: o nome da API do GeCert no GrantID (o mesmo valor de `Oidc:ApiName`)
* **GrantIdRedirectUri**: a URI de redirecionamento registrada na aplicação do Gecert Connect
* **MinSupportedVersion** (opcional): a menor versão do Gecert Connect aceita pelo servidor. Aplicativos mais antigos mostram a tela
  **Atualização Necessária** e param de funcionar até serem atualizados. O padrão é `1.1.0.0`
* **UnderMaintenance** (opcional): `True` para colocar o Gecert Connect em modo de manutenção: o aplicativo para de chamar o servidor,
  mostra a tela de manutenção e volta sozinho quando o valor for `False`. O padrão é `False`

Os cinco primeiros valores são obrigatórios para o Gecert Connect: enquanto algum faltar, a rota `GET /api/app-configuration/gecert-connect/server`
responde com o erro `GecertConnectServerNotConfigured`, e o aplicativo mostra **Erro ao configurar o servidor**.

Exemplo (arquivo de configuração *.ini* ou *.conf*):

```ini
[GecertConnect]
ServerUrl=https://gecert.suaempresa.com.br/
GrantIdAuthority=https://login.id.patorum.com
GrantIdClientAppId=gecert-connect
GrantIdApiName=gecert
GrantIdRedirectUri=https://gecert.suaempresa.com.br/gecert-connect/callback
MinSupportedVersion=1.2.0.0
```

Exemplo (variáveis de ambiente):

```bash
GecertConnect__ServerUrl=https://gecert.suaempresa.com.br/
GecertConnect__GrantIdAuthority=https://login.id.patorum.com
GecertConnect__GrantIdClientAppId=gecert-connect
GecertConnect__GrantIdApiName=gecert
GecertConnect__GrantIdRedirectUri=https://gecert.suaempresa.com.br/gecert-connect/callback
GecertConnect__MinSupportedVersion=1.2.0.0
```

## Distribuindo a configuração aos usuários

Depois de configurar o servidor, envie aos usuários o link de configuração, que eles abrem com o Gecert Connect instalado:

```text
gecertconnect://server/gecert.suaempresa.com.br
```

O aplicativo consulta o servidor, guarda a configuração e confirma com a mensagem **Servidor configurado**. Veja
[Configuração do servidor](https://docs.lacunasoftware.com/articles/gecert/gecert-connect#configuração-do-servidor).

## Veja também

* [Gecert Connect](https://docs.lacunasoftware.com/articles/gecert/gecert-connect)
* [Configuração de OpenID Connect](https://docs.lacunasoftware.com/articles/gecert/on-premises/configure-oidc)