Naar de inhoud
Localtonet Localtonet Dashboard

Single sign-on met GitLab

Saldo vereist HTTP-tunnels

Hulp bij deze pagina
Op deze pagina 4 secties
  1. Voordat je begint
  2. Stappen
  3. Maak een OAuth-applicatie in GitLab
  4. Voeg de provider toe in Localtonet
  5. Zet hem aan voor een tunnel
  6. Test het
  7. Probleemoplossing
  8. Gerelateerde pagina's

Laat bezoekers inloggen met hun GitLab-account voordat ze een HTTP-tunnel kunnen openen. Het werkt met GitLab.com en met een zelfbeheerde GitLab-instantie. Je maakt een OAuth-applicatie in GitLab, voegt die als provider toe aan Localtonet en zet hem daarna aan voor de tunnel.

Voordat je begint #

  • Een HTTP-tunnel en Saldo op je account. Zie het overzicht van Single sign-on.
  • Een GitLab-account op GitLab.com of op je eigen instantie.
  • Voor een zelfbeheerde instantie: het adres moet vanaf internet bereikbaar zijn. De browsers van je bezoekers openen de aanmeldpagina ervan, en de aanmeldhost van Localtonet roept de token- en gebruikersinfo-endpoints rechtstreeks aan.

Stappen #

  1. Maak een OAuth-applicatie in GitLab #

    De eigen handleiding van GitLab is Configure GitLab as an OAuth 2.0 authentication identity provider. Een applicatie kan van een gebruiker, een groep of de hele instantie zijn:

    EigenaarWaar je hem maakt
    Jouw gebruikerKies je avatar, dan Edit profile, dan Access › Applications en Add new application.
    Een groepOpen de groep, dan Settings › Applications.
    De instantie (zelfbeheerd, alleen voor beheerders)Admin › Applications en New application.

    Vul het formulier in en kies Save application:

    GitLab-veldWaarde
    NameEen naam die je bezoekers herkennen. GitLab toont hem wanneer het hen om autorisatie vraagt.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialLaat dit geselecteerd.
    Scopesread_user

    GitLab toont dan de Application ID en het Secret. Kopieer beide meteen: GitLab toont het secret alleen direct nadat de applicatie is gemaakt.

    De scope read_user geeft leestoegang tot het profiel van de ingelogde gebruiker via het endpoint /api/v4/user, dat is het Gebruikersinfo-endpoint dat Localtonet invult. Het is de enige scope die de aanmelding aanvraagt, dus de applicatie heeft geen andere scope nodig.

  2. Voeg de provider toe in Localtonet #

    Open Mijn tunnels › HTTP en kies bovenaan de pagina SSO. Kies in het dialoogvenster SSO-providers Provider toevoegen.

    VeldWaarde
    ProvidernaamEen willekeurige naam, bijvoorbeeld Company GitLab. Je ziet hem in de tunnelinstellingen.
    ProvidertypeGitLab. Als je het type van een opgeslagen provider wijzigt, wordt Client-ID leeggemaakt, dus voer de client-ID en het clientgeheim opnieuw in.
    ActiefAan
    Client-IDDe Application ID van GitLab.
    ClientgeheimHet Secret van GitLab. Het wordt na het opslaan nooit meer getoond.

    Open Endpoints & callback. De adressen van GitLab.com worden automatisch ingevuld. Vervang bij een zelfbeheerde instantie gitlab.com in de eerste drie velden door de hostnaam van je instantie.

    GitLab.com

    VeldIngevulde waarde
    Autorisatie-endpointhttps://gitlab.com/oauth/authorize
    Token-endpointhttps://gitlab.com/oauth/token
    Gebruikersinfo-endpointhttps://gitlab.com/api/v4/user
    Callbackpad/auth/callback/gitlab

    Zelfbeheerd

    VeldWaarde om in te voeren
    Autorisatie-endpointhttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Token-endpointhttps://<YOUR_GITLAB_HOST>/oauth/token
    Gebruikersinfo-endpointhttps://<YOUR_GITLAB_HOST>/api/v4/user
    Callbackpad/auth/callback/gitlab (ongewijzigd)

    De Redirect URI in de GitLab-applicatie blijft het Localtonet-adres uit stap 1. Hij bevat je GitLab-host niet.

    Vul eventueel Toegangsregels voor e-mail in en kies dan Provider opslaan.

  3. Zet hem aan voor een tunnel #

    Kies onder Je tunnels Instellingen bij de tunnel en dan Beheren naast SSO-providers. Zet in het dialoogvenster Single sign-on Inloggen vereisen en de schakelaar van je GitLab-provider aan. Kies Opslaan.

    Op GitLab.com kan iedereen een account maken. Zonder regel kan elke GitLab.com-gebruiker die het adres kent de tunnel openen. Vul Wie kan inloggen in bij de tunnel, of Toegestane e-maildomeinen bij de provider. De lijsten worden uitgelegd in het overzicht.

  4. Test het #

    Open de tunnel-URL in een privévenster van de browser. Localtonet toont Sign in to continue met een knop voor je provider. GitLab vraagt je de eerste keer de applicatie te autoriseren. Daarna word je teruggestuurd naar de tunnel en laadt je service.

Probleemoplossing #

GitLab zegt dat de opgenomen redirect-URI niet geldig is

Geen Redirect URI van de GitLab-applicatie komt overeen met het adres dat is verzonden. Voer exact http://auth.localtonet.com/auth/callback in als Redirect URI van de applicatie.

GitLab zegt dat de gevraagde scope ongeldig, onbekend of misvormd is

Een scope die is aangevraagd, is niet geselecteerd in de GitLab-applicatie. Bewerk de applicatie en selecteer read_user.

GitLab zegt dat de clientauthenticatie is mislukt

De Client-ID of het Clientgeheim dat in Localtonet is opgeslagen, komt niet overeen met de GitLab-applicatie. Plak de Application ID en het Secret opnieuw en kies Provider opslaan. Als je het secret in GitLab vernieuwt, werkt de applicatie niet meer totdat je het nieuwe secret in Localtonet opslaat.

Aanmelden met een zelfbeheerde instantie wordt nooit voltooid

Controleer de drie endpoints op typefouten en zorg dat de instantie vanaf internet antwoordt. Als hij HTTPS gebruikt, heeft hij een certificaat nodig dat publieke clients vertrouwen. Een instantie die alleen binnen je netwerk bereikbaar is, kan niet worden gebruikt.

"403 - Access Denied" na een geslaagde GitLab-aanmelding

Een regel van Localtonet heeft het account geweigerd. Controleer Toegangsregels voor e-mail bij de provider en Wie kan inloggen bij de tunnel. Wacht na het corrigeren van een regel een minuut en laad opnieuw.

Er is geen GitLab-knop op de aanmeldpagina

De provider is niet aangezet voor deze tunnel, of staat op inactief. Controleer beide.

Support