Vous pouvez créer un GitHub App sous votre compte d’entreprise. L’application peut uniquement être installée sur vos 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 des comptes utilisateur.
Étape 1 : Inscription d’un GitHub App
Pour créer un 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 depuis un membre ou une organisation. Pour transférer une application, veuillez consulter la section Transfert de propriété d’une application GitHub.
Étape 1a : Ajouter un gestionnaire d'applications d'entreprise
Les propriétaires d'entreprise peuvent ajouter des membres de l'entreprise à une application en tant que gestionnaires 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éation d’un GitHub App
Après avoir enregistré un GitHub App, vous voudrez é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
- Création d’une application GitHub qui répond aux événements de webhook
- Création d’un bouton « Connexion avec GitHub » avec une application GitHub
- Création d’une interface CLI avec une application GitHub
- Effectuer des requêtes d’API authentifiées avec une application GitHub dans un flux de travail 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
GitHub App Une fois votre inscription inscrite, vous devez la rendre disponible pour une utilisation, via l’autorisation ou l’installation, en fonction de l’objectif de l’application.
Les propriétaires d’entreprise et les gestionnaires d’applications peuvent modifier les autorisations des 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 : Autoriser votre GitHub App
Certains, comme GitHub Apps les Copilotextensions, nécessitent une autorisation, mais n’ont pas besoin d’être installés sur une organisation. Les utilisateurs de votre entreprise peuvent autoriser l'application à accéder aux ressources au sein des organisations. Toutefois, l’application n’aura accès qu’aux GitHub ressources 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 une installation pour fonctionner, vous pouvez fournir aux propriétaires d'organisation un lien d'installation. 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 (et pas seulement une autorisation), les propriétaires 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 ».