À propos de l'installation des GitHub Apps
Cet article explique comment installer une GitHub App directement à partir du propriétaire d’application au lieu de GitHub Marketplace. Pour plus d’informations sur l’installation des GitHub Apps à partir de GitHub Marketplace, consultez « Installation d’une application GitHub à partir de GitHub Marketplace pour votre compte personnel » et « Installation d’une application GitHub à partir de GitHub Marketplace pour vos organisations ». Pour plus d’informations sur l’installation des GitHub Apps qui vous appartiennent, consultez « Installation de votre propre application GitHub ».
Pour pouvoir utiliser une GitHub App dans vos ressources, vous devez l’installer sur votre organisation ou compte personnel. Vous pouvez installer la même GitHub App sur plusieurs comptes. Par exemple, si vous installez l’application sur votre compte personnel et sur quelques organisations dont vous êtes propriétaire, vous pourrez utiliser l’application sur vos dépôts personnels, sur les organisations où vous avez installé l’application et sur les dépôts appartenant à ces organisations.
Quand vous installez une application, vous lui accordez l'autorisation d'accéder aux ressources organisation et référentiel qu'elle a demandées. Durant le processus d’installation, GitHub vous indique quelles autorisations l’GitHub App a demandées. Pour plus d’informations sur les demandes d’API REST que l’GitHub App peut faire avec ces autorisations, consultez « Autorisations requises pour les applications GitHub ».
Lorsque vous installez une application qui demande des autorisations d'accès au référentiel, vous choisissez également les dépôts auxquels accorder l’accès à l’GitHub App.
Avant d’installer une GitHub App, vous devez veiller à approuver le propriétaire de l’GitHub App. Vous devez également passer en revue les autorisations demandées par l’GitHub App et vous assurer qu’accorder ces autorisations vous convient. Pour plus d’informations sur les demandes d’API REST que l’GitHub App peut faire avec ces autorisations, consultez « Autorisations requises pour les applications GitHub ».
Vous pouvez installer autant d’applications que vous le voulez.
Différence entre l’installation et l’autorisation
Après avoir installé une GitHub App, vous pouvez également être invité à autoriser l’application.
Lorsque vous installez une GitHub App sur votre compte ou votre organisation, vous autorisez l’application à accéder aux ressources de l’organisation et du référentiel demandées. Vous spécifiez également les dépôts accessibles à l’application. Pendant le processus d’installation, GitHub App indique les autorisations de référentiel et d’organisation que vous accordez. Pour plus d’informations sur les différentes autorisations qui permettent à un GitHub App d’agir, consultez « Choix des autorisations pour une application GitHub ».
Par exemple, vous pouvez accorder à l’GitHub App l’autorisation de lire les métadonnées des dépôts et d’écrire des problèmes, et vous pouvez accorder à l’GitHub App l’accès à tous vos dépôts.
Lorsque vous autorisez une GitHub App, vous lui accordez l’accès d’application à votre compte GitHub, sur la base des autorisations de compte demandées par l’application. Pendant le processus d’autorisation, l’application indique les ressources auxquelles l’application peut accéder sur votre compte. Lorsque vous autorisez une GitHub App, vous accordez également à l’application l’autorisation d’agir en votre nom.
Par exemple, vous pouvez accorder à l’GitHub App l’autorisation de lire vos adresses e-mail et d’écrire des gists.
Vous pouvez installer une GitHub App sans lui donner d’autorisation. Inversement, vous pouvez autoriser l’application sans l’installer.
Pour plus d’informations sur l’autorisation des GitHub Apps, consultez « Autorisation des applications GitHub ».
Conditions requises pour installer une GitHub App
N’importe qui peut installer des GitHub Apps sur son compte personnel.
Les propriétaires d’organisation peuvent installer des GitHub Apps dans leur organisation.
Les administrateurs de référentiel peuvent installer GitHub Apps dans l’organisation propriétaire du référentiel si l’application ne demande pas d’autorisations d’organisation ni l’autorisation « administration du référentiel ». Dans ce cas, ils ne peuvent installer l’application qu’avec l’accès aux référentiels qu’ils administrent. Les propriétaires de l’organisation peuvent restreindre l'installation de GitHub App par les administrateurs des référentiels. Lorsque cette restriction est activée, les administrateurs du référentiel ne peuvent pas installer GitHub Apps et doivent plutôt demander aux propriétaires de l’organisation d’installer l’application souhaitée. Pour plus d’informations, consultez Limitation des demandes et installations d’accès aux applications OAuth et GitHub App.
Les membres de l’organisation et les collaborateurs externes qui ne peuvent pas installer une application sur l’organisation peuvent toujours sélectionner l’organisation pendant le processus d’installation. Au lieu d’installer l’application, GitHub envoie une notification au propriétaire d’organisation pour lui demander d’installer l’application. La possibilité d’effectuer ces requêtes peut être contrôlée à l’aide de stratégies de demande d’accès aux applications. Consultez Limitation des demandes et installations d’accès aux applications OAuth et GitHub App.
Le rôle « gestionnaire d’applications » ne permet pas à une personne d’installer une GitHub App dans l’organisation. Consultez À propos des gestionnaires d’applications GitHub.
Installation d’une GitHub App
Pendant le processus d’installation, le propriétaire d’application vous dirige vers une URL GitHub pour installer l’GitHub App. L’URL ressemble à https://github.com/apps/APP-NAME/installations/new, où APP-NAME est le nom de l’GitHub App.
-
Sélectionnez l’emplacement où vous souhaitez installer l’GitHub App. Vous pouvez sélectionner votre compte personnel ou une organisation dont vous êtes membre.
-
Si l’application demande des autorisations de dépôt, sélectionnez Tous les dépôts ou Uniquement une sélection de dépôts. L’application aura toujours au moins un accès en lecture seule à tous les dépôts publics sur GitHub.
Si l’application ne demande pas d’autorisations de dépôt, ces options sont omises.
-
Si vous avez sélectionné Uniquement une sélection de dépôts à l’étape précédente, sous la liste déroulante Sélectionner des dépôts, sélectionnez les dépôts auxquels vous souhaitez que l’application accède.
Si l’application crée des dépôts, l’application se voit automatiquement accorder l’accès à ces dépôts.
-
Passez en revue les autorisations que demande l’application. Pour plus d’informations sur les demandes d’API REST que l’GitHub App peut faire avec ces autorisations, consultez « Autorisations requises pour les applications GitHub ».
-
Cliquez sur Installer, Installer et demander ou Demander. Le bouton présenté dépend du fait que le propriétaire de votre organisation ne doit approuver aucun, certains ou tous les accès demandés pour l’application. Pour plus d’informations, consultez Configuration requise pour installer une GitHub App.