À propos de l’utilisation des applications GitHub

À 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 pouvoir utiliser une GitHub App, vous devez l’installer 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 compte. 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 sur votre organisation ou compte d’utilisateur, vous spécifiez également les référentiels auxquels l’application peut 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. Lorsqu'une application agit en votre nom, elle a accès aux mêmes ressources que vous, à condition que l'application soit installée sur le compte propriétaire des ressources et que vous lui ayez donné les autorisations nécessaires. 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 ».