À 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 ne pouvez pas installer d’applications tierces sur votre entreprise. Si vous souhaitez utiliser les fonctionnalités d’une application tierce, contactez le développeur de l’application pour créer une application à partir d’un manifeste ou à l’aide de paramètres d’URL. Pour plus d’informations, consultez « Inscription d’une application GitHub à partir d’un manifeste » et « Inscription d’une application GitHub à l’aide de paramètres d’URL ».
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 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 ».