Saltar al contenido
Localtonet Localtonet Panel

Inicio de sesión único con GitHub

Requiere Saldo Túneles HTTP

Ayuda con esta página
En esta página 4 secciones
  1. Antes de empezar
  2. Pasos
  3. Registra una OAuth app en GitHub
  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 GitHub antes de poder abrir un túnel HTTP. Registras una OAuth app en GitHub, la añades a Localtonet como proveedor y luego la activas para el túnel.

Antes de empezar #

Pasos #

  1. Registra una OAuth app en GitHub #

    La guía de GitHub es Creating an OAuth app. En resumen:

    1. En GitHub, abre el menú situado bajo tu foto de perfil y selecciona Settings, luego Developer settings y después OAuth apps.
    2. Selecciona New OAuth App. Si todavía no tienes ninguna app, el botón dice Register a new application.
    3. Rellena el formulario con los valores de abajo y selecciona Register application.
    4. En la página de la nueva app, copia el Client ID, luego selecciona Generate a new client secret y copia el secreto de inmediato.
    Campo de GitHubValor
    Application nameUn nombre que tus visitantes reconozcan. GitHub lo muestra cuando les pide autorizar.
    Homepage URLUna dirección web que describa la app, por ejemplo tu sitio web.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowDéjalo desactivado.

    En GitHub no seleccionas scopes. La solicitud de inicio de sesión los indica: read:user y user:email. GitHub pide al visitante que los apruebe la primera vez que inicia sesión.

  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 GitHub. Lo verás en la configuración del túnel.
    Tipo de proveedorGitHub. Cambiar el tipo de un proveedor guardado vacía el ID de cliente, así que vuelve a introducir el ID de cliente y el secreto de cliente.
    ActivoActivado
    ID de clienteEl client ID de GitHub.
    Secreto de clienteEl client secret de GitHub. Nunca se muestra después de guardar.

    En Endpoints y callback se rellenan automáticamente las direcciones estándar de GitHub. Déjalas como están:

    CampoValor rellenado
    Endpoint de autorizaciónhttps://github.com/login/oauth/authorize
    Endpoint de tokenhttps://github.com/login/oauth/access_token
    Endpoint de información del usuariohttps://api.github.com/user
    Ruta de callback/auth/callback/github

    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 GitHub. Selecciona Guardar.

    Cualquiera puede crear una cuenta de GitHub. Sin una regla, cualquier usuario de GitHub 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 descripción general.

  4. Pruébalo #

    Abre la URL del túnel en una ventana privada del navegador. Localtonet muestra Sign in to continue con un botón para tu proveedor. La primera vez, GitHub te pide autorizar la app. Después vuelves al túnel y se carga tu servicio.

Solución de problemas #

GitHub informa de una discrepancia del redirect URI

El error de GitHub es redirect_uri_mismatch: "The redirect_uri MUST match the registered callback URL for this application." Ninguna callback URL de la OAuth app coincide con la dirección que se envió. Establece Authorization callback URL en GitHub exactamente como http://auth.localtonet.com/auth/callback.

Se rechaza a un visitante aunque su dirección está en la lista

El Endpoint de información del usuario predeterminado, https://api.github.com/user, puede no devolver ninguna dirección de correo cuando el usuario de GitHub no ha definido un correo público en su perfil. Pide al visitante que compruebe qué dirección figura como correo público en su perfil de GitHub y compárala con tus listas.

«403 - Access Denied» tras un inicio de sesión correcto en GitHub

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.

El inicio de sesión falla antes o después de la página de autorización de GitHub

Comprueba el ID de cliente y el Secreto de cliente guardados en Localtonet con los de la OAuth app. Vuelve a pegar el client ID, genera un nuevo client secret en GitHub, pégalo en el proveedor y selecciona Guardar proveedor.

No hay un botón de GitHub 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