Single Sign-On mit Microsoft
Guthaben erforderlich HTTP-Tunnel
Auf dieser Seite 6 Abschnitte
Lassen Sie Besucher sich mit einem Microsoft-Entra-ID-Geschäfts- oder Schulkonto oder einem persönlichen Microsoft-Konto anmelden, bevor sie einen HTTP-Tunnel öffnen können. Sie registrieren eine Anwendung in Microsoft Entra, fügen sie in Localtonet als Anbieter hinzu und aktivieren sie dann für den Tunnel.
Bevor Sie beginnen #
- Ein HTTP-Tunnel und Guthaben auf Ihrem Konto. Siehe die Single-Sign-On-Übersicht.
- Zugriff auf das Microsoft Entra admin center mit einer Rolle, die Anwendungen registrieren darf. Microsoft nennt Application Developer als Minimum.
- Eine Entscheidung darüber, wer sich anmelden darf: nur Ihre Organisation, jede Organisation oder auch persönliche Konten. Sie bestimmt zwei der Adressen, die Sie in Localtonet eingeben. Siehe Kontotypen und Endpunkte.
Schritte #
-
Eine Anwendung in Microsoft Entra registrieren #
Die eigenen Anleitungen von Microsoft sind Register an app in Microsoft Entra ID, Add a redirect URI und Add app credentials. Kurz gefasst:
- Gehen Sie im Microsoft Entra admin center zu Entra ID › App registrations und wählen Sie New registration.
- Geben Sie einen Name ein. Besucher sehen ihn bei der Anmeldung.
- Wählen Sie unter Supported account types, wer die Anwendung verwenden darf, und wählen Sie dann Register.
- Kopieren Sie auf der Seite Overview die Application (client) ID. Kopieren Sie bei einer Single-Tenant-Anwendung auch die Directory (tenant) ID.
- Öffnen Sie unter Manage den Eintrag Authentication, wählen Sie Add Redirect URI, wählen Sie die Plattform Web, geben Sie die untenstehende Redirect-URI ein und wählen Sie Configure.
- Öffnen Sie Certificates & secrets › Client secrets und wählen Sie New client secret. Fügen Sie eine Beschreibung hinzu, wählen Sie ein Ablaufdatum und wählen Sie Add. Kopieren Sie den Value des Secrets sofort: Microsoft zeigt ihn nach dem Verlassen der Seite nie wieder an.
Redirect-URI (Plattform: Web)http://auth.localtonet.com/auth/callbackEin Client-Secret läuft ab. Microsoft begrenzt seine Lebensdauer auf 24 Monate. Nach dem Ablauf funktioniert die Anmeldung nicht mehr, bis Sie ein neues Secret erstellen und im Localtonet-Anbieter speichern.
-
Den Anbieter in Localtonet hinzufügen #
Öffnen Sie Meine Tunnel › HTTP und wählen Sie oben auf der Seite SSO. Wählen Sie im Dialog SSO-Anbieter die Option Anbieter hinzufügen.
Feld Wert Anbietername Ein beliebiger Name, zum Beispiel Company Microsoft. Sie sehen ihn in den Tunneleinstellungen.Anbietertyp Microsoft. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird die Client-ID geleert. Geben Sie daher Client-ID und Client-Secret erneut ein. Aktiv An Client-ID Die Application (client) ID aus Microsoft Entra. Client-Secret Der Value des Secrets, nicht die Secret ID. Er wird nach dem Speichern nie wieder angezeigt. Öffnen Sie Endpunkte & Callback. Diese Werte werden automatisch eingetragen:
Feld Eingetragener Wert Ändern? Autorisierungs-Endpunkt https://login.microsoftonline.com/common/oauth2/v2.0/authorizeErsetzen Sie commongemäß der Tabelle im nächsten Abschnitt.Token-Endpunkt https://login.microsoftonline.com/common/oauth2/v2.0/tokenErsetzen Sie commondurch denselben Wert wie oben.Userinfo-Endpunkt https://graph.microsoft.com/oidc/userinfoNein. Er enthält keinen Tenant. Callback-Pfad /auth/callback/microsoftNein. Füllen Sie optional E-Mail-Zugriffsregeln aus und wählen Sie dann Anbieter speichern.
-
Für einen Tunnel einschalten #
Wählen Sie unter Ihre Tunnel beim Tunnel Einstellungen und dann neben SSO-Anbieter die Option Verwalten. Aktivieren Sie im Dialog Single Sign-On die Option Anmeldung verlangen sowie den Schalter Ihres Microsoft-Anbieters. Wählen Sie Speichern.
Die Listen unter Wer sich anmelden darf und die Anmeldepfade sind optional. Sie werden in der Übersicht erklärt.
-
Testen #
Öffnen Sie die Tunnel-URL in einem privaten Browserfenster. Localtonet zeigt Sign in to continue mit einer Schaltfläche für Ihren Anbieter. Nach der Anmeldung bei Microsoft werden Sie zum Tunnel zurückgeleitet, und Ihr Dienst wird geladen.
Kontotypen und Endpunkte #
Der Teil der Microsoft-Adresse nach login.microsoftonline.com/ bestimmt, wer sich anmelden darf. Er muss zu den Supported account types Ihrer Anwendung passen. Der Autorisierungs-Endpunkt und der Token-Endpunkt erhalten immer denselben Wert. Der Userinfo-Endpunkt ändert sich nie.
| Supported account types in Microsoft Entra | Anstelle von common verwenden | Wer sich anmelden darf |
|---|---|---|
| Single tenant only | Ihre Directory (tenant) ID | Benutzer und Gäste Ihres eigenen Tenants. |
| Multiple Entra ID tenants | organizations | Geschäfts- oder Schulkonten jeder Organisation. |
| Any Entra ID Tenant + Personal Microsoft accounts | common beibehalten | Geschäfts- oder Schulkonten und persönliche Microsoft-Konten. |
| Personal accounts only | consumers | Persönliche Microsoft-Konten. |
Beispiel für eine Single-Tenant-Anwendung. Ersetzen Sie <TENANT_ID> durch Ihre 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/userinfoEine Single-Tenant-Anwendung funktioniert nicht mit common. Microsoft antwortet mit dem Fehler AADSTS50194. Tragen Sie entweder Ihre Tenant-ID in beide Endpunkte ein oder ändern Sie die Anwendung auf einen Multitenant-Kontotyp.
Bei einem Multitenant- oder persönlichen Kontotyp können sich auch Personen außerhalb Ihrer Organisation bei Microsoft anmelden. Verwenden Sie Erlaubte E-Mail-Domains beim Anbieter oder Wer sich anmelden darf beim Tunnel, um nur die gewünschten Personen zuzulassen.
Was Localtonet von Microsoft liest #
Der Userinfo-Endpunkt von Microsoft liefert nur dann eine E-Mail-Adresse, wenn dem Konto eine zugeordnet ist. Ein Konto ohne E-Mail-Adresse besteht daher möglicherweise Regeln nicht, die auf der E-Mail-Adresse beruhen.
Fehlerbehebung #
AADSTS50011: Die Antwort-URL stimmt nicht überein
Die Redirect-URI in der Anfrage ist für die Anwendung nicht registriert. Die Meldung zeigt die gesendete Adresse. Sie muss mit einer Redirect-URI auf der Seite Authentication der App-Registrierung auf der Plattform Web identisch sein, einschließlich Groß- und Kleinschreibung. Registrieren Sie genau http://auth.localtonet.com/auth/callback.
AADSTS50194: Die Anwendung ist nicht als Multitenant-Anwendung konfiguriert
Die Anwendung ist Single Tenant, aber die Endpunkte enthalten noch common. Ersetzen Sie common im Autorisierungs-Endpunkt und im Token-Endpunkt durch Ihre Directory (tenant) ID und wählen Sie Anbieter speichern.
AADSTS700016: Die Anwendung wurde im Verzeichnis nicht gefunden
Die Client-ID ist falsch, oder die Endpunkte verweisen auf einen Tenant, in dem die Anwendung nicht existiert. Prüfen Sie die Application (client) ID und die Tenant-ID in den Endpunkten.
AADSTS7000215 oder AADSTS7000222: ungültiges oder abgelaufenes Client-Secret
Erstellen Sie unter Certificates & secrets ein neues Client-Secret, fügen Sie seinen Value in Localtonet bei Client-Secret ein und wählen Sie Anbieter speichern.
Microsoft verlangt eine Administratorgenehmigung
Ihr Tenant erlaubt Benutzern nicht, Anwendungen selbst zuzustimmen. Ein Administrator des Tenants muss im Microsoft Entra admin center die Zustimmung für die Anwendung erteilen.
„403 - Access Denied“ nach erfolgreicher Microsoft-Anmeldung
Eine Localtonet-Regel hat das Konto abgelehnt. Prüfen Sie die E-Mail-Zugriffsregeln beim Anbieter und Wer sich anmelden darf beim Tunnel sowie, ob das Konto überhaupt eine E-Mail-Adresse hat. Warten Sie nach der Korrektur einer Regel eine Minute und laden Sie die Seite neu.