---
title: "Configuração de OpenID Connect - Amplia"
description: "Como configurar o OpenID Connect no Amplia, que requer uma assinatura do GrantID: conexão de API, aplicações frontend e backend e acesso de root."
canonical: "https://docs.lacunasoftware.com/articles/amplia/on-premises/configure-oidc"
locale: "pt-BR"
product: "Amplia"
last_updated: "2026-10-08"
---

# Configuração de OpenID Connect - Amplia

O [Amplia](https://docs.lacunasoftware.com/articles/amplia) requer 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

Acesse o portal do Console do GrantID e siga as instruções abaixo.

### Criar 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**: `amplia`
* **Display name**: `Amplia`
* **User Informations (claims)**: marque todos

### Aplicação frontend

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

* **Name**: `Amplia`
* **App-id**: `amplia`
* **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 marcadas): `Require consent?`, `Front-channel logout session required?` e `Back-channel logout session required?`
* **Application URL**: a URL da sua aplicação. Exemplo: `https://amplia.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 `Amplia`
* 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 suas 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**: `Amplia Backend`
* **App-id**: `amplia-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 suas alterações clicando no botão ao final da página.

Após salvar, retorne à aba **Basic Details** e, na seção **App Secret**, clique em **Generate** e depois em **Generate Secret**.
Este é o valor da configuração `AppSecret` (copie-o e guarde-o para usar depois).

## Configurando o Amplia para usar o GrantID

Após seguir as etapas acima para configurar o GrantID, preencha a seção **Oidc** do arquivo de configuração:

* **Enabled**: se a integração com OpenID Connect está habilitada — `True` (padrão) ou `False` (enquanto estiver como `False`, o acesso é feito com a senha de *root*)
* **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**: `amplia`
* **ClientAppId**: `amplia`
* **AppId**: `amplia-backend`
* **AppSecret**: o segredo 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=amplia
ClientAppId=amplia
AppId=amplia-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=amplia
Oidc__ClientAppId=amplia
Oidc__AppId=amplia-backend
Oidc__AppSecret=YOUR_BACKEND_APP_SECRET
```

Exemplo (arquivo de configuração *.json*):

```json
    ...,
    "Oidc": {
        "Enabled": true,
        "Authority": "https://login.id.patorum.com",
        "ApiEndpoint": "https://api.id.patorum.com",
        "ApiName": "amplia",
        "ClientAppId": "amplia",
        "AppId": "amplia-backend",
        "AppSecret": "YOUR_BACKEND_APP_SECRET"
    },
    ...
```

## Transição do acesso de root

Se a sua instância do Amplia foi configurada inicialmente para usar o acesso de root, ao configurar o gerenciamento de usuários e tentar acessar a aplicação
com o seu usuário do GrantID, você provavelmente verá uma página informando que você não tem acesso ("no access"). Isso acontece porque todos os privilégios
são concedidos ao primeiro usuário que entra na aplicação, que, no seu caso, *não* foi o usuário com o qual você está entrando agora, e sim o usuário root.

Nesse caso, você precisa conceder privilégios a si mesmo manualmente, pelo banco de dados. Comece localizando o `Id` do seu usuário:

```sql
SELECT "Id", "Name", "EmailAddress"
FROM "Agents"
WHERE "Subject" IS NOT NULL
```

Em seguida, conceda a si mesmo o role de sys admin *Owner* (copie o `Id` do seu usuário para a consulta abaixo):

```sql
UPDATE "Agents"
SET "RootRoleFlags" = 1
WHERE "Id" = 'YOUR-USER-ID'
```

## Veja também

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