Naar de inhoud
Localtonet Localtonet Dashboard

Single sign-on met Microsoft

Saldo vereist HTTP-tunnels

Hulp bij deze pagina
Op deze pagina 6 secties
  1. Voordat je begint
  2. Stappen
  3. Een applicatie registreren in Microsoft Entra
  4. De provider toevoegen in Localtonet
  5. Zet hem aan voor een tunnel
  6. Test het
  7. Accounttypen en endpoints
  8. Wat Localtonet van Microsoft leest
  9. Problemen oplossen
  10. Gerelateerde pagina's

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 #

  1. 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:

    1. Ga in het Microsoft Entra admin center naar Entra ID › App registrations en kies New registration.
    2. Voer een Name in. Bezoekers zien die wanneer ze inloggen.
    3. Kies onder Supported account types wie de applicatie mag gebruiken en kies dan Register.
    4. Kopieer op de pagina Overview de Application (client) ID. Kopieer bij een single-tenant-applicatie ook de Directory (tenant) ID.
    5. Open onder Manage de pagina Authentication, kies Add Redirect URI, kies het platform Web, voer de onderstaande redirect-URI in en kies Configure.
    6. 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/callback

    Een 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.

  2. 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.

    VeldWaarde
    ProvidernaamEen willekeurige naam, bijvoorbeeld Company Microsoft. Je ziet hem in de tunnelinstellingen.
    ProvidertypeMicrosoft. Als je het type van een opgeslagen provider wijzigt, wordt Client-ID leeggemaakt, dus voer de client-ID en het clientgeheim opnieuw in.
    ActiefAan
    Client-IDDe Application (client) ID uit Microsoft Entra.
    ClientgeheimDe Value van het geheim, niet de Secret ID. Na het opslaan wordt het nooit meer getoond.

    Open Endpoints & callback. Deze waarden worden automatisch ingevuld:

    VeldIngevulde waardeWijzigen?
    Autorisatie-endpointhttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeVervang common volgens de tabel in de volgende sectie.
    Token-endpointhttps://login.microsoftonline.com/common/oauth2/v2.0/tokenVervang common door dezelfde waarde als hierboven.
    Gebruikersinfo-endpointhttps://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.

  3. 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.

  4. 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 EntraGebruik in plaats van commonWie kan inloggen
Single tenant onlyJe Directory (tenant) IDGebruikers en gasten van je eigen tenant.
Multiple Entra ID tenantsorganizationsWerk- of schoolaccounts van elke organisatie.
Any Entra ID Tenant + Personal Microsoft accountsHoud common aanWerk- of schoolaccounts en persoonlijke Microsoft-accounts.
Personal accounts onlyconsumersPersoonlijke Microsoft-accounts.

Voorbeeld voor een single-tenant-applicatie. Vervang <TENANT_ID> door je Directory (tenant) ID:

Single tenant
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/userinfo

Een 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.

Support