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.
Iniciar sesión con 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.
Crear y configurar la 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 los 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, agrega 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 agregar, 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 separada por espacios de alcances. Si no se proporciona, el alcance por defecto será 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 (configurado en la sección Crear y configurar la app OAuth).
Tipos de configuración
| Name | Type |
|---|---|
| clientId | string |
| clientSecret | string |
| scope | string |
Probar el conector de GitLab
Eso es todo. El conector de GitLab debería estar disponible ahora. No olvides habilitar el conector en el registro e inicio de sesión.
Referencias
GitLab - Documentación de la APIGitLab - Aplicaciones OAuth