You can create a GitHub App under your enterprise account. The app can only be installed on your enterprise or organizations within your enterprise, and can only be authorized by members of your enterprise. The app can't be installed on user accounts.
Step 1: Registering a GitHub App
To create a GitHub App, you must first register the app. See Registrieren einer GitHub-App.
Apps can also be transferred to an enterprise from a member or organization. To transfer an app, see Übertragen des Besitzes einer GitHub-App.
Step 1a: Adding an enterprise app manager
Enterprise owners can add enterprise members to an app as an app manager. App managers can manage the app's settings and credentials, but cannot install the app. For more information, see Informationen zu GitHub-App-Manager*innen.
Step 2: Building a GitHub App
After registering a GitHub App, you will want to write code to make your GitHub App do something. For examples of how to write code, see:
- Schnellstartanleitung zum Erstellen von GitHub-Apps
- Erstellen einer GitHub-App, die auf Webhookereignisse reagiert
- Erstellen der Schaltfläche „Mit GitHub anmelden“ mit einer GitHub-App
- Erstellen einer CLI mit einer GitHub-App
- Authentifizierte API-Anforderungen mit einer GitHub-App in einem GitHub Actions-Workflow
You should aim to follow best practices. See Best Practices beim Erstellen einer GitHub-App.
Step 3: Authorizing or installing your GitHub App
Once your GitHub App is registered, you'll need to make it available for use, either through authorization or installation, depending on the app’s purpose.
Enterprise owners and app managers can modify the permissions for apps owned by their enterprise at any time. Permissions changes will be automatically accepted by organizations in the enterprise if the change was made by the enterprise owner. Otherwise, the changes will be accepted only where the app manager is also an organization owner, and an organization owner must accept the update request for all other organizations.
Step 3a: Authorizing your GitHub App
Some GitHub Apps, like Copilot extensions, require authorization but do not need to be installed on an organization. Users in your enterprise can authorize the app to access resources within organizations. However, the app will only have access to GitHub resources where it is installed. See Autorisieren von GitHub-Apps.
Step 3b: Sharing your GitHub App via an installation link
For apps that require installation to function, you can provide organization owners with an installation link. Once the app is installed, it will have access to the organization's resources. See Freigeben deiner GitHub-App.
Step 4: Installing your GitHub App (if required)
If your GitHub App requires installation (not just authorization), organization owners can use the install link to install the app on their organization. See Installieren einer GitHub-App von einem Drittanbieter.
If your app uses enterprise permissions, you can install it on your enterprise. To find the installation link, go to the app's settings page in your enterprise account. See Installieren einer GitHub-App in deinem Unternehmen.