Configura el inicio de sesión social con GitLab (Set up social login with GitLab)
El conector oficial de Logto para el inicio de sesión social con GitLab. Utiliza GitLab como proveedor de identidad de autenticación OAuth 2.0.
Esta guía asume que tienes un entendimiento básico de los Conectores de Logto. Para aquellos que no están familiarizados, por favor consulta la guía de Conectores para comenzar.
Comenzar
El conector de GitLab permite a los usuarios finales iniciar sesión en tu aplicación usando sus propias cuentas de GitLab a través del protocolo de autenticación OAuth 2.0 de GitLab.
Inicia sesión con una cuenta de GitLab
Ve al sitio web de GitLab e inicia sesión con tu cuenta de GitLab. Puedes registrar una nueva cuenta si no tienes una.
Crea y configura una app OAuth
Sigue la guía de creación de una app OAuth de GitLab y registra una nueva aplicación.
Ponle nombre a tu nueva aplicación OAuth en Name y completa el Redirect URI de la app. Personaliza los Redirect URIs como ${your_logto_origin}/callback/${connector_id}. El connector_id se puede encontrar en la barra superior de la página de detalles del conector en la Consola de Administración de Logto.
En alcances (scopes), selecciona openid. También puedes habilitar profile y email. El alcance profile es necesario para obtener la información del perfil del usuario, y el alcance email es necesario para obtener la dirección de correo electrónico del usuario. Asegúrate de haber permitido estos alcances en tu app OAuth de GitLab si deseas usarlos. Estos alcances también se utilizarán al configurar tu conector más adelante.
- Si usas dominios personalizados, añade tanto el dominio personalizado como el dominio predeterminado de Logto a los Redirect URIs para asegurar que el flujo OAuth funcione correctamente con ambos dominios.
- Si encuentras el mensaje de error "The redirect_uri MUST match the registered callback URL for this application." al iniciar sesión, intenta alinear el Redirect URI de tu app OAuth de GitLab y la URL de redirección de tu app Logto (incluyendo el protocolo) para resolver el problema.
Gestión de apps OAuth
Ve a la página de Aplicaciones en GitLab, donde puedes añadir, editar o eliminar apps OAuth existentes. También puedes encontrar el Application ID y generar el Secret en las páginas de detalles de la app OAuth.
Configura tu conector
Completa el campo clientId y clientSecret con el Application ID y el Secret que obtuviste de las páginas de detalles de la app OAuth mencionadas en la sección anterior.
scope es una lista de alcances (scopes) separados por espacios. Si no se proporciona, el alcance por defecto es openid. Para el conector de GitLab, los alcances que puedes querer usar son openid, profile y email. El alcance profile es necesario para obtener la información del perfil del usuario, y el alcance email es necesario para obtener la dirección de correo electrónico del usuario. Asegúrate de haber permitido estos alcances en tu app OAuth de GitLab (configurados en la sección Crea y configura una app OAuth).
Tipos de configuración
| Nombre | Tipo |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
Prueba el conector de GitLab
Eso es todo. El conector de GitLab debería estar disponible ahora. No olvides habilitar el conector en la experiencia de inicio de sesión.
Referencias
GitLab - Documentación de la APIGitLab - Aplicaciones OAuth