Single Sign-On mit GitLab
Guthaben erforderlich HTTP-Tunnel
Auf dieser Seite 4 Abschnitte
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 #
-
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ümer Wo sie erstellt wird Ihr Benutzer Wä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-Feld Wert Name Ein Name, den Ihre Besucher wiedererkennen. GitLab zeigt ihn an, wenn es sie um die Autorisierung bittet. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Lassen Sie es ausgewählt. Scopes read_userGitLab 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_usergewä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. -
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 GitLab. Sie sehen ihn in den Tunneleinstellungen.Anbietertyp GitLab. 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. Aktiv Ein Client-ID Die Application ID aus GitLab. Client-Secret Das 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.comin den ersten drei Feldern durch den Hostnamen Ihrer Instanz.GitLab.com
Feld Eingetragener Wert Autorisierungs-Endpunkt https://gitlab.com/oauth/authorizeToken-Endpunkt https://gitlab.com/oauth/tokenUserinfo-Endpunkt https://gitlab.com/api/v4/userCallback-Pfad /auth/callback/gitlabSelbst betrieben
Feld Einzutragender Wert Autorisierungs-Endpunkt https://<YOUR_GITLAB_HOST>/oauth/authorizeToken-Endpunkt https://<YOUR_GITLAB_HOST>/oauth/tokenUserinfo-Endpunkt https://<YOUR_GITLAB_HOST>/api/v4/userCallback-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.
-
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.
-
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.