Skip to content

Autenticação On-Prem com OpenID Connect (OAuth 2.0)

Este documento fornece instruções de configuração sobre como configurar provedores de autenticação personalizados para a instância on-premise do App Builder usando um servidor OpenID Connect que suporta o fluxo de autorização OAuth 2.0 CODE com PKCE.

O guia inclui:

  • Configurações obrigatórias do cliente OIDC.
  • Configurações específicas do App Builder.
  • Opções adicionais como oidc_scope e oidc_redirect_uri.

Configurações para o Cliente OIDC

  • Fluxo OAuth2: Authorization Code + PKCE
  • Tokens de atualização ativados (escopo offline_access),
  • Tempo de vida do token de acesso: (sugerido 600 segundos)
  • Tempo de vida do token de atualização: janela deslizante recomendada com mínimo de 1 hora (24 horas recomendadas) e tempo de vida máximo determinado pela organização ou ilimitado).
  • Incluir declarações do usuário no Token Id (existem duas declarações padrão obrigatórias: “sub” e “email” e duas declarações personalizadas opcionais “given_name” e “family_name”)
  • Escopos obrigatórios: openid email profile offline_access appbuilder.user
  • Audience: “appbuilder” (padrão)
  • URI de redirecionamento de entrada: <app builder host>/oidc/ig/callback
  • URL de pós-logout: <app builder host>/oidc/ig/callback-postlogout

Configurações para o App Builder

Configurações obrigatórias

  • AuthSettings__SkipAuth: false
  • AuthSettings__Authority: URL do servidor OpenId
  • AuthSettings__ClientId: Id do cliente OpenId
  • AuthSettings__AccountIssuer: Alias único do servidor

Outras opções

  • oidc_scope: ‘openid email offline_access profile appbuilder.user’ (padrão)
  • oidc_redirect_uri: ‘/oidc/ig/callback’, (padrão)
  • oidc_post_logout_redirect_uri: /oidc/ig/callback-postlogout’ (padrão)
  • AuthSettings:Audience: “appbuilder” (padrão)
Note

Para usar a autenticação OIDC você precisa definir a configuração FrontendOptions_SkipAuth como false.

Depois de configurar seu cliente OIDC você precisará passar 3 propriedades obrigatórias para o contêiner Docker do App Builder como variáveis de ambiente:

por exemplo

docker run --restart always -p 80:5000 -e ConnectionStrings__Provider=SqlServer -e "ConnectionStrings:...." -e AuthSettings__SkipAuth=false -e AuthSettings__Authority="https://my-auth-server.example.com" -e AuthSettings__ClientId="1234-4657-00" -e AuthSettings__AccountIssuer="MyAuth" -v "C:\ProgramData\Infragistics\Appbuilder\logs:/appbuilder/logs" -v "C:\ProgramData\Infragistics\Appbuilder\storage:/appbuilder/storage" --name appbuilder appbuilder:1.0

Recursos Adicionais