Modification d’une inscription d’application GitHub

Après avoir inscrit une GitHub App, vous pouvez y apporter des modifications.

Dans cet article

À propos des GitHub App modifications

Vous pouvez modifier votre GitHub App inscription pour modifier les paramètres sélectionnés lors de l’inscription initiale de l’application. Pour plus d’informations sur les paramètres que vous pouvez sélectionner lors de l’inscription d’un GitHub App, consultez Inscription d’une application GitHub.

Par exemple, vous pouvez modifier le nom et la description de votre application, les autorisations accordées à votre application, les webhooks auxquels votre application s’abonne ou la visibilité de votre application.

Vous pouvez également choisir de tester de nouvelles fonctionnalités facultatives pour votre GitHub App. Consultez « Activation des fonctionnalités facultatives pour GitHub Apps ».

Accès à vos GitHub App paramètres

Pour modifier un GitHub App, accédez d’abord à la page des paramètres de l’application.

  1. Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil.

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

    • Pour une application appartenant à un compte personnel, cliquez sur Paramètres.
    • Pour une application appartenant à une organisation :
      1. Cliquez sur Vos organisations.
      2. À droite de l’organisation, cliquez sur Paramètres.
    • Pour une application appartenant à une entreprise :
      1. Cliquez sur Paramètres d’entreprise.

  3. Accédez aux paramètres de l’GitHub App.

    • Pour une application appartenant à un compte personnel ou à une organisation :
      1. Dans la barre latérale gauche, cliquez sur Paramètres du développeur, puis cliquez sur GitHub Apps.
    • Pour une application appartenant à une entreprise :
      1. Dans la barre latérale gauche, cliquez sur Paramètres, puis cliquez sur GitHub Apps.

  4. À droite de GitHub App que vous souhaitez modifier, cliquez sur Modifier.

Modification des informations de base d’un GitHub App

Vous pouvez modifier les informations de base de votre GitHub Appapplication, comme le nom de l’application, la description de l’application et l’URL de la page d’accueil de l’application.

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Sous « Informations de base », modifiez les GitHub App informations que vous souhaitez modifier.
  3. Cliquez sur Save changes.

Demande d’autorisation utilisateur (OAuth) pendant l’installation

Vous pouvez inviter les utilisateurs à autoriser votre GitHub App lorsqu’ils l’installent et à générer un jeton d’accès utilisateur. Lorsque vous demandez une autorisation utilisateur (OAuth) pendant l’installation, vous devez également fournir une URL de rappel où l’utilisateur sera redirigé après avoir autorisé l’installation. Consultez « Génération d’un jeton d’accès utilisateur pour une application GitHub ».

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Sous « Identification et autorisation des utilisateurs », sélectionnez ou désélectionnez Demander l’autorisation utilisateur (OAuth) pendant l’installation.
  3. Sous « URL de rappel », entrez l’URL complète vers laquelle la redirection doit être effectuée, une fois qu’un utilisateur a autorisé l’installation.

Activation ou désactivation du flux d’appareil

Vous pouvez utiliser le flux d’appareil pour autoriser des utilisateurs pour une application sans périphérique de contrôle, par exemple un outil CLI ou un gestionnaire d’informations d’identification Git. Pour plus d’informations sur l’utilisation du flux d’appareil avec GitHub Apps, consultez Génération d’un jeton d’accès utilisateur pour une application GitHub.

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Sous « Identification et autorisation des utilisateurs », sélectionnez ou désélectionnez Activer le flux d’appareil.

Ajout ou mise à jour d’une URL d’installation

Vous pouvez rediriger des personnes vers une URL spécifique après avoir installé votre application. Consultez « Inscription d’une application GitHub ».

Si vous sélectionnez Demander l’autorisation utilisateur (OAuth) pendant l’installation, vous ne pourrez pas saisir d’URL d’installation. Les utilisateurs seront plutôt redirigés vers l’URL de rappel dans le cadre du flux d’autorisation, où vous pouvez décrire une configuration supplémentaire. Consultez « À propos de l’URL de rappel d’autorisation utilisateur ».

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Sous « Post-installation », dans le champ « URL d’installation », entrez l’URL où vous souhaitez rediriger les utilisateurs après l’installation de votre application.
  3. Si vous souhaitez rediriger les utilisateurs vers l’URL de configuration après avoir mis à jour une installation, sélectionnez Rediriger lors de la mise à jour. Une mise à jour comprend l’ajout ou la suppression d’un dépôt pour une installation. Si « URL de configuration » est vide, cette option est ignorée.

Modification des autorisations d’un GitHub App

Vous pouvez modifier les autorisations d’accès accordées à votre GitHub App en suivant les étapes ci-dessous.

