🔐 Usando ggLeap como proveedor de OpenID Connect (OIDC)

🔐 Usando ggLeap como proveedor OpenID Connect (OIDC)

ggLeap permite OpenID Connect (OIDC) para que aplicaciones de terceros autentiquen usuarios usando sus cuentas de ggLeap. Esto habilita integraciones como "Iniciar sesión con ggLeap" para aplicaciones de socios, sitios web o servicios.

OIDC se construye sobre OAuth 2.0 y permite que las aplicaciones verifiquen de manera segura la identidad del usuario y obtengan información básica del perfil.

🧠 Descripción general

Al integrar con el proveedor OIDC de ggLeap, las aplicaciones pueden:

• Permitir que los usuarios inicien sesión usando su cuenta de ggLeap
• Habilitar Inicio de sesión único (SSO) en aplicaciones compatibles
• Recuperar información del usuario como correo electrónico, perfil y pertenencia a grupos
• Soportar autenticación específica del centro cuando sea necesario

Las aplicaciones autentican usuarios a través de ggLeap y reciben una respuesta de token que confirma la identidad y los permisos solicitados.

🌐 Puntos finales del emisor OIDC

Las aplicaciones deben usar la URL del emisor apropiada según el entorno.

Los metadatos de descubrimiento OIDC y las claves de firma pública están disponibles automáticamente en el punto final del emisor. La mayoría de las bibliotecas OIDC recuperarán esta configuración automáticamente.

🔑 Información de integración requerida

Para integrar con ggLeap OIDC, el desarrollador de la aplicación recibirá las siguientes credenciales:

Estos valores deben configurarse en la configuración del cliente OIDC de la aplicación.

🔐 Solicitud de autorización

Las aplicaciones inician el inicio de sesión enviando usuarios al punto final de autorización de ggLeap.

Punto final

{issuer}/connect/authorize

Ejemplo de solicitud de autorización

{issuer}/connect/authorize
?client_id={client_id}
&redirect_uri={encoded_redirect_uri}
&response_type=code
&scope=openid%20email%20profile
&state=abc
&nonce=xyz
[&center_uuid={guid}]

Parámetros

🧾 Alcances disponibles

Las aplicaciones pueden solicitar los siguientes alcances durante la autenticación.

🏢 Autenticación específica del centro

Algunas integraciones están vinculadas a un centro de ggLeap específico, mientras que otras admiten múltiples centros.

Integraciones de centros

Las aplicaciones que admiten un único centro deben incluir:

center_uuid={guid}

en la solicitud de autorización.

🔁 Intercambio de tokens

Después de que el usuario inicia sesión correctamente, ggLeap redirige al usuario a la aplicación con un código de autorización.

La aplicación luego intercambia este código por tokens usando el punto final de tokens.

Punto final

{issuer}/connect/token

Se debe usar el Flujo de código de autorización OAuth estándar para este paso.

🚪 Cerrar sesión (finalizar sesión)

Las aplicaciones pueden cerrar la sesión de usuarios de sesiones de ggLeap usando el punto final de cierre de sesión.

Punto final

{issuer}/connect/logout

Parámetros

Si se proporciona y se permite una URI de redireccionamiento válida, el usuario será redirigido después de cerrar sesión.

⚠️ Problemas de integración comunes

🧪 Prueba de integración básica

Para verificar que la integración funciona:

1. Construye una solicitud de autorización usando tu ID de cliente e URI de redireccionamiento.
2. Abre la URL en un navegador.
3. Inicia sesión con una cuenta de ggLeap.
4. Confirma que la aplicación reciba un código de autorización en la URL de redireccionamiento.
5. Intercambia el código usando el punto final de tokens.

Si es exitoso, la aplicación recibirá tokens de acceso e identidad confirmando el inicio de sesión del usuario.

Actualizado el: 10/04/2026