À propos des modifications pour une GitHub App
Vous pouvez modifier votre GitHub App pour modifier les paramètres sélectionnés lors de l’inscription de l’application. Pour plus d’informations sur les paramètres que vous pouvez sélectionner pendant l’inscription d’une 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 tester de nouvelles fonctionnalités pour votre GitHub App. Pour plus d’informations, consultez « Activation de fonctionnalités facultatives pour les applications GitHub ».
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.
- Dans le coin supérieur droit de n’importe quelle page sur GitHub, cliquez sur votre photo de profil.
- 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 :
- Cliquez sur Vos organisations.
- À 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 à gauche, cliquez sur GitHub Apps .
- À 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 des flux d’appareil avec GitHub Apps, 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 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 « 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. 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. 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 permissions d’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.
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.
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. 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.
- 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é.