Aller au contenu
Localtonet Localtonet Tableau de bord

Authentification unique avec GitHub

Solde requis Tunnels HTTP

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

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 #

  1. Enregistrer une application OAuth sur GitHub #

    Le guide de GitHub est Creating an OAuth app. En bref :

    1. Sur GitHub, ouvrez le menu sous votre photo de profil et sélectionnez Settings, puis Developer settings, puis OAuth apps.
    2. Sélectionnez New OAuth App. Si vous n'avez pas encore d'application, le bouton s'intitule Register a new application.
    3. Remplissez le formulaire avec les valeurs ci-dessous et sélectionnez Register application.
    4. 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 GitHubValeur
    Application nameUn nom que vos visiteurs reconnaissent. GitHub l'affiche lorsqu'il leur demande d'autoriser l'application.
    Homepage URLUne adresse web qui décrit l'application, par exemple votre site web.
    Authorization callback URLhttp://auth.localtonet.com/auth/callback
    Enable Device FlowLaissez-le désactivé.

    Vous ne sélectionnez pas de scopes sur GitHub. La requête de connexion les nomme : read:user et user:email. GitHub demande au visiteur de les approuver lors de sa première connexion.

  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 GitHub. Vous le voyez dans les paramètres du tunnel.
    Type de fournisseurGitHub. Changer le type d'un fournisseur enregistré vide Client ID ; saisissez donc à nouveau l'ID client et le secret client.
    ActifActivé
    Client IDL'ID client fourni par GitHub.
    Client secretLe 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 :

    ChampValeur préremplie
    Endpoint d'autorisationhttps://github.com/login/oauth/authorize
    Endpoint de jetonhttps://github.com/login/oauth/access_token
    Endpoint d'informations utilisateurhttps://api.github.com/user
    Chemin de callback/auth/callback/github

    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 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.

  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. 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.

Support