À propos de l’installation GitHub Apps
GitHub utilisateurs peuvent installer GitHub Apps sur leur compte personnel ou les comptes dont ils sont propriétaires. Lorsque vous installez un GitHub App, vous accordez à l’application les autorisations d’entreprise ou d’organisation et de référentiel demandées. Si l’application a demandé des autorisations de référentiel, vous spécifiez également les référentiels auxquels il GitHub App peut accéder. L’installation d’une application sur une entreprise accorde uniquement des autorisations d’entreprise. Pour accorder des autorisations d’organisation et de référentiel, installez l’application sur une organisation.
Vous devriez vérifier régulièrement les GitHub Apps que vous avez installées. Vous pouvez passer en revue les autorisations que vous avez accordées et modifier les dépôts auxquels l’accès GitHub App est autorisé. Si vous n’utilisez plus d’application, envisagez de suspendre ou de supprimer le GitHub App pour bloquer son accès aux ressources détenues par le compte où il est installé.
En plus de consulter GitHub Apps que vous avez installé, vous pouvez consulter GitHub Apps que vous avez autorisé à agir en votre nom. Pour plus d’informations, consultez « Examen et révocation de l’autorisation des applications GitHub ».
Accéder à GitHub App que vous souhaitez examiner ou modifier
-
Pour une GitHub App installée en entreprise :
- Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil, puis cliquez sur Vos entreprises.
- À côté du nom de votre entreprise, cliquez sur Paramètres.
- Dans la barre de navigation supérieure, cliquez sur Paramètres.
- Dans la barre latérale, cliquez sur GitHub Apps. La liste des GitHub Apps appartenant à votre entreprise sera affichée.
- Accédez à l’onglet Applications installées pour afficher la liste des applications installées sur votre entreprise.
- À côté du/de la GitHub App que vous souhaitez examiner ou modifier, cliquez sur Configurer.
-
Pour l’installation d’un GitHub App dans une organisation :
- Dans le coin supérieur droit de GitHub, cliquez sur votre image de profil, puis cliquez sur Vos organisations.
- À côté du nom de votre organisation, cliquez sur Paramètres.
- Dans la barre latérale, sous « Accès tiers », cliquez sur GitHub Apps. Une liste des GitHub Apps éléments installés sur votre organisation s’affiche.
- À côté du GitHub App que vous souhaitez examiner ou modifier, cliquez sur Configurer.
-
Pour une GitHub App installation sur votre compte personnel :
- Dans le coin supérieur droit de n’importe quelle page, cliquez sur votre photo de profil, puis sur Paramètres.
- Sous « Intégrations », cliquez sur Applications.
- Cliquez sur Installed GitHub Apps. Une liste des éléments GitHub Apps installés sur votre compte personnel s’affiche.
- À côté de GitHub App que vous souhaitez examiner ou modifier, cliquez sur Configurer.
-
Pour un dépôt auquel l’accès à GitHub App a été accordé :
Remarque
Au cours des étapes suivantes, vous accéderez aux paramètres du compte de l’organisation ou du compte personnel sur lequel GitHub App est installé. Les paramètres affectent l’ensemble des référentiels où l’application est installée dans ce compte, et pas seulement le référentiel à partir duquel vous y avez accédé.
-
Accédez à la page principale de l’organisation ou du dépôt.
-
Cliquez sur Paramètres.
-
Sous « Intégrations », cliquez sur GitHub Apps. Une liste des accès GitHub Apps accordés à votre référentiel s’affiche.
-
À côté du GitHub App que vous souhaitez vérifier ou modifier, cliquez sur Configurer.
-
Examen des autorisations
- Accédez au GitHub App fichier à modifier. Pour plus d’informations, consultez Accédez à l'application GitHub que vous souhaitez examiner ou modifier.
- Sous « Autorisations », passez en revue les autorisations dont dispose l’utilisateur GitHub App . 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.
Modification de l’accès au référentiel
-
Accédez à l’élément GitHub App que vous souhaitez modifier. Pour plus d’informations, consultez Accédez à l'application GitHub que vous souhaitez examiner ou modifier.
-
Sous « Accès au référentiel », sélectionnez Tous les référentiels ou Uniquement les référentiels sélectionnés.
-
Si vous avez sélectionné Uniquement sélectionner des référentiels à l’étape précédente, sous la liste déroulante Sélectionner des référentiels , sélectionnez les référentiels auxquels vous souhaitez GitHub App accéder.
Si GitHub App crée des dépôts par la suite, l’application se verra automatiquement accorder l’accès à ces dépôts également.
-
Cliquez sur Enregistrer.
Blocage de l’accès
-
Accédez au GitHub App fichier à modifier. Pour plus d’informations, consultez Accédez à l'application GitHub que vous souhaitez examiner ou modifier.
-
Pour conserver l’installation GitHub App pour une utilisation ultérieure, mais bloquer temporairement l’accès aux ressources appartenant à votre compte, cliquez sur Suspendre.
Lorsque vous suspendez un GitHub App, votre autorisation de l’application (si l’application est installée sur votre compte personnel) ou l’autorisation de l’application par les membres de votre compte (si l’application est installée sur une organisation ou une entreprise) ne sera pas affectée. Pour plus d’informations, consultez « Autorisation des applications GitHub ».
Si l’application GitHub App a été suspendue précédemment, vous pouvez la réactiver en cliquant sur Unsuspend. Si le GitHub App a été suspendu par le propriétaire de GitHub App, vous ne pouvez pas réactiver l’application.
-
Pour désinstaller GitHub App et l’empêcher d’accéder aux ressources de votre compte, cliquez sur Désinstaller.
Lorsque vous désinstallez un GitHub App d’un compte, l’application perdra l’accès aux ressources de ce seul compte. L’application peut toujours être autorisée à accéder aux comptes en votre nom, si elle est installée dans ces comptes.
Si vous souhaitez empêcher une application d’agir en votre nom n’importe où GitHub, désactivez également l’application sous l’onglet « Autorisé GitHub Apps» de votre compte d’utilisateur. Cela désactivera complètement tous les jetons émis à l’application en votre nom. Pour plus d’informations, consultez « Autorisation des applications GitHub ».