Authentification unique avec GitHub
Solde requis Tunnels HTTP
Sur cette page 4 sections
Permettez aux visiteurs de se connecter avec leur compte GitHub avant de pouvoir ouvrir un tunnel HTTP. Vous enregistrez une application OAuth sur GitHub, 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. Consultez la présentation de l'authentification unique (SSO).
- Un compte GitHub. Pour enregistrer l'application pour une organisation, vous avez besoin d'un accès aux paramètres de cette organisation.
Étapes #
-
Enregistrer une application OAuth sur GitHub #
Le guide de GitHub est Creating an OAuth app. En bref :
- Sur GitHub, ouvrez le menu sous votre photo de profil et sélectionnez Settings, puis Developer settings, puis OAuth apps.
- Sélectionnez New OAuth App. Si vous n'avez pas encore d'application, le bouton s'intitule Register a new application.
- Remplissez le formulaire avec les valeurs ci-dessous et sélectionnez Register application.
- Sur la page de la nouvelle application, copiez le Client ID, puis sélectionnez Generate a new client secret et copiez tout de suite le secret.
Champ GitHub Valeur Application name Un nom que vos visiteurs reconnaissent. GitHub l'affiche lorsqu'il leur demande d'autoriser l'application. Homepage URL Une adresse web qui décrit l'application, par exemple votre site web. Authorization callback URL http://auth.localtonet.com/auth/callbackEnable Device Flow Laissez-le désactivé. Vous ne sélectionnez pas de scopes sur GitHub. La requête de connexion les nomme :
read:useretuser:email. GitHub demande au visiteur de les approuver lors de sa première connexion. -
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 GitHub. Vous le voyez dans les paramètres du tunnel.Type de fournisseur GitHub. Changer le type d'un fournisseur enregistré vide Client ID ; saisissez donc à nouveau l'ID client et le secret client. Actif Activé Client ID L'ID client fourni par GitHub. Client secret Le secret client fourni par GitHub. Il n'est jamais affiché après l'enregistrement. Sous Endpoints et callback, les adresses GitHub standard sont renseignées automatiquement. Laissez-les telles quelles :
Champ Valeur préremplie Endpoint d'autorisation https://github.com/login/oauth/authorizeEndpoint de jeton https://github.com/login/oauth/access_tokenEndpoint d'informations utilisateur https://api.github.com/userChemin de callback /auth/callback/githubRenseignez é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 GitHub. Sélectionnez Enregistrer.
N'importe qui peut créer un compte GitHub. Sans règle, tout utilisateur GitHub 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. GitHub vous demande d'autoriser l'application la première fois. Ensuite, vous êtes renvoyé vers le tunnel et votre service se charge.
Dépannage #
GitHub signale une incohérence de l'URI de redirection
L'erreur de GitHub est redirect_uri_mismatch : « The redirect_uri MUST match the registered callback URL for this application. » Aucune URL de callback de l'application OAuth ne correspond à l'adresse envoyée. Définissez Authorization callback URL sur GitHub exactement à http://auth.localtonet.com/auth/callback.
Un visiteur est refusé alors que son adresse figure dans la liste
L'Endpoint d'informations utilisateur par défaut, https://api.github.com/user, peut ne renvoyer aucune adresse e-mail lorsque l'utilisateur GitHub n'a pas défini d'e-mail public dans son profil. Demandez au visiteur de vérifier quelle adresse est définie comme e-mail public dans son profil GitHub, et comparez-la à vos listes.
« 403 - Access Denied » après une connexion GitHub réussie
Une règle 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, patientez une minute et rechargez la page.
La connexion échoue avant ou après la page d'autorisation de GitHub
Comparez le Client ID et le Client secret enregistrés dans Localtonet avec l'application OAuth. Collez à nouveau le Client ID, générez un nouveau secret client sur GitHub, collez-le dans le fournisseur et sélectionnez Enregistrer le fournisseur.
Il n'y a pas de bouton GitHub 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.