---
title: "Configuração de OpenID Connect - Rest PKI Core"
description: "Como configurar o OpenID Connect para o gerenciamento de usuários do Rest PKI Core com uma assinatura do GrantID, criando a conexão de API e a aplicação frontend."
canonical: "https://docs.lacunasoftware.com/articles/rest-pki/core/on-premises/configure-oidc"
locale: "pt-BR"
product: "Rest PKI Core"
last_updated: "2026-10-12"
---

# Configuração de OpenID Connect - Rest PKI Core

Para fazer o gerenciamento de usuários, o [Rest PKI Core](https://docs.lacunasoftware.com/articles/rest-pki/core) requer um servidor OpenID Connect (OIDC), mais especificamente uma assinatura do [GrantID](https://docs.lacunasoftware.com/articles/grant-id).

Você pode usar uma assinatura SaaS em [grantid.com](https://grantid.com/) ou [executar sua própria instância do GrantID](https://docs.lacunasoftware.com/articles/grant-id/on-premises).

## Configurando o GrantID

Entre no portal do Console do GrantID e siga as instruções abaixo.

### Crie uma conexão de API

Na aba **Scopes**, clique em **New API Connection** para criar uma conexão de API para a aplicação, informando:

* **Name**: `restpkicore`
* **Display name**: `Rest PKI Core`
* **User Informations (claims)**: marque todos

### Aplicação frontend

Na aba **Applications**, clique em **New Application** e informe:

* **Name**: `Rest PKI Core`
* **App-id**: `restpkicore`
* **Type**: selecione `Implicit flow`.

Clique na aba **Settings** e defina:

* Marque a caixa de seleção `Allow Access tokens via browser?` (se ainda não estiver marcada)
* Desmarque as seguintes caixas de seleção (se estiverem marcadas): `Require consent?`, `Front-channel logout session required?` e `Back-channel logout session required?`
* **Application URL**: a URL da sua aplicação. Exemplo: `https://restpkicore.yourcompany.com`
* **Allowed URLs**:
  * **Redirect**: você deve adicionar 4 URLs de redirecionamento baseadas na URL da sua aplicação:
    * `<applicationURL>` sem barra no final.
    * `<applicationURL>/silent-refresh.html`
    * `<applicationURL>/private/profile/refresh`
    * `<applicationURL>/private`
  * **CORS origins**: `<applicationURL>` sem barra no final.
  * **Post Logout**: `<applicationURL>` sem barra no final.
* **Allowed Identification Scopes**: marque todos
* **Allowed API scopes**: marque a caixa de seleção do escopo de API `Rest PKI Core`
* Marque as seguintes caixas de seleção: `Enable digital certificate login?`, `Prioritize digital certificate login?` e `Require digital certificate login?`

> **Aviso**
>
> Não se esqueça de salvar as alterações clicando no botão ao final da página.

### Aplicação backend

Na aba **Applications**, clique novamente em **New Application** e informe:

* **Name**: `Rest PKI Core Backend`
* **App-id**: `restpkicore-backend`
* **Type**: selecione `Client credentials`.

Clique na aba **Settings** e defina:

* **Allowed API scopes**: marque a caixa de seleção `Manage subscription's users`.

> **Aviso**
>
> Não se esqueça de salvar as alterações clicando no botão ao final da página.

Depois de salvar, volte à aba **Basic Details** e, na seção **App Secret**, clique em **Generate** e depois em **Generate Secret**.
Esse é o valor da configuração `AppSecret` (copie-o e guarde-o para usar depois).

## Configurando o Rest PKI Core para usar o GrantID

Depois de seguir os passos acima para configurar o GrantID, preencha a seção **Oidc** do arquivo de configuração:

* **Authority**: a autoridade OIDC (ex.: *https://login.id.patorum.com*)
* **ApiEndpoint**: o endpoint de API do servidor OIDC (ex.: *https://api.id.patorum.com*)
* **ApiName**: `restpkicore`
* **ClientAppId**: `restpkicore`
* **AppId**: `restpkicore-backend`
* **AppSecret**: o secret gerado para a aplicação backend
* **RequireHttps** (opcional): defina como `false` se a instância do GrantID não usar HTTPS

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

```ini
[Oidc]
Enabled=True
Authority=https://login.id.patorum.com
ApiEndpoint=https://api.id.patorum.com
ApiName=restpkicore
ClientAppId=restpkicore
AppId=restpkicore-backend
AppSecret=YOUR_BACKEND_APP_SECRET
```

Exemplo (variáveis de ambiente):

```bash
Oidc__Enabled=True
Oidc__Authority=https://login.id.patorum.com
Oidc__ApiEndpoint=https://api.id.patorum.com
Oidc__ApiName=restpkicore
Oidc__ClientAppId=restpkicore
Oidc__AppId=restpkicore-backend
Oidc__AppSecret=YOUR_BACKEND_APP_SECRET
```

## Veja também

* [GrantID](https://docs.lacunasoftware.com/articles/grant-id)