Installation d’applications d’entreprise

À propos de l’installation des GitHub Apps sur votre entreprise

Les GitHub Apps installées au niveau de l’entreprise sont des applications qui demandent des autorisations au niveau de l’entreprise et peuvent effectuer des opérations sur votre compte d’entreprise. Contrairement aux installations au niveau d’une organisation ou d’un utilisateur, elles n’ont accès à aucune autorisation au niveau des organisations ou des dépôts : elles gèrent uniquement l’entreprise elle-même.

Lorsqu’un propriétaire d’entreprise installe une GitHub App sur votre entreprise, l’application se voit accorder les autorisations d’entreprise qu’elle a demandées. Ces autorisations permettent à l’application d’effectuer des opérations telles que la création d’organisations dans l’entreprise, l’installation d’applications au sein des organisations et la gestion du provisionnement SCIM.

Conditions requises pour installer une GitHub App sur votre entreprise

La GitHub App doit demander des autorisations au niveau de l’entreprise. Elle peut également demander d’autres autorisations, mais seules les autorisations d’entreprise seront accordées lors de l’installation.

L’application doit appartenir à votre entreprise ou à une organisation au sein de votre entreprise. Vous ne pouvez pas installer d’applications appartenant à un compte externe à votre entreprise.

Installation d’une GitHub App sur votre entreprise

Pour installer une application sur votre entreprise, accédez à la page d’installation de la GitHub App. Cette page peut être fournie par le développeur de l’application sous forme de lien d’installation, ou vous pouvez la trouver dans l’enregistrement de l’application. L’URL ressemble à https://github.com/apps/APP-NAME/installations/new, où APP-NAME est le nom de l’GitHub App.

Si l’application peut être installée, la liste des emplacements d’installation disponibles inclura votre entreprise. Vous pouvez sélectionner votre entreprise pour installer l’application.

Après l’installation, l’application pourra créer un jeton d’installation pour votre entreprise ou permettre à des membres de l’entreprise de se connecter afin d’agir en leur nom au niveau de l’entreprise. Agir au nom d’un utilisateur nécessite que l’utilisateur puisse effectuer les opérations souhaitées au sein de l’entreprise. Par exemple, si l’application doit inviter un utilisateur à rejoindre une entreprise, l’utilisateur doit également avoir l’autorisation d’inviter des membres dans l’entreprise.

Ce que les applications installées au niveau de l’entreprise peuvent faire

Les GitHub Apps installées au niveau de l’entreprise ne peuvent pas appeler toutes les API d’entreprise, mais plusieurs API ont déjà été mises à jour pour prendre en charge les GitHub Apps. Ces API et mutations GraphQL incluent :

•           [Lister et créer des organisations dans votre entreprise](/graphql/reference/mutations#createenterpriseorganization)
  

•           [Gérer les utilisateurs dans votre entreprise](/graphql/reference/objects#enterprise)
  

• Créer et gérer les installations de GitHub App dans vos organisations
• Gérer les propriétés de dépôt personnalisées de l’entreprise
• Appeler les API SCIM de l’entreprise

Consultez le journal des modifications pour connaître les mises à jour portant sur de nouvelles API et autorisations pour les GitHub Apps.

Pour plus d’informations sur les autorisations et points de terminaison d’API disponibles, consultez Autorisations requises pour les applications GitHub.

Limites de taux pour les GitHub Apps installées au niveau de l’entreprise

Le jeton d’installation d’une GitHub Apps installée au niveau de l’entreprise a la même limite de taux qu’une organisation GitHub Enterprise Cloud. Les limites de taux sont définies par installation. Par exemple, si une application est installée sur une entreprise et sur deux organisations, elle aura besoin de 3 jetons d’installation pour y accéder et disposera d’un budget de limite de taux complet et indépendant pour chaque installation. Pour plus d’informations, consultez « Limites de débit pour l'API REST » et « Limites de débit et limites de requête pour l’API GraphQL ».

Limitations actuelles

Les GitHub Apps installées au niveau de l’entreprise sont actuellement en préversion publique avec les limitations suivantes.

Prise en charge des API

Toutes les API ne prennent pas encore en charge les GitHub Apps installées au niveau de l’entreprise. À mesure que de nouvelles autorisations seront créées et que les API seront mises à jour, la prise en charge deviendra plus étendue. Pour plus d’informations sur les API et autorisations qui prennent en charge les GitHub Apps installées au niveau de l’entreprise, consultez Autorisations requises pour les applications GitHub.

Prise en charge des webhooks

Les installations au niveau de l’entreprise ne prennent pas actuellement en charge les webhooks. Les applications installées au niveau de l’entreprise ne peuvent pas recevoir d’événements webhook pour les activités au niveau de l’entreprise. Installez-les sur des organisations ou des dépôts pour recevoir des événements webhook concernant ces ressources.

Accès aux organisations

Les installations au niveau de l’entreprise ne se voient pas accorder d’accès aux organisations ou aux dépôts au sein de votre entreprise, à l’exception de l’API des installations d’organisation. Pour accéder aux ressources d’organisation ou de dépôt, vous devez installer l’application séparément sur chaque organisation pour laquelle l’accès est nécessaire.

Étapes suivantes

Maintenant que vous automatisez les processus avec GitHub Apps, découvrez-en Support GitHub davantage pour obtenir de l’aide quand vous en avez besoin. Consultez Comprendre le support aux entreprises.