> ## Documentation Index
> Fetch the complete documentation index at: https://translations.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 <Tooltip tip="OAuth 2.0 : cadre d’autorisation qui définit les protocoles et les flux de travail d’autorisation." cta="Voir le glossaire" href="/fr-CA/docs/glossary?term=OAuth+2.0">OAuth 2.0</Tooltip>. 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.

<Card title="Avant de commencer">
  Avant de configurer GitHub comme connexion sociale, vous devez disposer des éléments suivants :

  1. Un [compte Auth0](https://auth0.com/signup). Si vous n’en avez pas, vous pouvez vous inscrire gratuitement.
  2. Un [compte GitHub](https://github.com/signup).
  3. Une application enregistrée dans l’[Auth0 Dashboard](https://manage.auth0.com/#/applications).
</Card>

<div id="configure-github">
  ## Configurer GitHub
</div>

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

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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](https://manage.auth0.com/#/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**.
  </Step>

  <Step title="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.

    <Callout icon="file-lines" color="#0EA5E9" iconType="regular">
      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.
    </Callout>
  </Step>
</Steps>

<div id="configure-auth0">
  ## Configurer Auth0
</div>

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

<Steps>
  <Step title="Créer une connexion GitHub">
    Accédez à [Auth0 Dashboard > Authentication > Social](https://manage.auth0.com/#/social) et sélectionnez **Create Connection**. Sélectionnez **GitHub** dans la liste des fournisseurs.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Entrer vos identifiants GitHub">
    Dans **General**, entrez l’**ID client** et le **Secret client** que vous avez copiés depuis GitHub.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

<div id="test-the-connection">
  ## Tester la connexion
</div>

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

1. Accédez à [Auth0 Dashboard > Authentication > Social](https://manage.auth0.com/#/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.

<div id="keep-reading">
  ## Pour en savoir plus
</div>

* [Ajouter la connexion Google à votre application](/fr-CA/docs/authenticate/identity-providers/social-identity-providers/google)
* [Tester les connexions sociales à l’aide des clés de développeur Auth0](/fr-CA/docs/authenticate/identity-providers/social-identity-providers/devkeys)
* [Créer des connexions sociales personnalisées](/fr-CA/docs/authenticate/identity-providers/social-identity-providers/oauth2)