À propos des modifications pour une GitHub App
Vous pouvez modifier votre GitHub App pour modifier les paramètres sélectionnés lors de la création de l’application. Pour plus d’informations sur les paramètres que vous pouvez sélectionner pendant la création d’une GitHub App, consultez « Création 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.
Navigation vers les paramètres de votre GitHub App
Pour modifier une GitHub App, accédez d’abord à la page des paramètres de l’application.
- 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.
- 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.
- Dans la barre latérale gauche, cliquez sur Paramètres de développeur.
- Dans la barre latérale de gauche, cliquez sur GitHub App . 1. À droite de GitHub App que vous souhaitez modifier, cliquez sur Modifier.
Modification des informations de base d’une GitHub App
Vous pouvez modifier les informations de base de votre GitHub App, comme le nom de l’application, la description de l’application et l’URL de la page d’accueil de l’application.
- 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.
- Sous « Informations de base », modifiez les informations de l’GitHub App que vous souhaitez modifier.
- 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. Pour plus d’informations, consultez « Génération d’un jeton d’accès utilisateur pour une application GitHub ».
- 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.
- Sous « Identification et autorisation des utilisateurs », sélectionnez ou désélectionnez Demander l’autorisation utilisateur (OAuth) pendant l’installation.
- 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 et OAuth Apps, consultez « Génération d’un jeton d’accès utilisateur pour une application GitHub » et « Autorisation des applications OAuth ».
- 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.
- 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. Pour plus d’informations, consultez « Création 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. Pour plus d’informations, consultez « À propos de l’URL de rappel d’autorisation utilisateur ».
- 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.
- 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.
- 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.
Modifications des autorisations d’une GitHub App
Vous pouvez modifier les autorisations d’accès accordées à votre GitHub App en procédant comme suit.
Lorsque vous modifiez les autorisations de dépôt ou d’organisation d’une application, chaque compte sur lequel l’application est installée doit approuver les nouvelles autorisations. Lorsque vous modifiez les autorisations de compte d’une application, chaque utilisateur qui a autorisé l’application doit approuver les modifications d’autorisation. 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.
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. Pour plus d’informations, consultez « Choix des autorisations pour une application GitHub ».
- 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.
- Dans la barre latérale des paramètres des GitHub Apps, cliquez sur Autorisations et événements.
- 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. Pour plus d’informations, consultez « Choix des autorisations pour une application GitHub ».
- Si vous le souhaitez, sous « Ajouter une note aux utilisateurs », ajoutez une note indiquant à vos utilisateurs pourquoi vous modifiez les autorisations que votre GitHub App demande.
- Cliquez sur Save changes.
Activation ou désactivation du webhook d’GitHub App
Vous pouvez configurer votre GitHub App pour recevoir des webhooks pour des événements spécifiques sur GitHub et y prendre automatiquement des mesures. Pour plus d’informations, consultez « Utilisation de webhooks avec des applications GitHub ».
- 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.
- Sous « Webhook », pour activer ou désactiver le webhook, sélectionnez ou désélectionnez Actif.
- Si vous avez sélectionné Actif à l’étape précédente, sous « URL de webhook », entrez l’URL à laquelle GitHub doit envoyer les événements de webhook.
- 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 vous recommande vivement de définir un secret de webhook.
Modification des abonnements aux événements webhook d’une GitHub App
Vous pouvez modifier les événements de webhook auxquels une GitHub App s’abonne en procédant comme suit.
The specific webhook events that you can select in your app settings are determined by the type of permissions you selected for your app. You will first need to select the permissions you would like your app to have, and then you can subscribe your app to webhook events that are related to that set of permissions. Pour plus d’informations, consultez « Utilisation de webhooks avec des applications GitHub ».
- 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.
- Activez le webhook GitHub App. Pour plus d’informations, consultez « Activation ou désactivation du webhook d’GitHub App » dans cet article.
- Dans la barre latérale des paramètres des GitHub Apps, cliquez sur Autorisations et événements.
- 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. Pour plus d’informations, consultez « Modification des autorisations d’une GitHub App ».
- Sous « S’abonner aux événements », sélectionnez les événements de webhook que vous souhaitez que votre GitHub App reçoive.
- Cliquez sur Save changes.
Modifications de la visibilité d’une 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. Pour plus d’informations, consultez « Rendre une application GitHub publique ou privée ».
- 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. 1. Dans la barre latérale de gauche, cliquez sur Avancé.
- Sous « Zone de danger », en fonction de la visibilité actuelle de votre GitHub App, cliquez sur Rendre public ou Rendre privé.