Zum Inhalt springen
Localtonet Localtonet Dashboard

Single Sign-On für HTTP-Tunnel

Guthaben erforderlich HTTP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 10 Abschnitte
  1. Wann Sie es einsetzen
  2. So funktioniert es
  3. Bevor Sie beginnen
  4. Anbieter
  5. Einrichtung
  6. Anbieter hinzufügen
  7. Für einen Tunnel einschalten
  8. Testen
  9. Die Redirect-URI
  10. Zugriffsregeln
  11. Anmeldepfade und Abmeldepfad
  12. Fehlerbehebung
  13. Automatisierung

Single Sign-On (SSO) setzt eine Anmeldeseite vor einen HTTP-Tunnel. Besucher melden sich bei einem Identitätsanbieter Ihrer Wahl an, etwa Google, GitHub, Microsoft oder GitLab, oder mit einem von Ihnen festgelegten Benutzernamen und Passwort, bevor eine Anfrage Ihren Dienst erreicht.

Wann Sie es einsetzen #

Solange Sie ihn nicht schützen, steht ein HTTP-Tunnel jedem offen, der seine Adresse kennt. SSO ist der richtige Schutz, wenn Menschen den Tunnel im Browser öffnen und Sie entscheiden möchten, wer sie sind: ein Admin-Panel, ein Dashboard, ein internes Tool, eine Staging-Website. Ihr Dienst bleibt unverändert und sieht nie ein Passwort.

SSO ist für Browser gedacht. Eine Anfrage ohne das Anmelde-Cookie wird auf die Anmeldeseite umgeleitet, sodass Skripte, Webhooks und API-Clients nicht durchkommen. Schützen Sie für diese nur einzelne Pfade (siehe Anmeldepfade) oder nutzen Sie die Optionen unter Zugriffskontrolle.

So funktioniert es #

Ein Besucher öffnet die Tunnel-URL. Der Localtonet-Server leitet den Besucher auf die Anmeldeseite unter auth.localtonet.com um, wo er sich bei einem Identitätsanbieter anmeldet. Anschließend wird der Besucher zurück zur Tunnel-URL geschickt, und die Anfrage wird an Ihren Dienst weitergeleitet. Besucher Browser 1. Öffnet Tunnel-URL Localtonet-Server 2. Weiterleitung Anmeldeseite auth.localtonet.com 3. Anmelden Anbieter Google, GitHub… 4. Angemeldet, zurück zum Tunnel 5. Anfrage Ihr Dienst Auf Ihrem Gerät
Die Anmeldung erfolgt auf der Anmeldeseite von Localtonet, nicht in Ihrem Dienst.
  1. Ein Besucher öffnet die Tunnel-URL. Eine Anfrage über HTTP wird zuerst auf HTTPS umgeleitet.
  2. Der Besucher ist noch nicht angemeldet, daher leitet der Localtonet-Server den Browser auf die Anmeldeseite unter auth.localtonet.com um. Die Seite trägt die Überschrift Sign in to continue und bietet die Anbieter an, die Sie für diesen Tunnel eingeschaltet haben.
  3. Der Besucher wählt einen Anbieter und meldet sich dort an. Bei einem Anbieter mit Benutzername und Passwort befindet sich das Formular auf der Anmeldeseite selbst.
  4. Localtonet prüft Ihre Zugriffsregeln und schickt den Besucher zu der Adresse zurück, die er aufgerufen hat. Die Anmeldung wird in einem Cookie für den Hostnamen des Tunnels gespeichert. Es ist ein Browser-Sitzungs-Cookie, das nur über HTTPS gesendet wird.
  5. Ab dann werden Anfragen wie gewohnt an Ihren Dienst weitergeleitet. Ist die Anmeldung nicht mehr gültig, wird der Besucher erneut auf die Anmeldeseite geschickt.

Ein Besucher, der sich anmeldet, aber von Ihren Regeln nicht zugelassen wird, sieht 403 - Access Denied mit dem Text „You do not have permission to access this tunnel.“

Pfade unter /.well-known werden nie hinter die Anmeldung gesetzt.

Bevor Sie beginnen #

  • Ein HTTP-Tunnel. Siehe HTTP / HTTPS.
  • Guthaben auf Ihrem Konto. Ohne Guthaben schlägt das Speichern eines Anbieters oder das Einschalten der Anmeldung mit „Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“ fehl. Siehe Pläne und Guthaben und Preise.
  • Bei einem externen Anbieter: ein Konto dort, mit dem Sie eine OAuth-Anwendung registrieren können.

SSO richten Sie in Ihrem persönlichen Dashboard ein. Die Schaltfläche SSO und die Einstellung SSO-Anbieter werden für Team-Tunnel nicht angezeigt.

Anbieter #

Diese Anleitungen führen Sie Schritt für Schritt durch die gängigsten Optionen:

