Aller au contenu
Localtonet Localtonet Tableau de bord

Authentification unique avec GitLab

Solde requis Tunnels HTTP

Aide pour cette page
Sur cette page 4 sections
  1. Avant de commencer
  2. Étapes
  3. Créer une application OAuth dans GitLab
  4. Ajouter le fournisseur dans Localtonet
  5. L'activer pour un tunnel
  6. Le tester
  7. Dépannage
  8. Pages associées

Laissez vos visiteurs se connecter avec leur compte GitLab avant de pouvoir ouvrir un tunnel HTTP. Cela fonctionne avec GitLab.com et avec une instance GitLab auto-hébergée. Vous créez une application OAuth dans GitLab, vous l'ajoutez à Localtonet comme fournisseur, puis vous l'activez pour le tunnel.

Avant de commencer #

  • Un tunnel HTTP et du solde sur votre compte. Voir la présentation de l'authentification unique (SSO).
  • Un compte GitLab sur GitLab.com ou sur votre propre instance.
  • Pour une instance auto-hébergée : son adresse doit être joignable depuis internet. Les navigateurs de vos visiteurs ouvrent sa page de connexion, et l'hôte de connexion de Localtonet appelle directement ses endpoints de jeton et d'utilisateur.

Étapes #

  1. Créer une application OAuth dans GitLab #

    Le guide de GitLab lui-même est Configure GitLab as an OAuth 2.0 authentication identity provider. Une application peut appartenir à un utilisateur, à un groupe ou à toute l'instance :

    PropriétaireOù la créer
    Votre utilisateurSélectionnez votre avatar, puis Edit profile, puis Access › Applications et Add new application.
    Un groupeOuvrez le groupe, puis Settings › Applications.
    L'instance (auto-hébergée, administrateurs uniquement)Admin › Applications et New application.

    Remplissez le formulaire et sélectionnez Save application :

    Champ GitLabValeur
    NameUn nom que vos visiteurs reconnaissent. GitLab l'affiche lorsqu'il leur demande d'autoriser l'application.
    Redirect URIhttp://auth.localtonet.com/auth/callback
    ConfidentialLaissez-le sélectionné.
    Scopesread_user

    GitLab affiche ensuite l'Application ID et le Secret. Copiez les deux immédiatement : GitLab n'affiche le secret que juste après la création de l'application.

    Le scope read_user donne un accès en lecture au profil de l'utilisateur connecté via l'endpoint /api/v4/user, qui est l'Endpoint d'informations utilisateur que Localtonet renseigne. C'est le seul scope que demande la connexion ; l'application n'a donc besoin d'aucun autre scope.

  2. Ajouter le fournisseur dans Localtonet #

    Ouvrez Mes tunnels › HTTP et sélectionnez SSO en haut de la page. Dans la boîte de dialogue Fournisseurs SSO, sélectionnez Ajouter un fournisseur.

    ChampValeur
    Nom du fournisseurN'importe quel nom, par exemple Company GitLab. Vous le voyez dans les paramètres du tunnel.
    Type de fournisseurGitLab. Changer le type d'un fournisseur enregistré vide Client ID ; saisissez donc de nouveau le client ID et le client secret.
    ActifActivé
    Client IDL'Application ID de GitLab.
    Client secretLe Secret de GitLab. Il n'est plus jamais affiché après l'enregistrement.

    Ouvrez Endpoints et callback. Les adresses de GitLab.com sont renseignées automatiquement. Pour une instance auto-hébergée, remplacez gitlab.com par le nom d'hôte de votre instance dans les trois premiers champs.

    GitLab.com

    ChampValeur préremplie
    Endpoint d'autorisationhttps://gitlab.com/oauth/authorize
    Endpoint de jetonhttps://gitlab.com/oauth/token
    Endpoint d'informations utilisateurhttps://gitlab.com/api/v4/user
    Chemin de callback/auth/callback/gitlab

    Auto-hébergée

    ChampValeur à saisir
    Endpoint d'autorisationhttps://<YOUR_GITLAB_HOST>/oauth/authorize
    Endpoint de jetonhttps://<YOUR_GITLAB_HOST>/oauth/token
    Endpoint d'informations utilisateurhttps://<YOUR_GITLAB_HOST>/api/v4/user
    Chemin de callback/auth/callback/gitlab (inchangé)

    Le Redirect URI de l'application GitLab reste l'adresse Localtonet de l'étape 1. Il ne contient pas votre hôte GitLab.

    Renseignez éventuellement les Règles d'accès par e-mail, puis sélectionnez Enregistrer le fournisseur.

  3. L'activer pour un tunnel #

    Sous Vos tunnels, sélectionnez Paramètres sur le tunnel, puis Gérer à côté de Fournisseurs SSO. Dans la boîte de dialogue Authentification unique, activez Exiger une connexion et l'interrupteur de votre fournisseur GitLab. Sélectionnez Enregistrer.

    Sur GitLab.com, tout le monde peut créer un compte. Sans règle, tout utilisateur de GitLab.com qui connaît l'adresse peut ouvrir le tunnel. Renseignez Qui peut se connecter sur le tunnel, ou Domaines e-mail autorisés sur le fournisseur. Les listes sont expliquées dans la présentation.

  4. Le tester #

    Ouvrez l'URL du tunnel dans une fenêtre de navigation privée. Localtonet affiche Sign in to continue avec un bouton pour votre fournisseur. GitLab vous demande d'autoriser l'application la première fois. Ensuite, vous êtes renvoyé vers le tunnel et votre service se charge.

Dépannage #

GitLab indique que l'URI de redirection incluse n'est pas valide

Aucun Redirect URI de l'application GitLab ne correspond à l'adresse envoyée. Saisissez exactement http://auth.localtonet.com/auth/callback comme Redirect URI de l'application.

GitLab indique que le scope demandé est invalide, inconnu ou mal formé

Un scope demandé n'est pas sélectionné dans l'application GitLab. Modifiez l'application et sélectionnez read_user.

GitLab indique que l'authentification du client a échoué

Le Client ID ou le Client secret enregistré dans Localtonet ne correspond pas à l'application GitLab. Collez de nouveau l'Application ID et le Secret et sélectionnez Enregistrer le fournisseur. Si vous renouvelez le secret dans GitLab, l'application cesse de fonctionner tant que vous n'avez pas enregistré le nouveau secret dans Localtonet.

La connexion avec une instance auto-hébergée n'aboutit jamais

Vérifiez qu'il n'y a pas de faute de frappe dans les trois endpoints et assurez-vous que l'instance répond depuis internet. Si elle utilise HTTPS, elle a besoin d'un certificat auquel les clients publics font confiance. Une instance accessible uniquement à l'intérieur de votre réseau ne peut pas être utilisée.

« 403 - Access Denied » après une connexion GitLab réussie

Une règle de Localtonet a refusé le compte. Vérifiez les Règles d'accès par e-mail du fournisseur et Qui peut se connecter sur le tunnel. Après avoir corrigé une règle, attendez une minute et rechargez la page.

Il n'y a pas de bouton GitLab sur la page de connexion

Le fournisseur n'est pas activé pour ce tunnel, ou il est défini comme inactif. Vérifiez les deux.

Support