Vous pouvez créer une GitHub App sous votre compte d’entreprise. L'application ne peut être installée que sur 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 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 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.
É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.