Skip to main content

Installation d’une application GitHub à partir d’un tiers

Vous pouvez installer des GitHub Apps directement à partir du propriétaire de l’application pour les utiliser sur votre compte personnel ou vos organisations.

À propos de l’installation de 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 dépôts ou votre organisation, vous devez l’installer sur votre compte d’organisation ou 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.

Lorsque vous installez une application, vous accordez à l’application l’autorisation d’accéder aux ressources de l’organisation et du dépôt 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, 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.

Capture d’écran de la page d’installation d’une application GitHub. L’application demande l’accès en lecture aux métadonnées et l’accès en écriture aux problèmes. L’application peut également demander l’autorisation de l’utilisateur pour l’accès en lecture aux e-mails et l’accès en écriture aux Gists.

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.

Capture d’écran de la page pour autoriser un application GitHub. L’application demande l’accès en lecture aux e-mails et l’accès en écriture aux 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

Tout le monde 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érentiels appartenant à une organisation peuvent également installer des GitHub Apps dans l’organisation s’ils accordent uniquement à l’application l’accès aux référentiels dont ils sont administrateurs et si l’application ne demande aucune ressource de l’organisation ou d’« administration de référentiel ». Les propriétaires d’organisation peuvent empêcher les collaborateurs externes qui sont administrateurs de référentiels d’installer des GitHub Apps.

Les membres d’organisation qui ne sont ni propriétaires d’organisation ni administrateurs de dépôts 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.

Le rôle « gestionnaire d’applications » dans une organisation ne permet pas à une personne d’installer une GitHub App dans l’organisation. Pour plus d’informations, 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.

  1. 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.

Remarque : Si votre organisation utilise l’authentification unique SAML et que vous ne voyez pas vos organisations répertoriées, vous devrez peut-être démarrer une session SAML active pour votre organisation. Pour plus d’informations, consultez « Applications SAML et GitHub ».

  1. 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.

  2. 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.

  3. 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 ».

  4. Cliquez sur Installer, Installer et demander ou Demander. Le bouton présenté diffère selon que votre propriétaire d’organisation doit approuver en totalité, en partie ou nullement l’accès demandé pour l’application. Pour plus d’informations, consultez « Conditions requises pour installer une GitHub App ».