Pular para o conteúdo principal

Configuração de OpenID Connect - Rest PKI Core

Para fazer o gerenciamento de usuários, o Rest PKI Core requer um servidor OpenID Connect (OIDC), mais especificamente uma assinatura do GrantID.

Você pode usar uma assinatura SaaS em grantid.com ou executar sua própria instância do GrantID.

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

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

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​

Ver em Markdown