Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Création d’une application GitHub

Vous pouvez créer et inscrire une application GitHub sous votre compte personnel ou sous toute organisation à laquelle vous avez un accès administratif.

  1. Accédez aux paramètres de votre compte.

    • Pour une GitHub App appartenant à un compte personnel, dans le coin supérieur droit d’une page, cliquez sur votre photo de profil, puis sur Paramètres. Icône Paramètres sur la barre de l’utilisateur
    • Pour une GitHub App appartenant à une organisation, dans le coin supérieur droit d’une page, cliquez sur votre photo de profil, puis sur Vos organisations. Puis, à droite de l’organisation, cliquez sur Paramètres. Vos organisations dans le menu du profil Le bouton Paramètres
  2. Dans la barre latérale gauche, cliquez sur Paramètres de développeur.

  3. Dans la barre latérale gauche, cliquez sur GitHub Apps. Section GitHub Apps

  4. Cliquez sur Nouvelle application GitHub. Bouton de création d’une application GitHub

  5. Dans « Nom de l’application GitHub », tapez le nom de votre application. Champ du nom de votre application GitHub

    Donnez un nom clair et succinct à votre application. Votre application ne peut pas avoir le même nom qu’un compte GitHub existant, sauf s’il s’agit de votre propre nom d’utilisateur ou d’organisation. Une version avec slug du nom de votre application s’affiche dans l’interface utilisateur quand votre intégration effectue une action.

  6. Si vous le souhaitez, dans « Description », tapez une description de votre application qui sera visible par les utilisateurs. Champ de la description de votre application GitHub

  7. Dans « URL de la page d’accueil », tapez l’URL complète du site web de votre application. Champ de l’URL de la page d’accueil de votre application GitHub

  8. Dans « URL de rappel », tapez l’URL complète vers laquelle la redirection doit être effectuée, une fois qu’un utilisateur a autorisé l’installation. Cette URL est utilisée si votre application doit identifier et autoriser les requêtes utilisateur à serveur.

    Vous pouvez utiliser Ajouter une URL de rappel pour fournir des URL de rappel supplémentaires, la limite maximale étant fixée à 10.

    Bouton « Ajouter une URL de rappel » et champ de l’URL de rappel

  9. Par défaut, pour renforcer sa sécurité, votre application utilise des jetons d’autorisation utilisateur ayant un délai d’expiration. Pour refuser l’utilisation de jetons utilisateur ayant un délai d’expiration, vous devez désélectionner « Faire expirer les jetons d’autorisation utilisateur ». Pour en savoir plus sur la configuration d’un flux de jeton d’actualisation et les avantages liés aux jetons utilisateur ayant un délai d’expiration, consultez « Actualisation des jetons d’accès utilisateur à serveur ». Option permettant d’accepter les jetons utilisateur ayant un délai d’expiration durant la configuration des applications GitHub

  10. Si votre application autorise les utilisateurs à l’aide du flux OAuth, vous pouvez sélectionner Demander l’autorisation utilisateur (OAuth) durant l’installation pour permettre aux utilisateurs d’autoriser l’application quand ils l’installent, et ainsi de sauter une étape. Si vous sélectionnez cette option, l’« URL de configuration » cesse d’être disponible, et les utilisateurs sont redirigés vers votre « URL de rappel d’autorisation utilisateur » après l’installation de l’application. Pour plus d’informations, consultez « Autorisation des utilisateurs durant l’installation ». Demander une autorisation utilisateur pendant l’installation

  11. Si votre application GitHub doit utiliser le flux d’appareil pour identifier et autoriser les utilisateurs, cliquez sur Activer le flux d’appareil. Pour plus d’informations sur le flux d’appareil, consultez « Autorisation des applications OAuth ». Capture d’écran montrant le champ d’activation du flux d’appareil

  12. Si une configuration supplémentaire est nécessaire après l’installation, ajoutez une « URL de configuration » vers laquelle les utilisateurs doivent être redirigés après l’installation de votre application. Champ de l’URL de configuration de votre application GitHub

    Remarque : Quand vous sélectionnez Demander l’autorisation utilisateur (OAuth) durant l’installation à l’étape précédente, ce champ cesse d’être disponible, et les utilisateurs sont redirigés vers l’« URL de rappel d’autorisation utilisateur » après l’installation de l’application.

  13. Dans « URL de webhook », tapez l’URL de destination des événements après l’exécution d’une requête POST. Chaque application reçoit son propre webhook, qui vous notifie chaque fois que l’application est installée ou modifiée, et qui vous informe également sur tous les autres événements auxquels l’application est abonnée. Champ de l’URL de webhook de votre application GitHub

  14. Si vous le souhaitez, dans « Secret de webhook », tapez un jeton secret facultatif pour sécuriser vos webhooks. Champ permettant d’ajouter un jeton secret pour votre webhook

    Remarque : Nous vous recommandons vivement de définir un jeton secret. Pour plus d’informations, consultez « Sécurisation de vos webhooks ».

  15. Dans « Autorisations », choisissez les autorisations que votre application doit demander. Pour chaque type d’autorisation, utilisez le menu déroulant, puis cliquez sur Lecture seule, Lecture et écriture ou Aucun accès. Diverses autorisations pour votre application GitHub

  16. Dans « S’abonner aux événements », choisissez les événements que votre application doit recevoir.

  17. Pour choisir l’emplacement d’installation de l’application, sélectionnez Uniquement dans ce compte ou N’importe quel compte. Pour plus d’informations sur les options d’installation, consultez « Rendre une application GitHub publique ou privée ». Options d’installation de votre application GitHub

  18. Cliquez sur Créer une application GitHub. Bouton de création d’une application GitHub