Saltar al contenido
Localtonet Localtonet Panel

Inicio de sesión único para túneles HTTP

Requiere saldo Túneles HTTP

Ayuda con esta página
En esta página 10 secciones
  1. Cuándo usarlo
  2. Cómo funciona
  3. Antes de empezar
  4. Proveedores
  5. Configúralo
  6. Añadir un proveedor
  7. Actívalo para un túnel
  8. Pruébalo
  9. La URI de redirección
  10. Reglas de acceso
  11. Rutas de inicio de sesión y ruta de cierre de sesión
  12. Solución de problemas
  13. Automatización

El inicio de sesión único (SSO) coloca una página de inicio de sesión delante de un túnel HTTP. Los visitantes inician sesión con un proveedor de identidad que tú eliges, como Google, GitHub, Microsoft o GitLab, o con un usuario y una contraseña que defines tú, antes de que ninguna solicitud llegue a tu servicio.

Cuándo usarlo #

Mientras no lo protejas, un túnel HTTP está abierto a cualquiera que conozca su dirección. El SSO es la protección adecuada cuando las personas abren el túnel en un navegador y quieres decidir quiénes son: un panel de administración, un dashboard, una herramienta interna, un sitio de pruebas. Tu servicio no cambia y nunca ve una contraseña.

El SSO está pensado para navegadores. Una solicitud que no lleva la cookie de inicio de sesión se redirige a la página de inicio de sesión, así que los scripts, los webhooks y los clientes de API no pueden pasar. Para ellos, protege solo algunas rutas (consulta Rutas de inicio de sesión) o usa las opciones de Control de acceso.

Cómo funciona #

Un visitante abre la URL del túnel. El servidor de Localtonet lo redirige a la página de inicio de sesión de auth.localtonet.com, donde inicia sesión con un proveedor de identidad. Después se le devuelve a la URL del túnel y la solicitud se reenvía a tu servicio. Visitante Navegador 1. Abre URL del túnel Servidor de Localtonet 2. Redirección Página de inicio de sesión auth.localtonet.com 3. Inicio de sesión Proveedor Google, GitHub… 4. Sesión iniciada, de vuelta al túnel 5. Solicitud Tu servicio En tu dispositivo
El inicio de sesión se hace en la página de inicio de sesión de Localtonet, no en tu servicio.
  1. Un visitante abre la URL del túnel. Una solicitud por HTTP se redirige primero a HTTPS.
  2. El visitante aún no ha iniciado sesión, así que el servidor de Localtonet redirige el navegador a la página de inicio de sesión de auth.localtonet.com. La página tiene el encabezado Sign in to continue y ofrece los proveedores que activaste para este túnel.
  3. El visitante elige un proveedor e inicia sesión allí. Con un proveedor de usuario y contraseña, el formulario está en la propia página de inicio de sesión.
  4. Localtonet comprueba tus reglas de acceso y devuelve al visitante a la dirección que pidió. El inicio de sesión se guarda en una cookie para el nombre de host del túnel. Es una cookie de sesión del navegador y solo se envía por HTTPS.
  5. A partir de ahí, las solicitudes se reenvían a tu servicio como de costumbre. Cuando el inicio de sesión deja de ser válido, el visitante vuelve a la página de inicio de sesión.

Un visitante que inicia sesión pero no está permitido por tus reglas ve 403 - Access Denied con el texto "You do not have permission to access this tunnel."

Las rutas bajo /.well-known nunca se ponen detrás del inicio de sesión.

Antes de empezar #

  • Un túnel HTTP. Consulta HTTP / HTTPS.
  • Saldo en tu cuenta. Sin él, guardar un proveedor o activar el inicio de sesión falla con "Necesitas comprar saldo para usar esta función." Consulta Planes y saldo y Precios.
  • Para un proveedor externo: una cuenta allí que te permita registrar una aplicación OAuth.

El SSO se configura en tu panel personal. El botón SSO y el ajuste Proveedores de SSO no aparecen en los túneles de equipo.

Proveedores #

Estas guías cubren las opciones más habituales paso a paso:

