Vous pouvez créer une GitHub App sous votre compte d'entreprise. L'application ne peut être installée que sur votre entreprise ou des 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 : Enregistrer une GitHub App
Pour créer une GitHub App, vous devez d'abord enregistrer 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 la 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é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 :
-
[AUTOTITLE](/apps/creating-github-apps/writing-code-for-a-github-app/quickstart) -
[AUTOTITLE](/apps/creating-github-apps/guides/building-a-github-app-that-responds-to-webhook-events) -
[AUTOTITLE](/apps/creating-github-apps/guides/building-a-login-with-github-button-with-a-github-app) -
[AUTOTITLE](/apps/creating-github-apps/guides/building-a-cli-with-a-github-app) -
[AUTOTITLE](/apps/creating-github-apps/writing-code-for-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)
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 votre GitHub App enregistrée, vous devrez la rendre disponible pour utilisation, via une autorisation ou une installation, selon l'objectif de l'application.
Les propriétaires d'entreprise et les gestionnaires d'applications peuvent modifier à tout moment les autorisations des applications appartenant à leur entreprise. Les modifications d'autorisations seront automatiquement acceptées par les organisations de l'entreprise si la modification a été effectuée par le propriétaire de l'entreprise. Sinon, les modifications seront acceptées uniquement lorsque le gestionnaire d'applications est également propriétaire d'une organisation, et un propriétaire d'organisation doit accepter la demande de mise à jour pour toutes les autres organisations.
Étape 3a : Autoriser votre GitHub App
Certaines GitHub Apps, comme 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 n'aura accès aux ressources GitHub que là où elle est installée. Consultez Autorisation des applications GitHub.
Étape 3b : Partager 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.
Si vous devez installer la même application dans de nombreuses organisations, vous pouvez l’automatiser avec une API. Consultez Automatisation des installations d’applications dans les organisations de votre entreprise.
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 Installer une GitHub App sur votre entreprise.