Configurar VergeOS como proveedor de identidad con OIDC

Guía para configurar VergeOS como proveedor de identidad OpenID Connect (OIDC) para la autenticación centralizada en varios sistemas e inquilinos.

Resumen

Puntos clave

• Crear una aplicación OIDC para establecer VergeOS como proveedor de identidad
• Habilitar inicio de sesión único para otros sistemas y tenants de VergeOS
• Configurar la autenticación centralizada con proveedores de terceros
• Admitir múltiples sistemas cliente con una sola configuración OIDC

Esta guía le muestra el proceso de configurar VergeOS como proveedor de identidad mediante OpenID Connect (OIDC), lo que permite la autenticación centralizada para múltiples sistemas y tenants de VergeOS.

Requisitos previos

• Acceso administrativo al sistema VergeOS
• Certificado SSL válido instalado en el sistema VergeOS
• Conocimientos básicos de los conceptos de OIDC
• URLs de los sistemas cliente que usarán esta autenticación

Pasos para crear una aplicación OIDC

1. Acceder a la configuración de OIDC

   • Vaya a Sistema > Aplicaciones OIDC desde el menú superior
   • Haga clic en Nuevo
2. Configurar ajustes básicos

   • Introduzca una Nombre para la aplicación
   • Consulte la Habilitado cuadro
   • Agregar una opción opcional Descripción
3. Configurar URI de redirección

   • Ingrese la(s) URL(s) de devolución de llamada a las que se redirigirá a los usuarios después de la autenticación
   • Formato: https://your-system-name.example.com
   • Se pueden agregar varias URI para diferentes sistemas cliente

Uso de comodines

Puede usar comodines en las URI de redirección:

• Para varios sistemas: https://examplecorp-site*.example.com
• Para varios subdominios: https://vergesystem.*.example.com

1. Configurar opciones de autenticación

   • Forzar fuente de autorización: Seleccione opcionalmente un proveedor de terceros
   • Asignar usuario: Elija si todos los usuarios verificados deben asignarse a una cuenta específica
   • Establezca Configuración de ámbitos (Perfil, correo electrónico, grupos)
   • Configure las restricciones de acceso si es necesario
2. Guardar la configuración

   • Haga clic en Enviar para crear la aplicación OIDC
   • El sistema generará un ID de cliente y un secreto

Recuperar credenciales del cliente

1. Acceder al panel de la aplicación

   • Vaya a Sistema > Aplicaciones OIDC
   • Haga doble clic en su aplicación OIDC
2. Copiar la información requerida

   • ID de cliente: Copie usando el valor mostrado o el icono de copiar
   • Secreto de cliente: Use el icono de copiar (el valor está oculto)
   • URL de configuración conocida: Copie la URL mostrada

Mejores prácticas

• Cree aplicaciones OIDC separadas para distintos grupos de clientes
• Revise y actualice periódicamente las restricciones de acceso
• Utilice URI de redirección específicas en lugar de comodines cuando sea posible
• Documente qué sistemas están usando cada aplicación OIDC

Resolución de problemas

Problemas comunes

• La autenticación falla

  • Verifique que el certificado SSL sea válido y no haya expirado
  • Compruebe que la URI de redirección coincida exactamente
  • Asegúrese de que el ID de cliente y el secreto se hayan copiado correctamente
• Acceso al ámbito denegado

  • Verifique que los ámbitos requeridos estén habilitados
  • Compruebe los permisos del usuario en la configuración de restricciones
• Problemas de redirección

  • Confirme que el formato de la URL coincida con la URI de redirección
  • Verifique los patrones de comodines, si se usan
  • Compruebe si hay problemas con el certificado SSL

Recursos adicionales

• Configuración de VergeOS como cliente OIDC
• Fuentes de autorización de terceros
• Gestión de certificados SSL

Comentarios

¿Necesitas ayuda?

Si encuentra algún problema al configurar 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-08-29
• Versión de VergeOS: 4.12 y posteriores