La lista Tipo de proveedor del panel contiene: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon y Yahoo. Para todos los tipos excepto Username-Password y Custom, los endpoints se rellenan por ti. Para OpenID Connect, las direcciones rellenadas son ejemplos que debes sustituir por los endpoints de tu proveedor.

Configúralo #

Hay dos partes. Añades un proveedor una sola vez y queda disponible para todos tus túneles HTTP. Después lo activas en cada túnel que quieras proteger. Un proveedor guardado no protege nada hasta que un túnel lo usa.

  1. Añadir un proveedor #

    Abre Mis túneles › HTTP y selecciona SSO en la parte superior de la página (su tooltip dice Configuración de proveedores de SSO). Se abre el cuadro de diálogo Proveedores de SSO. Selecciona Añadir proveedor, rellena el formulario y selecciona Guardar proveedor. Cada proveedor se guarda por separado.

    CampoQué esNotas
    Nombre del proveedorUn nombre para identificar este proveedor en los ajustes de tu túnel.Obligatorio. Por ejemplo, Company Google.
    Tipo de proveedorEl método de inicio de sesión.Un proveedor nuevo empieza como Google. Cambiar el tipo de un proveedor guardado vacía ID de cliente, así que vuelve a introducir el ID de cliente y el secreto de cliente.
    ActivoHace que el proveedor esté disponible para los túneles.Si cambias un proveedor a inactivo y guardas, también se desactiva en todos los túneles que lo usaban.
    ID de clienteEl ID de la aplicación que registraste en el proveedor.Obligatorio para todos los tipos excepto Username-Password y Custom.
    Secreto de clienteEl secreto de esa aplicación.No se muestra nunca después de guardar. Déjalo en blanco más adelante para conservar el secreto guardado.
    Endpoints y callbackEndpoint de autorización, Endpoint de token, Endpoint de información del usuario y Ruta de callback.Se rellenan automáticamente para los proveedores estándar. Cámbialos solo cuando una guía te lo indique.
    Reglas de acceso por correoDominios de correo permitidos, Dominios de correo bloqueados y Direcciones de correo bloqueadas.Opcional. Consulta Reglas de acceso.
    Usuarios de inicio de sesiónNombres de usuario y contraseñas.Solo para los tipos Username-Password y Custom.

    Para quitar un proveedor, selecciona Eliminar proveedor. Se elimina de tu cuenta y de los ajustes de SSO de tus túneles.

  2. Actívalo para un túnel #

    En Tus túneles, selecciona Configuración en el túnel. En el panel Configuración del túnel, busca Proveedores de SSO y selecciona Gestionar. Se abre el cuadro de diálogo Inicio de sesión único.

    AjusteQué hace
    Exigir inicio de sesiónActiva el SSO para este túnel. A los visitantes que no han iniciado sesión se les envía primero a la página de inicio de sesión.
    ProveedoresUn interruptor por cada uno de tus proveedores activos. Activa al menos uno. Si hay varios activados, el visitante elige en la página de inicio de sesión.
    Quién puede iniciar sesiónListas opcionales de Direcciones de correo, Dominios de correo y Usuarios para este túnel.
    Rutas de inicio y cierre de sesiónRutas de inicio de sesión opcionales y una Ruta de cierre de sesión.

    Selecciona Guardar.

  3. Pruébalo #

    Abre la URL del túnel en una ventana privada del navegador. Deberías llegar a la página Sign in to continue y, tras iniciar sesión, a tu servicio.

La URI de redirección #

Un proveedor externo pregunta adónde puede enviar a las personas después de que inicien sesión. Para cada túnel es una dirección del host de inicio de sesión de Localtonet, no la dirección de tu túnel. Registra exactamente este valor:

URI de redirección
http://auth.localtonet.com/auth/callback

Cada guía de proveedor te indica dónde introducirla.

ValorDónde se pone
La URI de redirección de arribaEn el proveedor: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab).
Ruta de callback, por ejemplo /auth/callback/googleEn Localtonet, bajo Endpoints y callback. Se rellena por ti. Déjala como está.

El proveedor compara la URI de redirección con el valor registrado de forma exacta, así que cópiala tal como se muestra aquí.

