À propos de GitHub Marketplace
Cet article s’applique à l’installation et à l’achat GitHub Apps à partir de GitHub Marketplace. Pour plus d’informations sur l’installation GitHub Apps à partir d’une source autre que GitHub Marketplace, consultez Installation d’une application GitHub à partir d’un tiers.
Remarque
Les applications de GitHub Marketplace ne sont pas actuellement disponibles sur GHE.com.
Si vous installez une GitHub App sur votre compte personnel et que vous choisissez un forfait payant, vous paierez votre abonnement à l’application à la date de facturation actuelle de votre compte personnel à l’aide de votre mode de paiement actuel.
Si vous choisissez un plan payant avec un essai gratuit, vous pouvez l’annuler à tout moment pendant votre période d’essai sans être facturé, mais vous perdrez automatiquement l’accès à l’application. Votre abonnement payant commence à la fin de l’essai gratuit de 14 jours. Pour plus d’informations, consultez « abonnements aux applications de la Place de marché GitHub ».
Pour plus d’informations sur l’installation d’un OAuth app au lieu d’un GitHub App à partir de GitHub Marketplace, consultez Installation d’une application OAuth dans votre compte personnel.
À propos de l’installation GitHub Apps
Pour pouvoir utiliser une GitHub App application sur vos ressources, vous devez installer l’application sur votre entreprise, votre organisation ou votre compte personnel. Vous pouvez installer le 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 d’entreprise ou d’organisation et de référentiel demandées. Pendant l’installation, GitHub vous indiquera quelles autorisations le GitHub App a demandées. 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.
Lorsque vous installez une application qui demande des autorisations de dépôt, vous choisissez également les référentiels auxquels accorder l’accès GitHub App .
Avant d’installer un GitHub App, assurez-vous de faire confiance au propriétaire du GitHub App. Vous devez également passer en revue les autorisations demandées GitHub App et vous assurer que vous êtes à l’aise d’accorder ces autorisations. 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.
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 installezGitHub App sur votre compte ou votre organisation, vous accordez à l’application l’autorisation d’accéder aux ressources de l’organisation et du dépôt qu’elle a demandées. Vous spécifiez également les dépôts accessibles à l’application. Pendant le processus d’installation, le GitHub App indiquera les autorisations du dépôt et de l’organisation que vous accordez. Pour plus d’informations sur les différentes autorisations permettant d’effectuer une GitHub App opération, consultez Choix des autorisations pour une application GitHub.
Par exemple, vous pouvez accorder à GitHub App l'autorisation de lire les métadonnées du référentiel et de créer des problèmes, et accorder à GitHub App l'accès à tous vos référentiels.
Lorsque vous autorisez un GitHub App, vous accordez à l’application l’accès à votre GitHub compte, en fonction 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 un GitHub App, vous accordez également l’autorisation de l’application d’agir en votre nom.
Par exemple, vous pouvez accorder à GitHub App l'autorisation de lire vos adresses e-mail et de créer des gists.
Vous pouvez installer une GitHub App application sans autoriser l’application. Inversement, vous pouvez autoriser l’application sans l’installer.
Pour plus d’informations sur l’autorisation GitHub Apps, consultez Autorisation des applications GitHub.
Installation d’un GitHub App dans votre compte personnel
-
Pour ouvrir GitHub Marketplace, dans le coin supérieur gauche de GitHub, sélectionnez, puis cliquez sur Place de marché.
-
Accédez à l’application que vous souhaitez installer, puis cliquez sur son nom.
-
Dans la page de l’application, sous « Prix et configuration », cliquez sur le plan tarifaire que vous souhaitez utiliser.
-
Cliquez sur L’installer gratuitement, Acheter avec GitHub , ou Essayer gratuitement pendant 14 jours.
-
Sous « Vérifier votre commande », dans le menu déroulant Compte, vérifiez que vous installez l’application pour votre compte personnel.
-
Si vous avez choisi un plan payant, dans la section « Mode de paiement », passez en revue votre mode de paiement.
- Pour changer le mode de paiement existant sur le fichier de votre compte personnel, cliquez sur Modifier et remplissez le formulaire pour ajouter un nouveau mode de paiement.
- S’il n’existe pas de mode de paiement sur le fichier de votre compte personnel, remplissez le formulaire pour ajouter une carte de crédit ou un compte PayPal.
-
Sélectionnez Terminer la commande et commencer l’installation.
-
Si l’application a besoin d’un accès aux dépôts, sélectionnez Tous les dépôts ou Uniquement les dépôts sélectionnés.
Si l’application crée des dépôts, l’application se voit automatiquement accorder l’accès à ces dépôts.
-
Si vous avez choisi d’accorder à l’application l’accès à un nombre limité de dépôts au lieu de tous vos dépôts, entrez le nom de chaque dépôt auquel vous souhaitez accorder l’accès à l’application, puis cliquez sur le nom du dépôt pour le sélectionner.
-
Vérifiez les autorisations d’accès de l’application, puis cliquez sur Installer.