Lorsque vous ajoutez de nouveaux référentiels**** pour une application, chaque compte sur lequel l’application est installée doit approuver les nouvelles autorisations. Lorsque vous ajoutez les autorisations de compte pour une application, chaque utilisateur qui a autorisé l’application doit approuver les modifications d’autorisation. Dans les deux cas, GitHub envoie un e-mail à chaque propriétaire ou utilisateur de l’organisation, en les informant de la demande de mise à jour des autorisations de l’application. Les autorisations mises à jour n’entreront pas en vigueur sur une installation ou une autorisation utilisateur tant que les nouvelles autorisations n’auront pas été approuvées. Vous pouvez utiliser le webhook installation pour savoir quand les utilisateurs acceptent de nouvelles autorisations pour votre application.

Si vous supprimez des autorisations ou des webhooks de votre GitHub App, les modifications prendront effet immédiatement. Si vous supprimez les autorisations précédemment accordées à votre application, l’application ne pourra plus accéder à ces ressources.

Si vous modifiez les autorisations d’une application appartenant à une entreprise, les modifications prennent effet immédiatement pour toutes les installations de l’application au sein de l’entreprise si vous êtes propriétaire d’entreprise. Si vous êtes un gestionnaire d’applications, les modifications sont acceptées automatiquement dans les organisations où vous êtes propriétaire de l’organisation.

Les mises à jour ne peuvent pas être acceptées automatiquement si vous ajoutez des autorisations de référentiel à une application pour la première fois. Dans ce cas, chaque propriétaire de l’organisation doit approuver la mise à jour afin qu’il puisse choisir les dépôts auxquels l’application a accès.

La modification des autorisations d’une application peut également modifier les webhooks auxquels votre application peut s’abonner et les actions que votre application peut effectuer avec l’API. Consultez « Choix des autorisations pour une application GitHub ».

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Dans la GitHub Apps barre latérale des paramètres, cliquez sur Autorisations et événements.
  3. Sous les sections « Autorisations de dépôt », « Autorisations d’organisation » et « Autorisations de compte », modifiez les autorisations que vous souhaitez modifier. Pour chaque type d’autorisation, sélectionnez « Lecture seule », « Lecture et écriture » ou « Aucun accès » dans la liste déroulante. Consultez « Choix des autorisations pour une application GitHub ».
  4. Si vous le souhaitez, sous « Ajouter une note aux utilisateurs », ajoutez une note indiquant à vos utilisateurs pourquoi vous modifiez les autorisations que vos GitHub App demandes demandent.
  5. Cliquez sur Save changes.

Activation ou désactivation du GitHub App webhook

Vous pouvez configurer votre GitHub App pour recevoir des webhooks pour des événements spécifiques sur GitHub et déclencher automatiquement des actions en conséquence. Consultez « Utilisation de webhooks avec GitHub Apps ».

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Sous « Webhook », pour activer ou désactiver le webhook, sélectionnez ou désélectionnez Actif.
  3. Si vous avez sélectionné Actif à l’étape précédente, sous « URL du webhook », entrez l’URL à laquelle GitHub envoyer des événements de webhook.
  4. Si vous avez sélectionné Actif à l’étape précédente, sous « Secret de webhook », entrez un jeton secret pour sécuriser vos webhooks. GitHub recommande vivement de définir un secret pour le webhook.

Modification des abonnements aux événements de webhook d’un GitHub App

Vous pouvez modifier les événements webhook auxquels GitHub App est abonné en suivant les étapes ci-dessous.

Les événements webhook spécifiques que vous pouvez sélectionner dans votre inscription d’GitHub App sont déterminés par le type d’autorisations que vous avez sélectionné pour votre application. Vous devez d’abord sélectionner les autorisations que vous souhaitez que votre application dispose, puis vous pouvez abonner votre application aux événements de webhook liés à cet ensemble d’autorisations. Voir Utilisation de webhooks avec GitHub Apps.

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Activez le GitHub App webhook. Consultez Activation ou désactivation du GitHub App webhook dans cet article.
  3. Dans la GitHub Apps barre latérale des paramètres, cliquez sur Autorisations et événements.
  4. Sous les sections « Autorisations de dépôt », « Autorisations d’organisation » et « Autorisations de compte », sélectionnez les autorisations requises pour les événements auxquels votre application s’abonnera. Voir Modification des autorisations d’un GitHub App.
  5. Sous « S’abonner aux événements », sélectionnez les événements webhook que vous souhaitez que votre GitHub App reçoive.
  6. Cliquez sur Save changes.

Modification de la visibilité d’un GitHub App

Vous pouvez modifier les paramètres de visibilité de votre GitHub App pour contrôler qui peut l’installer. Les applications publiques ne peuvent pas être rendues privées si elles sont installées sur d’autres comptes. Consultez « Création d’une application GitHub publique ou privée ».

Vous ne pouvez pas modifier la visibilité d’une GitHub App propriété d’une entreprise. GitHub Apps appartenant à une entreprise ne peut être installé que sur des organisations au sein de l’entreprise.

  1. Accédez à la page Paramètres de l’application que vous souhaitez modifier. Pour plus d’informations, consultez Navigation vers les paramètres de votre GitHub App dans cet article.
  2. Dans la barre latérale de gauche, cliquez sur Avancé.
  3. Sous « Zone danger », en fonction de la visibilité actuelle de votre GitHub App, cliquez sur Rendre public ou Rendre privé.