Zum Inhalt springen
Localtonet Localtonet Dashboard

Single Sign-On mit Microsoft

Guthaben erforderlich HTTP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 6 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Eine Anwendung in Microsoft Entra registrieren
  4. Den Anbieter in Localtonet hinzufügen
  5. Für einen Tunnel einschalten
  6. Testen
  7. Kontotypen und Endpunkte
  8. Was Localtonet von Microsoft liest
  9. Fehlerbehebung
  10. Verwandte Seiten

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 #

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

    1. Gehen Sie im Microsoft Entra admin center zu Entra ID › App registrations und wählen Sie New registration.
    2. Geben Sie einen Name ein. Besucher sehen ihn bei der Anmeldung.
    3. Wählen Sie unter Supported account types, wer die Anwendung verwenden darf, und wählen Sie dann Register.
    4. Kopieren Sie auf der Seite Overview die Application (client) ID. Kopieren Sie bei einer Single-Tenant-Anwendung auch die Directory (tenant) ID.
    5. Ö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.
    6. Ö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/callback

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

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

    FeldWert
    AnbieternameEin beliebiger Name, zum Beispiel Company Microsoft. Sie sehen ihn in den Tunneleinstellungen.
    AnbietertypMicrosoft. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird die Client-ID geleert. Geben Sie daher Client-ID und Client-Secret erneut ein.
    AktivAn
    Client-IDDie Application (client) ID aus Microsoft Entra.
    Client-SecretDer Value des Secrets, nicht die Secret ID. Er wird nach dem Speichern nie wieder angezeigt.

    Öffnen Sie Endpunkte & Callback. Diese Werte werden automatisch eingetragen:

    FeldEingetragener WertÄndern?
    Autorisierungs-Endpunkthttps://login.microsoftonline.com/common/oauth2/v2.0/authorizeErsetzen Sie common gemäß der Tabelle im nächsten Abschnitt.
    Token-Endpunkthttps://login.microsoftonline.com/common/oauth2/v2.0/tokenErsetzen Sie common durch denselben Wert wie oben.
    Userinfo-Endpunkthttps://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.

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

  4. 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 EntraAnstelle von common verwendenWer sich anmelden darf
Single tenant onlyIhre Directory (tenant) IDBenutzer und Gäste Ihres eigenen Tenants.
Multiple Entra ID tenantsorganizationsGeschäfts- oder Schulkonten jeder Organisation.
Any Entra ID Tenant + Personal Microsoft accountscommon beibehaltenGeschäfts- oder Schulkonten und persönliche Microsoft-Konten.
Personal accounts onlyconsumersPersönliche Microsoft-Konten.

Beispiel für eine Single-Tenant-Anwendung. Ersetzen Sie <TENANT_ID> durch Ihre 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

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

Brauchen Sie Hilfe zu dieser Seite? Fragen Sie die Community oder eröffnen Sie ein Support-Ticket.

Support