Configurar VergeOS como cliente OIDC

Guía paso a paso para configurar un sistema o inquilino VergeOS para usar autenticación OIDC con otro proveedor de identidad VergeOS.

Resumen

Puntos clave

• Configurar VergeOS para usar autenticación OIDC
• Conectarse a un proveedor de identidad OIDC de VergeOS
• Habilitar la creación y sincronización automáticas de usuarios
• Personalizar la apariencia y el comportamiento del inicio de sesión

Esta guía explica cómo configurar un sistema o inquilino de VergeOS para autenticarse usando otro sistema de VergeOS como proveedor de identidad OIDC.

Requisitos previos

• Acceso al sistema proveedor OIDC de VergeOS
• URL de configuración conocida del proveedor
• ID de cliente y secreto de cliente del proveedor
• Acceso administrativo al sistema cliente de VergeOS
• URL completa del sistema cliente de VergeOS

Pasos

1. Acceda a la configuración de autorización

• Haga clic en Sistema en el menú superior
• Seleccione Fuentes de autenticación
• Haga clic en Nuevo

2. Configure la configuración básica

• Nombre: Ingrese un identificador para esta fuente de autenticación (aparece en el botón de inicio de sesión)
• Controlador: Seleccione OpenID (configuración conocida)
• URL base: Ingrese la URL de configuración conocida
• URI de redirección: Ingrese la URL completa de este sistema VergeOS
• ID de cliente: Pegue el ID de cliente del proveedor
• Secreto de cliente: Pegue el secreto de cliente del proveedor

3. Configure los parámetros de autenticación

Los valores predeterminados suelen funcionar mejor para estas configuraciones:

• Parámetro de sugerencia de token: Dejar como post_logout_redirect_uri
• Parámetro de redirección: Dejar como post_logout_redirect_uri
• Alcance: Dejar como openid profile email groups
• Alcance de grupo: Dejar como groups

4. Habilite las opciones recomendadas

Marque estas casillas para un funcionamiento óptimo:

• Decodificar token de ID
• Actualizar usuario remoto
• Actualizar la dirección de correo electrónico del usuario
• Actualizar el nombre para mostrar del usuario
• Actualizar la pertenencia a grupos

5. Configure la creación de usuarios

Elija su método preferido de creación de usuarios:

• Crear usuarios automáticamente: Ingrese .* para crear todos los usuarios automáticamente
• Crear usuarios automáticamente en el grupo: Especifique grupos para la creación automática restringida

6. Personalice la apariencia del inicio de sesión

Opcionalmente, configure:

• Color de fondo del botón
• Color del texto del botón
• Icono personalizado de Font Awesome
• Color del icono (usando códigos HEX)

7. Guarde la configuración

• Haga clic en Enviar para crear la fuente de autorización

Mejores prácticas

• Pruebe la autenticación con un usuario de prueba antes de implementarla ampliamente
• Mantenga desactivado el modo de depuración a menos que esté solucionando problemas
• Documente sus opciones de configuración para futuras referencias
• Verifique regularmente que la sincronización de usuarios funcione según lo esperado

Resolución de problemas

Problemas comunes

• La autenticación falla

  • Verifique que el ID de cliente y el secreto sean correctos
  • Compruebe la URL de configuración conocida
  • Asegúrese de que la URI de redirección coincida exactamente
• Problemas de sincronización de usuarios

  • Verifique que el alcance de grupo esté habilitado
  • Compruebe la configuración de pertenencia a grupos
  • Habilite temporalmente el modo de depuración
• Falta el botón de inicio de sesión

  • Verifique que la fuente de autorización esté habilitada
  • Compruebe la configuración de estilo de inicio de sesión
  • Borre la caché del navegador

Recursos adicionales

• Referencia de iconos de Font Awesome
• Configuración de VergeOS como proveedor OIDC

Comentarios

¿Necesitas ayuda?

Si encuentra algún problema al configurar los ajustes del cliente OIDC o tiene preguntas sobre este proceso, no dude en ponerse en contacto con nuestro equipo de soporte.

---

Información del documento

• Última actualización: 2024-01-22
• Versión de VergeOS: 4.12 y posteriores