Ajouter la connexion GitHub à votre application

Découvrez comment ajouter l’option Se connecter avec GitHub à votre application à l’aide d’Auth0. Configurez une connexion sociale GitHub avec OAuth 2.0 pour permettre aux utilisateurs de s’authentifier avec leurs comptes GitHub.

Auth0 prend en charge l’authentification avec GitHub, ce qui permet à vos utilisateurs de s’authentifier avec leurs comptes GitHub au moyen de OAuth 2.0. Ajouter GitHub comme option de connexion sociale offre une expérience de connexion rapide et familière aux développeurs et aux utilisateurs techniques.

Pour configurer cette connexion, commencez par enregistrer une application OAuth dans GitHub, puis configurez la connexion dans l’Auth0 Dashboard à l’aide des identifiants fournis par GitHub.

Avant de commencer

Avant de configurer GitHub comme connexion sociale, vous devez disposer des éléments suivants :

1. Un compte Auth0. Si vous n’en avez pas, vous pouvez vous inscrire gratuitement.
2. Un compte GitHub.
3. Une application enregistrée dans l’Auth0 Dashboard.

​

Configurer GitHub

Créez une application OAuth sur GitHub pour générer les identifiants dont Auth0 a besoin pour établir la connexion.

1. Ouvrir les paramètres développeur de GitHub

   Connectez-vous à votre compte GitHub. Sélectionnez votre photo de profil dans le coin supérieur droit, puis sélectionnez Settings. Dans la barre latérale de gauche, sélectionnez Developer settings, puis OAuth Apps.

2. Enregistrer une nouvelle application OAuth

   Sélectionnez New OAuth App. Si vous n’avez encore créé aucune application, sélectionnez Register a new application.

   Remplissez les champs suivants :

   Champ	Valeur
   Nom de l’application	Un nom que vos utilisateurs reconnaîtront et auquel ils feront confiance, par exemple My App (Auth0)
   URL de la page d’accueil	L’URL complète de la page d’accueil de votre application, par exemple https://myapp.example.com
   Description de l’application	(Facultatif) Une description affichée à tous les utilisateurs de votre application
   URL de rappel d’autorisation	https://YOUR_AUTH0_DOMAIN/login/callback

   Remplacez YOUR_AUTH0_DOMAIN par le domaine de votre locataire Auth0. Vous trouverez cette valeur dans Auth0 Dashboard > Applications > Applications, sous l’onglet Settings.

   Vous pouvez laisser Enable Device Flow décoché, sauf si votre application doit prendre en charge l’autorisation sur appareil.

   Sélectionnez Register application.

3. Copier l'ID client et le Secret client

   Après l’enregistrement, GitHub affiche la page des détails de l’application. Copiez la valeur de ID client.

   Sélectionnez Generate a new client secret pour créer un secret. Copiez immédiatement la valeur générée.

   GitHub n’affiche le Secret client qu’une seule fois. Conservez-le en lieu sûr avant de quitter la page. Si vous le perdez, vous devrez en générer un nouveau.

​

Configurer Auth0

Ajoutez la connexion GitHub à votre locataire Auth0 et entrez les identifiants de la section précédente.

1. Créer une connexion GitHub

   Accédez à Auth0 Dashboard > Authentication > Social et sélectionnez Create Connection. Sélectionnez GitHub dans la liste des fournisseurs.

2. Sélectionner l’objectif de la connexion

   Sous Purpose, indiquez comment cette connexion sera utilisée : pour la connexion, les comptes liés ou les deux.

3. Entrer vos identifiants GitHub

   Dans General, entrez l’ID client et le Secret client que vous avez copiés depuis GitHub.

4. Sélectionner les autorisations

   Sous Permissions, sélectionnez les autorisations dont votre application a besoin. La plupart des applications nécessitent Email address pour le courriel de l’utilisateur et Read user pour les renseignements du profil.

5. Enregistrer et activer la connexion

   Sélectionnez Create pour enregistrer la connexion.

   Sélectionnez l’onglet Applications et activez la connexion pour les applications qui doivent proposer la connexion avec GitHub.

​

Tester la connexion

Vérifiez que la connexion GitHub fonctionne avant de la déployer en production.

1. Accédez à Auth0 Dashboard > Authentication > Social.
2. Sélectionnez la connexion GitHub dans la liste.
3. Sélectionnez Essayer la connexion.
4. Authentifiez-vous avec votre compte GitHub lorsque vous y êtes invité.
5. Confirmez qu’Auth0 renvoie les données du profil de l’utilisateur, y compris son nom d’utilisateur GitHub et son adresse de courriel.

​

Pour en savoir plus

• Ajouter la connexion Google à votre application
• Tester les connexions sociales à l’aide des clés de développeur Auth0
• Créer des connexions sociales personnalisées