Inicio de sesión único con GitLab
Requiere Saldo Túneles HTTP
En esta página 4 secciones
Permite que los visitantes inicien sesión con su cuenta de GitLab antes de poder abrir un túnel HTTP. Funciona con GitLab.com y con una instancia de GitLab autogestionada. Creas una aplicación OAuth en GitLab, la añades a Localtonet como proveedor y luego la activas para el túnel.
Antes de empezar #
- Un túnel HTTP y Saldo en tu cuenta. Consulta la visión general del inicio de sesión único.
- Una cuenta de GitLab en GitLab.com o en tu propia instancia.
- Para una instancia autogestionada: su dirección debe ser accesible desde internet. Los navegadores de tus visitantes abren su página de inicio de sesión, y el host de inicio de sesión de Localtonet llama directamente a sus endpoints de token y de usuario.
Pasos #
-
Crea una aplicación OAuth en GitLab #
La guía del propio GitLab es Configure GitLab as an OAuth 2.0 authentication identity provider. Una aplicación puede pertenecer a un usuario, a un grupo o a toda la instancia:
Propietario Dónde crearla Tu usuario Selecciona tu avatar, luego Edit profile, luego Access › Applications y Add new application. Un grupo Abre el grupo y luego Settings › Applications. La instancia (autogestionada, solo administradores) Admin › Applications y New application. Rellena el formulario y selecciona Save application:
Campo de GitLab Valor Name Un nombre que tus visitantes reconozcan. GitLab lo muestra cuando les pide que autoricen. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Déjalo seleccionado. Scopes read_userGitLab muestra entonces el Application ID y el Secret. Copia ambos enseguida: GitLab muestra el secreto solo justo después de crear la aplicación.
El ámbito
read_userda acceso de lectura al perfil del usuario que ha iniciado sesión mediante el endpoint/api/v4/user, que es el Endpoint de información del usuario que rellena Localtonet. Es el único ámbito que solicita el inicio de sesión, así que la aplicación no necesita ningún otro. -
Añade el proveedor en Localtonet #
Abre Mis túneles › HTTP y selecciona SSO en la parte superior de la página. En el cuadro Proveedores de SSO, selecciona Añadir proveedor.
Campo Valor Nombre del proveedor Cualquier nombre, por ejemplo Company GitLab. Lo verás en la configuración del túnel.Tipo de proveedor GitLab. Cambiar el tipo de un proveedor guardado vacía ID de cliente, así que introduce de nuevo el ID de cliente y el secreto de cliente. Activo Activado ID de cliente El Application ID de GitLab. Secreto de cliente El Secret de GitLab. Nunca se muestra después de guardarlo. Abre Endpoints y callback. Las direcciones de GitLab.com se rellenan automáticamente. Para una instancia autogestionada, sustituye
gitlab.compor el nombre de host de tu instancia en los tres primeros campos.GitLab.com
Campo Valor rellenado Endpoint de autorización https://gitlab.com/oauth/authorizeEndpoint de token https://gitlab.com/oauth/tokenEndpoint de información del usuario https://gitlab.com/api/v4/userRuta de callback /auth/callback/gitlabAutogestionada
Campo Valor que introducir Endpoint de autorización https://<YOUR_GITLAB_HOST>/oauth/authorizeEndpoint de token https://<YOUR_GITLAB_HOST>/oauth/tokenEndpoint de información del usuario https://<YOUR_GITLAB_HOST>/api/v4/userRuta de callback /auth/callback/gitlab(sin cambios)El Redirect URI de la aplicación de GitLab sigue siendo la dirección de Localtonet del paso 1. No contiene tu host de GitLab.
Si quieres, rellena Reglas de acceso por correo y luego selecciona Guardar proveedor.
-
Actívalo para un túnel #
En Tus túneles, selecciona Configuración en el túnel y luego Gestionar junto a Proveedores de SSO. En el cuadro Inicio de sesión único, activa Exigir inicio de sesión y el interruptor de tu proveedor de GitLab. Selecciona Guardar.
En GitLab.com cualquiera puede crear una cuenta. Sin una regla, cualquier usuario de GitLab.com que conozca la dirección puede abrir el túnel. Rellena Quién puede iniciar sesión en el túnel, o Dominios de correo permitidos en el proveedor. Las listas se explican en la visión general.
-
Pruébalo #
Abre la URL del túnel en una ventana de navegación privada. Localtonet muestra Sign in to continue con un botón para tu proveedor. GitLab te pide que autorices la aplicación la primera vez. Después se te devuelve al túnel y se carga tu servicio.
Solución de problemas #
GitLab dice que el redirect URI incluido no es válido
Ningún Redirect URI de la aplicación de GitLab coincide con la dirección que se envió. Introduce exactamente http://auth.localtonet.com/auth/callback como Redirect URI de la aplicación.
GitLab dice que el ámbito solicitado no es válido, es desconocido o tiene un formato incorrecto
Un ámbito que se solicitó no está seleccionado en la aplicación de GitLab. Edita la aplicación y selecciona read_user.
GitLab dice que falló la autenticación del cliente
El ID de cliente o el Secreto de cliente guardados en Localtonet no coinciden con la aplicación de GitLab. Pega de nuevo el Application ID y el Secret y selecciona Guardar proveedor. Si renuevas el secreto en GitLab, la aplicación deja de funcionar hasta que guardes el nuevo secreto en Localtonet.
El inicio de sesión con una instancia autogestionada nunca se completa
Comprueba que los tres endpoints no tengan errores de escritura y asegúrate de que la instancia responde desde internet. Si usa HTTPS, necesita un certificado en el que confíen los clientes públicos. No se puede usar una instancia accesible solo dentro de tu red.
"403 - Access Denied" tras un inicio de sesión correcto en GitLab
Una regla de Localtonet rechazó la cuenta. Revisa Reglas de acceso por correo en el proveedor y Quién puede iniciar sesión en el túnel. Después de corregir una regla, espera un minuto y recarga.
No hay botón de GitLab en la página de inicio de sesión
El proveedor no está activado para este túnel, o está marcado como inactivo. Comprueba ambas cosas.