Single sign-on met Microsoft
Saldo vereist HTTP-tunnels
Op deze pagina 6 secties
Laat bezoekers inloggen met een Microsoft Entra ID-werk- of schoolaccount, of een persoonlijk Microsoft-account, voordat ze een HTTP-tunnel kunnen openen. Je registreert een applicatie in Microsoft Entra, voegt die als provider toe aan Localtonet en zet hem daarna aan voor de tunnel.
Voordat je begint #
- Een HTTP-tunnel en saldo op je account. Zie het overzicht van Single sign-on.
- Toegang tot het Microsoft Entra admin center met een rol die applicaties mag registreren. Microsoft noemt Application Developer als minimum.
- Een besluit over wie mag inloggen: alleen je organisatie, elke organisatie, of ook persoonlijke accounts. Dit bepaalt twee van de adressen die je in Localtonet invoert. Zie Accounttypen en endpoints.
Stappen #
-
Een applicatie registreren in Microsoft Entra #
De eigen handleidingen van Microsoft zijn Register an app in Microsoft Entra ID, Add a redirect URI en Add app credentials. In het kort:
- Ga in het Microsoft Entra admin center naar Entra ID › App registrations en kies New registration.
- Voer een Name in. Bezoekers zien die wanneer ze inloggen.
- Kies onder Supported account types wie de applicatie mag gebruiken en kies dan Register.
- Kopieer op de pagina Overview de Application (client) ID. Kopieer bij een single-tenant-applicatie ook de Directory (tenant) ID.
- Open onder Manage de pagina Authentication, kies Add Redirect URI, kies het platform Web, voer de onderstaande redirect-URI in en kies Configure.
- Open Certificates & secrets › Client secrets en kies New client secret. Voeg een beschrijving toe, kies een vervaldatum en kies Add. Kopieer de Value van het geheim meteen: Microsoft toont die nooit meer nadat je de pagina verlaat.
Redirect-URI (platform: Web)http://auth.localtonet.com/auth/callbackEen clientgeheim verloopt. Microsoft beperkt de levensduur tot 24 maanden. Zodra het verloopt, werkt inloggen niet meer totdat je een nieuw geheim aanmaakt en het opslaat in de Localtonet-provider.
-
De provider toevoegen in Localtonet #
Open Mijn tunnels › HTTP en kies bovenaan de pagina SSO. Kies in het dialoogvenster SSO-providers de knop Provider toevoegen.
Veld Waarde Providernaam Een willekeurige naam, bijvoorbeeld Company Microsoft. Je ziet hem in de tunnelinstellingen.Providertype Microsoft. Als je het type van een opgeslagen provider wijzigt, wordt Client-ID leeggemaakt, dus voer de client-ID en het clientgeheim opnieuw in. Actief Aan Client-ID De Application (client) ID uit Microsoft Entra. Clientgeheim De Value van het geheim, niet de Secret ID. Na het opslaan wordt het nooit meer getoond. Open Endpoints & callback. Deze waarden worden automatisch ingevuld:
Veld Ingevulde waarde Wijzigen? Autorisatie-endpoint https://login.microsoftonline.com/common/oauth2/v2.0/authorizeVervang commonvolgens de tabel in de volgende sectie.Token-endpoint https://login.microsoftonline.com/common/oauth2/v2.0/tokenVervang commondoor dezelfde waarde als hierboven.Gebruikersinfo-endpoint https://graph.microsoft.com/oidc/userinfoNee. Het bevat geen tenant. Callbackpad /auth/callback/microsoftNee. Vul eventueel Toegangsregels voor e-mail in en kies dan Provider opslaan.
-
Zet hem aan voor een tunnel #
Kies onder Je tunnels de knop Instellingen bij de tunnel en daarna Beheren naast SSO-providers. Zet in het dialoogvenster Single sign-on Inloggen vereisen en de schakelaar van je Microsoft-provider aan. Kies Opslaan.
De lijsten onder Wie kan inloggen en de Inlogpaden zijn optioneel. Ze worden uitgelegd in het overzicht.
-
Test het #
Open de URL van de tunnel in een privévenster van de browser. Localtonet toont Sign in to continue met een knop voor je provider. Nadat je bij Microsoft bent ingelogd, word je teruggestuurd naar de tunnel en laadt je service.
Accounttypen en endpoints #
Het deel van het Microsoft-adres na login.microsoftonline.com/ bepaalt wie kan inloggen. Het moet passen bij de Supported account types van je applicatie. Het Autorisatie-endpoint en het Token-endpoint krijgen altijd dezelfde waarde. Het Gebruikersinfo-endpoint verandert nooit.
| Supported account types in Microsoft Entra | Gebruik in plaats van common | Wie kan inloggen |
|---|---|---|
| Single tenant only | Je Directory (tenant) ID | Gebruikers en gasten van je eigen tenant. |
| Multiple Entra ID tenants | organizations | Werk- of schoolaccounts van elke organisatie. |
| Any Entra ID Tenant + Personal Microsoft accounts | Houd common aan | Werk- of schoolaccounts en persoonlijke Microsoft-accounts. |
| Personal accounts only | consumers | Persoonlijke Microsoft-accounts. |
Voorbeeld voor een single-tenant-applicatie. Vervang <TENANT_ID> door je 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/userinfoEen single-tenant-applicatie werkt niet met common. Microsoft antwoordt met fout AADSTS50194. Zet je tenant-ID in beide endpoints, of wijzig de applicatie naar een multitenant-accounttype.
Bij een multitenant- of persoonlijk accounttype kunnen mensen buiten je organisatie bij Microsoft inloggen. Gebruik Toegestane e-maildomeinen bij de provider, of Wie kan inloggen bij de tunnel, om alleen de mensen toe te laten die je wilt.
Wat Localtonet van Microsoft leest #
Het gebruikersinfo-endpoint van Microsoft geeft alleen een e-mailadres terug als er een aan het account is gekoppeld, dus een account zonder e-mailadres komt mogelijk niet door regels die op e-mail werken.
Problemen oplossen #
AADSTS50011: de antwoord-URL komt niet overeen
De redirect-URI in het verzoek is niet geregistreerd voor de applicatie. De melding toont het adres dat is verzonden. Het moet identiek zijn aan een redirect-URI op de pagina Authentication van de app-registratie, op het platform Web, inclusief hoofd- en kleine letters. Registreer precies http://auth.localtonet.com/auth/callback.
AADSTS50194: de applicatie is niet geconfigureerd als multitenant-applicatie
De applicatie is single tenant, maar de endpoints bevatten nog steeds common. Vervang common door je Directory (tenant) ID in het Autorisatie-endpoint en het Token-endpoint en kies Provider opslaan.
AADSTS700016: de applicatie is niet gevonden in de directory
De Client-ID is onjuist, of de endpoints wijzen naar een tenant waarin de applicatie niet bestaat. Controleer de Application (client) ID en de tenant-ID in de endpoints.
AADSTS7000215 of AADSTS7000222: ongeldig of verlopen clientgeheim
Maak onder Certificates & secrets een nieuw clientgeheim aan, plak de Value ervan in Clientgeheim in Localtonet en kies Provider opslaan.
Microsoft vraagt om goedkeuring van een beheerder
Je tenant laat gebruikers niet zelf toestemming geven aan applicaties. Een beheerder van de tenant moet in het Microsoft Entra admin center toestemming voor de applicatie verlenen.
"403 - Access Denied" na een geslaagde Microsoft-aanmelding
Een Localtonet-regel heeft het account geweigerd. Controleer Toegangsregels voor e-mail bij de provider en Wie kan inloggen bij de tunnel, en of het account wel een e-mailadres heeft. Wacht na het corrigeren van een regel een minuut en laad opnieuw.