Inicio de sesión único con GitHub
Requiere Saldo Túneles HTTP
En esta página 4 secciones
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 #
- Un túnel HTTP y Saldo en tu cuenta. Consulta la descripción general del inicio de sesión único.
- Una cuenta de GitHub. Para registrar la app para una organización, necesitas acceso a la configuración de esa organización.
Pasos #
-
Registra una OAuth app en GitHub #
La guía de GitHub es Creating an OAuth app. En resumen:
- En GitHub, abre el menú situado bajo tu foto de perfil y selecciona Settings, luego Developer settings y después OAuth apps.
- Selecciona New OAuth App. Si todavía no tienes ninguna app, el botón dice Register a new application.
- Rellena el formulario con los valores de abajo y selecciona Register application.
- 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 GitHub Valor Application name Un nombre que tus visitantes reconozcan. GitHub lo muestra cuando les pide autorizar. Homepage URL Una dirección web que describa la app, por ejemplo tu sitio web. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Déjalo desactivado. En GitHub no seleccionas scopes. La solicitud de inicio de sesión los indica:
read:useryuser:email. GitHub pide al visitante que los apruebe la primera vez que inicia sesión. -
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 GitHub. Lo verás en la configuración del túnel.Tipo de proveedor GitHub. 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. Activo Activado ID de cliente El client ID de GitHub. Secreto de cliente El 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:
Campo Valor rellenado Endpoint de autorización https://github.com/login/oauth/authorizeEndpoint de token https://github.com/login/oauth/access_tokenEndpoint de información del usuario https://api.github.com/userRuta de callback /auth/callback/githubSi 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 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.
-
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.