Die Liste Anbietertyp im Dashboard enthält: Username-Password, Google, GitHub, Microsoft, OpenID Connect, Discord, Twitter (X), Custom, Facebook, Apple, LinkedIn, GitLab, Slack, Spotify, Twitch, Reddit, Bitbucket, Amazon und Yahoo. Für jeden Typ außer Username-Password und Custom werden die Endpunkte für Sie ausgefüllt. Bei OpenID Connect sind die ausgefüllten Adressen Beispiele, die Sie durch die Endpunkte Ihres Anbieters ersetzen.

Einrichtung #

Es gibt zwei Teile. Sie fügen einmal einen Anbieter hinzu, und er steht dann allen Ihren HTTP-Tunneln zur Verfügung. Danach schalten Sie ihn für jeden Tunnel ein, den Sie schützen möchten. Ein gespeicherter Anbieter schützt nichts, solange ihn kein Tunnel verwendet.

  1. Anbieter hinzufügen #

    Öffnen Sie Meine Tunnel › HTTP und wählen Sie oben auf der Seite SSO (der Tooltip lautet SSO-Anbietereinstellungen). Der Dialog SSO-Anbieter öffnet sich. Wählen Sie Anbieter hinzufügen, füllen Sie das Formular aus und wählen Sie Anbieter speichern. Jeder Anbieter wird einzeln gespeichert.

    FeldWas es istHinweise
    AnbieternameEin Name, mit dem Sie diesen Anbieter in Ihren Tunneleinstellungen erkennen.Erforderlich. Zum Beispiel Company Google.
    AnbietertypDie Anmeldemethode.Ein neuer Anbieter beginnt als Google. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird Client-ID geleert, geben Sie also die Client-ID und das Client-Secret erneut ein.
    AktivMacht den Anbieter für Tunnel verfügbar.Wenn Sie einen Anbieter auf inaktiv stellen und speichern, wird er auch bei jedem Tunnel ausgeschaltet, der ihn verwendet hat.
    Client-IDDie ID der Anwendung, die Sie beim Anbieter registriert haben.Erforderlich für jeden Typ außer Username-Password und Custom.
    Client-SecretDas Secret dieser Anwendung.Wird nach dem Speichern nie angezeigt. Lassen Sie das Feld später leer, um das gespeicherte Secret zu behalten.
    Endpunkte & CallbackAutorisierungs-Endpunkt, Token-Endpunkt, Userinfo-Endpunkt und Callback-Pfad.Werden für die Standardanbieter automatisch ausgefüllt. Ändern Sie sie nur, wenn eine Anleitung es verlangt.
    E-Mail-ZugriffsregelnErlaubte E-Mail-Domains, Blockierte E-Mail-Domains und Blockierte E-Mail-Adressen.Optional. Siehe Zugriffsregeln.
    AnmeldebenutzerBenutzernamen und Passwörter.Nur für die Typen Username-Password und Custom.

    Um einen Anbieter zu entfernen, wählen Sie Anbieter löschen. Dadurch wird er aus Ihrem Konto und aus den SSO-Einstellungen Ihrer Tunnel entfernt.

  2. Für einen Tunnel einschalten #

    Wählen Sie unter Ihre Tunnel beim Tunnel Einstellungen. Suchen Sie im Bereich Tunneleinstellungen den Eintrag SSO-Anbieter und wählen Sie Verwalten. Der Dialog Single Sign-On öffnet sich.

    EinstellungFunktion
    Anmeldung verlangenSchaltet SSO für diesen Tunnel ein. Besucher, die nicht angemeldet sind, werden zuerst auf die Anmeldeseite geschickt.
    AnbieterEin Schalter für jeden Ihrer aktiven Anbieter. Schalten Sie mindestens einen ein. Sind mehrere eingeschaltet, wählt der Besucher auf der Anmeldeseite.
    Wer sich anmelden darfOptionale Listen mit E-Mail-Adressen, E-Mail-Domains und Benutzernamen für diesen Tunnel.
    An- und AbmeldepfadeOptionale Anmeldepfade und ein Abmeldepfad.

    Wählen Sie Speichern.

  3. Testen #

    Öffnen Sie die Tunnel-URL in einem privaten Browserfenster. Sie sollten auf der Seite Sign in to continue landen und nach der Anmeldung bei Ihrem Dienst.

Die Redirect-URI #

Ein externer Anbieter fragt, wohin er Personen nach der Anmeldung schicken darf. Für jeden Tunnel ist das eine Adresse auf dem Anmelde-Host von Localtonet, nicht die Adresse Ihres Tunnels. Registrieren Sie genau diesen Wert:

Redirect-URI
http://auth.localtonet.com/auth/callback

Jede Anbieter-Anleitung zeigt Ihnen, wo Sie ihn eintragen.

WertWohin er gehört
Die Redirect-URI obenBeim Anbieter: Authorized redirect URIs (Google), Authorization callback URL (GitHub), Redirect URI (Microsoft, GitLab).
Callback-Pfad, zum Beispiel /auth/callback/googleIn Localtonet unter Endpunkte & Callback. Er wird für Sie ausgefüllt. Lassen Sie ihn unverändert.

Der Anbieter vergleicht die Redirect-URI exakt mit dem registrierten Wert. Kopieren Sie sie daher genau so, wie sie hier steht.

