Saltar al contenido
Localtonet Localtonet Panel

Inicio de sesión único con GitLab

Requiere Saldo Túneles HTTP

Ayuda con esta página
En esta página 4 secciones
  1. Antes de empezar
  2. Pasos
  3. Crea una aplicación OAuth en GitLab
  4. Añade el proveedor en Localtonet
  5. Actívalo para un túnel
  6. Pruébalo
  7. Solución de problemas
  8. Páginas relacionadas

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 #

  1. 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:

    PropietarioDónde crearla
    Tu usuarioSelecciona tu avatar, luego Edit profile, luego Access › Applications y Add new application.
    Un grupoAbre 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 GitLabValor
    NameUn nombre que tus visitantes reconozcan. GitLab lo muestra cuando les pide que autoricen.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialDéjalo seleccionado.
    Scopesread_user

    GitLab 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_user da 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.

  2. 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.

    CampoValor
    Nombre del proveedorCualquier nombre, por ejemplo Company GitLab. Lo verás en la configuración del túnel.
    Tipo de proveedorGitLab. 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.
    ActivoActivado
    ID de clienteEl Application ID de GitLab.
    Secreto de clienteEl 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.com por el nombre de host de tu instancia en los tres primeros campos.

    GitLab.com

    CampoValor rellenado
    Endpoint de autorizaciónhttps://gitlab.com/oauth/authorize
    Endpoint de tokenhttps://gitlab.com/oauth/token
    Endpoint de información del usuariohttps://gitlab.com/api/v4/user
    Ruta de callback/auth/callback/gitlab

    Autogestionada

    CampoValor que introducir
    Endpoint de autorizaciónhttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Endpoint de tokenhttps://<YOUR_GITLAB_HOST>/oauth/token
    Endpoint de información del usuariohttps://<YOUR_GITLAB_HOST>/api/v4/user
    Ruta 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.

  3. 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.

  4. 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.

Soporte