À propos de l’installation GitHub Apps
Remarque
Ce flux d’installation s’applique à tout GitHub App, qu’il s’agisse d’une application tierce ou d’une application appartenant à votre entreprise. Vous pouvez installer l’application manuellement à l’aide du lien fourni par le propriétaire de l’application.
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é un 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 GitHub Apps, consultez Autorisation des applications GitHub.
Configuration requise pour installer un GitHub App
Tout le monde peut installer GitHub Apps sur son compte.
Les propriétaires d’organisations peuvent installer GitHub Apps sur 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 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 de l’organisation pour demander au propriétaire de l’organisation 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.
Le rôle de « gestionnaire d’applications » ne permet pas à une personne d’installer un GitHub App au sein de l’organisation. Consultez À propos des gestionnaires d’applications GitHub.
Installation d’un GitHub App
Pendant le processus d’installation, le propriétaire de l’application vous dirige vers une GitHub URL pour installer le GitHub App. L’URL se présente comme http(s)://HOSTNAME/github-apps/APP-NAME/installations/new, où APP-NAME est le nom du GitHub App.
-
Sélectionnez l’emplacement où vous souhaitez installer le 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 référentiels 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 de l’API REST que le 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 un GitHub App.