Zugriffsregeln #

Die Anmeldung beweist, wer ein Besucher ist. Die Regeln entscheiden, ob diese Person den Tunnel öffnen darf. Es gibt zwei Ebenen, und beide gelten.

WoListeWas das Dashboard sagt
AnbieterErlaubte E-Mail-DomainsLeer lassen, wenn es keine Domain-Einschränkung geben soll. Platzhalter hängen vom Anbieter ab.
AnbieterBlockierte E-Mail-DomainsAnmeldungen von diesen E-Mail-Domains blockieren.
AnbieterBlockierte E-Mail-AdressenDiese einzelnen E-Mail-Adressen blockieren.
TunnelE-Mail-Adressen, E-Mail-Domains, BenutzernamenLassen Sie eine Liste leer, um diese Prüfung zu überspringen. Die Listen gelten für alle Anbieter, die für den Tunnel eingeschaltet sind.

Geben Sie einen Eintrag pro Zeile ein oder trennen Sie Einträge mit Kommas. Eine Domain geben Sie ohne @ ein, zum Beispiel example.com.

Nachdem Sie eine Regel geändert haben, kann ein Besucher, der bereits zugelassen wurde, den Zugriff noch bis zu fünf Minuten behalten. Ein abgewiesener Besucher wird nach einer Minute erneut geprüft.

Anmeldepfade und Abmeldepfad #

EinstellungVerhaltenBeispiel
AnmeldepfadeLeer: Jeder Pfad des Tunnels erfordert eine Anmeldung. Gefüllt: Nur Anfragen, deren Pfad mit einem der Einträge beginnt, erfordern eine Anmeldung./admin deckt /admin und /admin/users ab, nicht /administrator.
AbmeldepfadBeim Öffnen wird die Anmeldung für diesen Tunnel entfernt, und der Besucher wird zur Startseite des Tunnels oder zu der Adresse in einem returnUrl-Query-Wert geschickt./sso/logout

Pfade beginnen mit einem Schrägstrich. Groß- und Kleinschreibung spielen keine Rolle.

Eine gefüllte Liste Anmeldepfade lässt alles andere offen. Steht /admin in der Liste, ist nur /admin geschützt, und alle anderen Pfade sind ohne Anmeldung erreichbar. Lassen Sie die Liste leer, um den ganzen Tunnel zu schützen.

Der Abmeldepfad meldet den Besucher nur vom Tunnel ab. Er meldet ihn nicht bei Google, GitHub oder einem anderen Identitätsanbieter ab.

Fehlerbehebung #

„Sie müssen Guthaben kaufen, um diese Funktion zu nutzen.“

SSO benötigt Guthaben. Laden Sie Guthaben auf und speichern Sie dann erneut. Ohne Guthaben können Sie den Dialog weiterhin öffnen und Anmeldung verlangen ausschalten.

„Fügen Sie einen Anbieter hinzu, bevor Sie die Anmeldung einschalten.“

Sie haben noch keinen aktiven Anbieter. Wählen Sie im Dialog Anbieter hinzufügen oder verwenden Sie die Schaltfläche SSO oben auf der HTTP-Seite.

„Schalten Sie mindestens einen Anbieter ein oder die Anmeldung aus.“

Anmeldung verlangen ist eingeschaltet, aber kein Anbieterschalter ist an. Ein Anbieter, den Sie auf inaktiv stellen, wird bei seinen Tunneln ausgeschaltet und nicht mehr aufgelistet.

Die Anmeldeseite meldet „No authentication providers are currently configured for this tunnel.“

Eine Anmeldung ist erforderlich, aber für diesen Tunnel ist kein Anbieter eingeschaltet. Öffnen Sie beim Tunnel SSO-Anbieter › Verwalten und schalten Sie einen ein.

Der Tunnel öffnet sich, ohne eine Anmeldung zu verlangen

Prüfen Sie, ob Anmeldung verlangen eingeschaltet und gespeichert ist. Ist Anmeldepfade gefüllt, sind nur diese Pfade geschützt. Testen Sie außerdem in einem privaten Fenster: Ihr eigener Browser ist möglicherweise noch angemeldet.

„403 - Access Denied“ nach der Anmeldung

Die Anmeldung hat funktioniert, aber eine Regel hat das Konto abgewiesen. Prüfen Sie die E-Mail-Zugriffsregeln des Anbieters und die Listen unter Wer sich anmelden darf des Tunnels. Warten Sie nach einer Korrektur der Regel eine Minute und laden Sie die Seite neu.

Ein Webhook oder API-Client erhält eine Weiterleitung statt einer Antwort

Anfragen ohne das Anmelde-Cookie werden auf die Anmeldeseite umgeleitet. Tragen Sie bei Anmeldepfade nur die Seiten ein, die für Menschen gedacht sind, oder verwenden Sie einen separaten Tunnel für Maschinenverkehr.

Automatisierung #

Anbieter und die SSO-Einstellungen von Tunneln lassen sich auch über die API unter /api/v2/sso-providers und über den MCP-Server verwalten.

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

Support