Vous pouvez créer une GitHub App sous votre compte d’entreprise. L'application ne peut être installée que sur votre entreprise ou les organisations au sein de votre entreprise, et ne peut être autorisée que par les membres de votre entreprise. L’application ne peut pas être installée sur les comptes d’utilisateur.
Étape 1 : Inscrire une GitHub App
Pour créer une GitHub App, vous devez d’abord inscrire l’application. Consultez Inscription d’une application GitHub.
Les applications peuvent également être transférées vers une entreprise à partir d’un membre ou d’une organisation. Pour transférer une application, consultez Transfert de la propriété d’une application GitHub.
Étape 1a : ajout d’un gestionnaire d’applications d’entreprise
Les propriétaires d’entreprise peuvent ajouter des membres d’entreprise à une application en tant que gestionnaire d’applications. Les gestionnaires d’applications peuvent gérer les paramètres et les informations d’identification de l’application, mais ne peuvent pas installer l’application. Pour plus d’informations, consultez À propos des gestionnaires d’applications GitHub.
Étape 2 : Créer une GitHub App
Après avoir inscrit une GitHub App, vous souhaiterez écrire du code pour que votre GitHub App fasse quelque chose. Pour obtenir des exemples d’écriture de code, consultez :
- Démarrage rapide pour la création d’applications GitHub
- Génération d’une application GitHub qui répond aux événements de webhook
- Création d’un bouton « Se connecter avec GitHub » avec une application GitHub App
- Création d’une interface CLI avec une application GitHub App
- Effectuer des requêtes d’API authentifiées avec une application GitHub dans un workflow GitHub Actions
Vous devez vous efforcer de suivre les meilleures pratiques. Consultez Meilleures pratiques pour la création d’une application GitHub.
Étape 3 : autoriser ou installer votre GitHub App
Une fois que votre GitHub App est inscrite, vous devez le rendre disponible à l’utilisation, via l’autorisation ou l’installation, en fonction de la vocation de l’application.
Les propriétaires d’entreprise et les gestionnaires d’applications peuvent modifier les autorisations pour les applications détenues par leur entreprise à tout moment. Les modifications d’autorisations sont automatiquement acceptées par les organisations de l’entreprise si la modification a été apportée par le propriétaire de l’entreprise. Dans le cas contraire, les modifications seront acceptées uniquement lorsque le gestionnaire d’applications est également propriétaire de l’organisation et qu’un propriétaire de l’organisation doit accepter la demande de mise à jour pour toutes les autres organisations.
Étape 3a : Autorisation de votre GitHub App
Certaines GitHub Apps, telles que les extensions Copilot, nécessitent une autorisation, mais n’ont pas besoin d’être installées sur une organisation. Les utilisateurs de votre entreprise peuvent autoriser l’application à accéder aux ressources au sein des organisations. Toutefois, l’application aura uniquement accès aux ressources GitHub là où elle est installée. Consultez Autorisation des applications GitHub.
Étape 3b : Partage de votre GitHub App via un lien d’installation
Pour les applications qui nécessitent l’installation pour fonctionner, vous pouvez fournir un lien d’installation aux propriétaires d’organisation. Une fois l’application installée, elle aura accès aux ressources de l’organisation. Consultez Partage de votre application GitHub.
Étape 4 : Installation de votre GitHub App (si nécessaire)
Si votre GitHub App nécessite une installation (pas seulement une autorisation), les propriétaire d’organisation peuvent utiliser le lien d’installation pour installer l’application sur leur organisation. Consultez Installation d’une application GitHub à partir d’un tiers.
Si votre application utilise des autorisations d’entreprise, vous pouvez l’installer sur votre entreprise. Pour trouver le lien d’installation, accédez à la page des paramètres de l’application dans votre compte d’entreprise. Consultez Installation d’une application GitHub sur votre entreprise.