Reglas de acceso #

Iniciar sesión demuestra quién es un visitante. Las reglas deciden si esa persona puede abrir el túnel. Hay dos niveles y se aplican ambos.

DóndeListaQué dice el panel
ProveedorDominios de correo permitidosDéjalo en blanco para no restringir por dominio. Los comodines dependen del proveedor.
ProveedorDominios de correo bloqueadosBloquea los inicios de sesión de estos dominios de correo.
ProveedorDirecciones de correo bloqueadasBloquea estas direcciones de correo concretas.
TúnelDirecciones de correo, Dominios de correo, UsuariosDeja una lista vacía para omitir esa comprobación. Las listas se aplican a todos los proveedores activados en el túnel.

Introduce un elemento por línea, o sepáralos con comas. Un dominio se introduce sin @, por ejemplo example.com.

Después de cambiar una regla, un visitante que ya tenía acceso puede conservarlo hasta cinco minutos. A un visitante que fue rechazado se le vuelve a comprobar pasado un minuto.

Rutas de inicio de sesión y ruta de cierre de sesión #

AjusteComportamientoEjemplo
Rutas de inicio de sesiónVacía: todas las rutas del túnel exigen inicio de sesión. Con entradas: solo las solicitudes cuya ruta empieza por alguna de las entradas exigen inicio de sesión./admin cubre /admin y /admin/users, no /administrator.
Ruta de cierre de sesiónAl abrirla se elimina el inicio de sesión de este túnel y se envía al visitante a la página de inicio del túnel, o a la dirección indicada en un valor de consulta returnUrl./sso/logout

Las rutas empiezan con una barra. Las mayúsculas y minúsculas no importan.

Una lista de Rutas de inicio de sesión con entradas deja abierto todo lo demás. Con /admin en la lista, solo /admin está protegido y el resto de rutas son accesibles sin iniciar sesión. Deja la lista vacía para proteger todo el túnel.

La ruta de cierre de sesión cierra la sesión del visitante solo en el túnel. No lo desconecta de Google, GitHub ni de otro proveedor de identidad.

Solución de problemas #

"Necesitas comprar saldo para usar esta función."

El SSO requiere saldo. Añade saldo y vuelve a guardar. Sin saldo todavía puedes abrir el cuadro de diálogo y desactivar Exigir inicio de sesión.

"Añade un proveedor antes de activar el inicio de sesión."

Todavía no tienes ningún proveedor activo. Selecciona Añadir un proveedor en el cuadro de diálogo, o usa el botón SSO de la parte superior de la página HTTP.

"Activa al menos un proveedor o desactiva el inicio de sesión."

Exigir inicio de sesión está activado, pero ningún interruptor de proveedor lo está. Un proveedor que pones como inactivo se desactiva en sus túneles y deja de aparecer en la lista.

La página de inicio de sesión dice "No authentication providers are currently configured for this tunnel."

Se exige inicio de sesión, pero no hay ningún proveedor activado para este túnel. Abre Proveedores de SSO › Gestionar en el túnel y activa uno.

El túnel se abre sin pedir inicio de sesión

Comprueba que Exigir inicio de sesión está activado y guardado. Si Rutas de inicio de sesión tiene entradas, solo esas rutas están protegidas. Prueba también en una ventana privada: tu propio navegador puede seguir con la sesión iniciada.

"403 - Access Denied" después de iniciar sesión

El inicio de sesión funcionó, pero una regla rechazó la cuenta. Revisa las Reglas de acceso por correo del proveedor y las listas Quién puede iniciar sesión del túnel. Tras corregir una regla, espera un minuto y recarga.

Un webhook o un cliente de API recibe una redirección en lugar de una respuesta

Las solicitudes sin la cookie de inicio de sesión se redirigen a la página de inicio de sesión. Pon en Rutas de inicio de sesión solo las páginas pensadas para personas, o usa un túnel aparte para el tráfico de máquinas.

Automatización #

Los proveedores y los ajustes de SSO de los túneles también se pueden gestionar mediante la API, en /api/v2/sso-providers, y mediante el servidor MCP.

Soporte