Skip to content

Autenticación On-Prem con OpenID Connect (OAuth 2.0)

Este documento tiene como objetivo proporcionar instrucciones de configuración sobre cómo configurar proveedores de autenticación personalizados para la instancia on-premises de App Builder utilizando el servidor OpenID Connect que admite el flujo de autorización OAuth 2.0 CODE con PKCE.

La guía incluye:

  • Configuración de cliente OIDC requerida.
  • Opciones de configuración específicas para App Builder.
  • Opciones adicionales como oidc_scope y oidc_redirect_uri.

Configuración del cliente OIDC

  • Flujo de OAuth2: Código de autorización + PKCE
  • Tokens de actualización habilitados (ámbito offline_access),
  • Duración del token de acceso: (se sugieren 600 segundos)
  • Duración del token de actualización: ventana deslizante recomendada con un mínimo de 1 hora (se recomiendan 24 horas) y duración máxima determinada por la organización o sin límite).
  • Incluir notificaciones del usuario en el token de identificación (hay dos notificaciones estándar requeridas: “sub” y “email” y dos notificaciones personalizadas opcionales “given_name” y “family_name”)
  • Ámbitos requeridos: openid email profile offline_access appbuilder.user
  • Audiencia: “appbuilder” (predeterminado)
  • URI de redirección de inicio de sesión: <app builder host>/oidc/ig/callback
  • URL de cierre de sesión: <app builder host>/oidc/ig/callback-postlogout

Configuración para App Builder

Opciones de configuración requeridas

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

Otras opciones

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

Para usar la autenticación OIDC, debe establecer la configuración FrontendOptions_SkipAuth en false.

Después de configurar el cliente OIDC, deberá pasar 3 propiedades requeridas al contenedor de Docker de App Builder como variables de entorno:

p. ej.

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 adicionales