> ## 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 avec GitHub à votre application

> Découvrez comment ajouter la connexion 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 leur compte GitHub.

Auth0 prend en charge la connexion avec GitHub, ce qui permet à vos utilisateurs de s’authentifier avec leur compte GitHub par l’entremise de <Tooltip tip="OAuth 2.0 : cadre d’autorisation qui définit les protocoles et les flux d’autorisation." cta="Voir le glossaire" href="/docs/fr-ca/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, vous devez enregistrer une application OAuth dans GitHub, puis configurer 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 avez besoin de :

  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 de développeur GitHub">
    Connectez-vous à votre compte GitHub. Sélectionnez votre photo de profil dans le coin supérieur droit, puis sélectionnez **Paramètres**. Dans la barre latérale gauche, sélectionnez **Paramètres développeur**, puis **Applications OAuth**.
  </Step>

  <Step title="Enregistrer une nouvelle application OAuth">
    Sélectionnez **Nouvelle application OAuth**. Si vous n’avez encore créé aucune application, sélectionnez **Enregistrer une nouvelle 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 tenant Auth0. Vous trouverez cette valeur dans [Auth0 Dashboard > Applications > Applications](https://manage.auth0.com/#/applications), sous l’onglet **Paramètres**.

    Vous pouvez laisser **Activer Device Flow** décoché, sauf si votre application exige une autorisation basée sur un appareil.

    Sélectionnez **Enregistrer l’application**.
  </Step>

  <Step title="Copier le Client ID et le Client Secret">
    Après l’enregistrement, GitHub affiche la page des détails de l’application. Copiez la valeur **Client ID**.

    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 Client Secret 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 tenant 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’usage de la connexion">
    Sous **Purpose**, précisez comment cette connexion sera utilisée : pour la connexion, les comptes connectés ou les deux.
  </Step>

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

  <Step title="Sélectionner les permissions">
    Sous **Permissions**, sélectionnez les permissions dont votre application a besoin. La plupart des applications ont besoin de **adresse courriel** pour l’adresse courriel et de **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 **Try Connection**.
4. Authentifiez-vous avec votre compte GitHub lorsque le système vous le demande.
5. Confirmez qu’Auth0 renvoie les données du profil utilisateur, y compris le nom d’utilisateur GitHub et son adresse courriel.

<div id="keep-reading">
  ## Poursuivez votre lecture
</div>

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