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.
All products
Applications

Cette version de GitHub Enterprise a été abandonnée le 2023-03-15. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

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. Paramètres de développeur 1. Dans la barre latérale gauche, cliquez sur GitHub Apps. Section GitHub Apps

  3. Cliquez sur Nouvelle application GitHub.

  4. Dans « Nom de l’application GitHub », tapez le nom de votre application.

    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.

  5. Si vous le souhaitez, sous « Description », tapez une description de votre application qui sera visible par les utilisateurs.

  6. Sous « URL de la page d’accueil », tapez l’URL complète du site web de votre application.

  7. 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 le bouton Ajouter une URL de rappel pour fournir des URL de rappel supplémentaires, la limite maximale étant fixée à 10.

  8. 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 « Refreshing user access tokens ».

  9. 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 « Installation des applications GitHub ».

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

    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.

  11. Sous « 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.

  12. Si vous le souhaitez, sous « Secret de webhook », tapez un jeton secret facultatif pour sécuriser vos webhooks.

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

  13. Sous « Autorisations », choisissez les autorisations que votre application doit demander. Pour chaque type d’autorisation, sélectionnez le menu déroulant, puis cliquez sur Lecture seule, Lecture et écriture ou Aucun accès.

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

  15. 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, voir « Making a GitHub App public or private ».

  16. Cliquez sur Créer une application GitHub.