Authentification unique avec GitLab
Solde requis Tunnels HTTP
Sur cette page 4 sections
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 #
-
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étaire Où la créer Votre utilisateur Sélectionnez votre avatar, puis Edit profile, puis Access › Applications et Add new application. Un groupe Ouvrez 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 GitLab Valeur Name Un nom que vos visiteurs reconnaissent. GitLab l'affiche lorsqu'il leur demande d'autoriser l'application. Redirect URI http://auth.localtonet.com/auth/callbackConfidential Laissez-le sélectionné. Scopes read_userGitLab 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_userdonne 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. -
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.
Champ Valeur Nom du fournisseur N'importe quel nom, par exemple Company GitLab. Vous le voyez dans les paramètres du tunnel.Type de fournisseur GitLab. Changer le type d'un fournisseur enregistré vide Client ID ; saisissez donc de nouveau le client ID et le client secret. Actif Activé Client ID L'Application ID de GitLab. Client secret Le 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.compar le nom d'hôte de votre instance dans les trois premiers champs.GitLab.com
Champ Valeur préremplie Endpoint d'autorisation https://gitlab.com/oauth/authorizeEndpoint de jeton https://gitlab.com/oauth/tokenEndpoint d'informations utilisateur https://gitlab.com/api/v4/userChemin de callback /auth/callback/gitlabAuto-hébergée
Champ Valeur à saisir Endpoint d'autorisation https://<YOUR_GITLAB_HOST>/oauth/authorizeEndpoint de jeton https://<YOUR_GITLAB_HOST>/oauth/tokenEndpoint d'informations utilisateur https://<YOUR_GITLAB_HOST>/api/v4/userChemin 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.
-
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.
-
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.