Inicio de sesión único con Microsoft
Requiere Saldo Túneles HTTP
En esta página 6 secciones
Permite que los visitantes inicien sesión con una cuenta profesional o educativa de Microsoft Entra ID, o con una cuenta personal de Microsoft, antes de poder abrir un túnel HTTP. Registras una aplicación en Microsoft Entra, 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.
- Acceso al centro de administración de Microsoft Entra con un rol que pueda registrar aplicaciones. Microsoft indica Application Developer como mínimo.
- Una decisión sobre quién puede iniciar sesión: solo tu organización, cualquier organización o también cuentas personales. Determina dos de las direcciones que introduces en Localtonet. Consulta Tipos de cuenta y endpoints.
Pasos #
-
Registra una aplicación en Microsoft Entra #
Las guías de Microsoft son Register an app in Microsoft Entra ID, Add a redirect URI y Add app credentials. En resumen:
- En el centro de administración de Microsoft Entra, ve a Entra ID › App registrations y selecciona New registration.
- Introduce un Name. Los visitantes lo ven cuando inician sesión.
- En Supported account types, elige quién puede usar la aplicación y luego selecciona Register.
- En la página Overview, copia el Application (client) ID. En una aplicación de un solo tenant, copia también el Directory (tenant) ID.
- En Manage, abre Authentication, selecciona Add Redirect URI, elige la plataforma Web, introduce el redirect URI que aparece abajo y selecciona Configure.
- Abre Certificates & secrets › Client secrets y selecciona New client secret. Añade una descripción, elige una caducidad y selecciona Add. Copia de inmediato el Value del secreto: Microsoft no vuelve a mostrarlo después de que salgas de la página.
Redirect URI (plataforma: Web)http://auth.localtonet.com/auth/callbackUn secreto de cliente caduca. Microsoft limita su duración a 24 meses. Cuando caduca, el inicio de sesión deja de funcionar hasta que creas un secreto nuevo y lo guardas en el proveedor de Localtonet.
-
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 Microsoft. Lo verás en la configuración del túnel.Tipo de proveedor Microsoft. 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 Application (client) ID de Microsoft Entra. Secreto de cliente El Value del secreto, no el Secret ID. Nunca se muestra después de guardar. Abre Endpoints y callback. Estos valores se rellenan automáticamente:
Campo Valor rellenado ¿Hay que cambiarlo? Endpoint de autorización https://login.microsoftonline.com/common/oauth2/v2.0/authorizeSustituye commonsegún la tabla de la sección siguiente.Endpoint de token https://login.microsoftonline.com/common/oauth2/v2.0/tokenSustituye commonpor el mismo valor que arriba.Endpoint de información del usuario https://graph.microsoft.com/oidc/userinfoNo. No contiene ningún tenant. Ruta de callback /auth/callback/microsoftNo. 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 Microsoft. Selecciona Guardar.
Las listas de Quién puede iniciar sesión y las Rutas de inicio de sesión son opcionales. 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. Después de iniciar sesión en Microsoft, vuelves al túnel y se carga tu servicio.
Tipos de cuenta y endpoints #
La parte de la dirección de Microsoft que sigue a login.microsoftonline.com/ controla quién puede iniciar sesión. Debe encajar con los Supported account types de tu aplicación. El Endpoint de autorización y el Endpoint de token siempre reciben el mismo valor. El Endpoint de información del usuario nunca cambia.
| Tipos de cuenta admitidos en Microsoft Entra | Usar en lugar de common | Quién puede iniciar sesión |
|---|---|---|
| Single tenant only | Tu Directory (tenant) ID | Usuarios e invitados de tu propio tenant. |
| Multiple Entra ID tenants | organizations | Cuentas profesionales o educativas de cualquier organización. |
| Any Entra ID Tenant + Personal Microsoft accounts | Mantén common | Cuentas profesionales o educativas y cuentas personales de Microsoft. |
| Personal accounts only | consumers | Cuentas personales de Microsoft. |
Ejemplo para una aplicación de un solo tenant. Sustituye <TENANT_ID> por tu Directory (tenant) ID:
Authorization endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/authorize
Token endpoint: https://login.microsoftonline.com/<TENANT_ID>/oauth2/v2.0/token
User info endpoint: https://graph.microsoft.com/oidc/userinfoUna aplicación de un solo tenant no funciona con common. Microsoft responde con el error AADSTS50194. Pon el ID de tu tenant en ambos endpoints o cambia la aplicación a un tipo de cuenta multitenant.
Con un tipo de cuenta multitenant o personal, personas ajenas a tu organización pueden iniciar sesión en Microsoft. Usa Dominios de correo permitidos en el proveedor, o Quién puede iniciar sesión en el túnel, para admitir solo a las personas que quieras.
Qué lee Localtonet de Microsoft #
El endpoint de información del usuario de Microsoft devuelve una dirección de correo solo cuando hay una asociada a la cuenta, así que una cuenta sin dirección de correo puede no pasar las reglas que se basan en el correo.
Solución de problemas #
AADSTS50011: la URL de respuesta no coincide
El redirect URI de la solicitud no está registrado para la aplicación. El mensaje muestra la dirección que se envió. Debe ser idéntica a un redirect URI de la página Authentication del registro de la aplicación, en la plataforma Web, incluidas las mayúsculas y minúsculas. Registra exactamente http://auth.localtonet.com/auth/callback.
AADSTS50194: la aplicación no está configurada como aplicación multitenant
La aplicación es de un solo tenant, pero los endpoints siguen conteniendo common. Sustituye common por tu Directory (tenant) ID en el Endpoint de autorización y en el Endpoint de token, y selecciona Guardar proveedor.
AADSTS700016: no se encontró la aplicación en el directorio
El ID de cliente es incorrecto, o los endpoints apuntan a un tenant en el que la aplicación no existe. Comprueba el Application (client) ID y el ID de tenant de los endpoints.
AADSTS7000215 o AADSTS7000222: secreto de cliente no válido o caducado
Crea un secreto de cliente nuevo en Certificates & secrets, pega su Value en Secreto de cliente en Localtonet y selecciona Guardar proveedor.
Microsoft pide aprobación del administrador
Tu tenant no permite que los usuarios den su consentimiento a las aplicaciones por sí mismos. Un administrador del tenant debe conceder el consentimiento a la aplicación en el centro de administración de Microsoft Entra.
«403 - Access Denied» tras un inicio de sesión correcto en Microsoft
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, y comprueba si la cuenta tiene siquiera una dirección de correo. Después de corregir una regla, espera un minuto y recarga.