Skip to main content

À propos de l’utilisation des applications GitHub

Découvrez ce qu’est une GitHub App et pourquoi utiliser une GitHub App.

À propos de GitHub Apps

GitHub Apps sont des outils qui étendent les fonctionnalités de GitHub. Les GitHub Apps peuvent effectuer différentes opérations sur GitHub, comme ouvrir des problèmes, commenter des demandes de tirage (pull request) et gérer des projets. Elles peuvent également agir en dehors de GitHub en fonction des événements qui se produisent sur GitHub. Par exemple, une GitHub App peut publier sur Slack quand un problème est ouvert sur GitHub.

Recherche des GitHub Apps

Vous pouvez découvrir des GitHub Apps sur GitHub Marketplace.

Vous pouvez aussi créer vous-même votre GitHub App. Pour plus d’informations, consultez « À propos de la création d’applications GitHub ».

Utilisation de GitHub Apps

Pour utiliser une GitHub App, vous devez installer l’application sur votre compte d’utilisateur ou d’organisation. Lorsque vous installez l’application, vous lui accordez l’autorisation de lire ou de modifier les données de votre organisation et de vos dépôts. Les autorisations spécifiques dépendent de l’application, et GitHub vous indique les autorisations demandées par l’application avant l’installation de cette dernière. Lorsque vous installez l’application, vous spécifiez également les dépôts auxquels l’application pourra accéder. Si l’application requiert une configuration supplémentaire, elle vous invite à le faire. Pour plus d’informations, consultez « Installation d’une application GitHub à partir de GitHub Marketplace pour votre compte personnel », « Installation d’une application GitHub à partir de GitHub Marketplace pour vos organisations »,« Installation d’une application GitHub à partir d’un tiers » et « Installation de votre propre application GitHub ».

Vous devrez peut-être aussi autoriser une GitHub App qui souhaite vérifier votre identité, déterminer les ressources auxquelles vous avez accès ou effectuer des actions en votre nom. Si vous devez autoriser l’application, l’application vous invite à le faire. Pour plus d’informations, consultez « Autorisation des applications GitHub ».

Parfois, l’GitHub App demande des autorisations mises à jour. GitHub vous avertit lorsque cela se produit. Pour que l’application continue de fonctionner, vous devez alors examiner et approuver les autorisations mises à jour. Pour plus d’informations, consultez « Approbation des autorisations mises à jour pour une application GitHub ».

Avant d’installer ou d’autoriser une GitHub App, assurez-vous que l’application provient d’un développeur de confiance. Si vous n’utilisez plus l’application, vous devez suspendre ou désinstaller l’application et/ou révoquer l’autorisation que vous lui avez donnée. Pour plus d’informations, consultez « Examen et modification des applications GitHub installées » et « Examen et révocation de l’autorisation donnée aux applications GitHub ».

GitHub Apps et OAuth apps

GitHub prend également en charge OAuth apps. Contrairement aux GitHub Apps, vous n’installez pas OAuth app et vous ne contrôlez pas les référentiels auxquels elle peut accéder.

GitHub Apps et OAuth apps utilisent OAuth 2.0.

Les OAuth apps peuvent agir uniquement pour le compte d’un utilisateur, tandis que les GitHub Apps peuvent agir pour le compte d’un utilisateur ou indépendamment d’un utilisateur.

Pour plus d’informations, consultez « Différences entre les applications GitHub et les applications OAuth » et « Autorisation des applications OAuth ».