Zum Inhalt springen
Localtonet Localtonet Dashboard

Single Sign-On mit GitLab

Guthaben erforderlich HTTP-Tunnel

Hilfe zu dieser Seite
Auf dieser Seite 4 Abschnitte
  1. Bevor Sie beginnen
  2. Schritte
  3. Eine OAuth-Anwendung in GitLab erstellen
  4. Den Anbieter in Localtonet hinzufügen
  5. Für einen Tunnel einschalten
  6. Testen
  7. Fehlerbehebung
  8. Verwandte Seiten

Lassen Sie Besucher sich mit ihrem GitLab-Konto anmelden, bevor sie einen HTTP-Tunnel öffnen können. Es funktioniert mit GitLab.com und mit einer selbst betriebenen GitLab-Instanz. Sie erstellen in GitLab eine OAuth-Anwendung, fügen sie in Localtonet als Anbieter hinzu und schalten sie dann für den Tunnel ein.

Bevor Sie beginnen #

  • Ein HTTP-Tunnel und Guthaben auf Ihrem Konto. Siehe die Single-Sign-On-Übersicht.
  • Ein GitLab-Konto auf GitLab.com oder auf Ihrer eigenen Instanz.
  • Bei einer selbst betriebenen Instanz: Ihre Adresse muss aus dem Internet erreichbar sein. Die Browser Ihrer Besucher öffnen ihre Anmeldeseite, und der Anmelde-Host von Localtonet ruft ihre Token- und Benutzer-Endpunkte direkt auf.

Schritte #

  1. Eine OAuth-Anwendung in GitLab erstellen #

    Die eigene Anleitung von GitLab ist Configure GitLab as an OAuth 2.0 authentication identity provider. Eine Anwendung kann einem Benutzer, einer Gruppe oder der gesamten Instanz gehören:

    EigentümerWo sie erstellt wird
    Ihr BenutzerWählen Sie Ihren Avatar, dann Edit profile, dann Access › Applications und Add new application.
    Eine GruppeÖffnen Sie die Gruppe, dann Settings › Applications.
    Die Instanz (selbst betrieben, nur Administratoren)Admin › Applications und New application.

    Füllen Sie das Formular aus und wählen Sie Save application:

    GitLab-FeldWert
    NameEin Name, den Ihre Besucher wiedererkennen. GitLab zeigt ihn an, wenn es sie um die Autorisierung bittet.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialLassen Sie es ausgewählt.
    Scopesread_user

    GitLab zeigt dann die Application ID und das Secret an. Kopieren Sie beides sofort: GitLab zeigt das Secret nur unmittelbar nach dem Erstellen der Anwendung an.

    Der Scope read_user gewährt Lesezugriff auf das Profil des angemeldeten Benutzers über den Endpunkt /api/v4/user, der dem Userinfo-Endpunkt entspricht, den Localtonet einträgt. Es ist der einzige Scope, den die Anmeldung anfordert, die Anwendung braucht also keinen anderen.

  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 GitLab. Sie sehen ihn in den Tunneleinstellungen.
    AnbietertypGitLab. Wenn Sie den Typ eines gespeicherten Anbieters ändern, wird die Client-ID geleert; geben Sie die Client-ID und das Client-Secret daher erneut ein.
    AktivEin
    Client-IDDie Application ID aus GitLab.
    Client-SecretDas Secret aus GitLab. Es wird nach dem Speichern nie wieder angezeigt.

    Öffnen Sie Endpunkte & Callback. Die Adressen von GitLab.com werden automatisch eingetragen. Ersetzen Sie bei einer selbst betriebenen Instanz gitlab.com in den ersten drei Feldern durch den Hostnamen Ihrer Instanz.

    GitLab.com

    FeldEingetragener Wert
    Autorisierungs-Endpunkthttps://gitlab.com/oauth/authorize
    Token-Endpunkthttps://gitlab.com/oauth/token
    Userinfo-Endpunkthttps://gitlab.com/api/v4/user
    Callback-Pfad/auth/callback/gitlab

    Selbst betrieben

    FeldEinzutragender Wert
    Autorisierungs-Endpunkthttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Token-Endpunkthttps://<YOUR_GITLAB_HOST>/oauth/token
    Userinfo-Endpunkthttps://<YOUR_GITLAB_HOST>/api/v4/user
    Callback-Pfad/auth/callback/gitlab (unverändert)

    Die Redirect URI in der GitLab-Anwendung bleibt die Localtonet-Adresse aus Schritt 1. Sie enthält Ihren GitLab-Host nicht.

    Füllen Sie optional die 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 Verwalten neben SSO-Anbieter. Schalten Sie im Dialog Single Sign-On die Option Anmeldung verlangen und den Schalter Ihres GitLab-Anbieters ein. Wählen Sie Speichern.

    Bei GitLab.com kann jeder ein Konto erstellen. Ohne Regel kann jeder GitLab.com-Benutzer, der die Adresse kennt, den Tunnel öffnen. Füllen Sie Wer sich anmelden darf beim Tunnel oder Erlaubte E-Mail-Domains beim Anbieter aus. Die Listen 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. GitLab bittet Sie beim ersten Mal, die Anwendung zu autorisieren. Danach werden Sie zum Tunnel zurückgeleitet, und Ihr Dienst wird geladen.

Fehlerbehebung #

GitLab meldet, die angegebene Redirect URI sei ungültig

Keine Redirect URI der GitLab-Anwendung stimmt mit der gesendeten Adresse überein. Tragen Sie genau http://auth.localtonet.com/auth/callback als Redirect URI der Anwendung ein.

GitLab meldet, der angeforderte Scope sei ungültig, unbekannt oder fehlerhaft

Ein angeforderter Scope ist in der GitLab-Anwendung nicht ausgewählt. Bearbeiten Sie die Anwendung und wählen Sie read_user.

GitLab meldet, die Client-Authentifizierung sei fehlgeschlagen

Die in Localtonet gespeicherte Client-ID oder das Client-Secret stimmt nicht mit der GitLab-Anwendung überein. Fügen Sie die Application ID und das Secret erneut ein und wählen Sie Anbieter speichern. Wenn Sie das Secret in GitLab erneuern, funktioniert die Anwendung nicht mehr, bis Sie das neue Secret in Localtonet speichern.

Die Anmeldung mit einer selbst betriebenen Instanz wird nie abgeschlossen

Prüfen Sie die drei Endpunkte auf Tippfehler und stellen Sie sicher, dass die Instanz aus dem Internet antwortet. Verwendet sie HTTPS, braucht sie ein Zertifikat, dem öffentliche Clients vertrauen. Eine Instanz, die nur innerhalb Ihres Netzwerks erreichbar ist, kann nicht verwendet werden.

„403 - Access Denied“ nach erfolgreicher GitLab-Anmeldung

Eine Localtonet-Regel hat das Konto abgelehnt. Prüfen Sie die E-Mail-Zugriffsregeln beim Anbieter und Wer sich anmelden darf beim Tunnel. Warten Sie nach der Korrektur einer Regel eine Minute und laden Sie die Seite neu.

Auf der Anmeldeseite gibt es keine GitLab-Schaltfläche

Der Anbieter ist für diesen Tunnel nicht eingeschaltet oder auf inaktiv gesetzt. Prüfen Sie beides.

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

Support