Installieren einer GitHub-App in deinem Unternehmen

Du kannst GitHub Apps in deinem Unternehmen installieren, um dein Enterprise-Konto zu verwalten und Vorgänge auf Unternehmensebene auszuführen.

Wer kann dieses Feature verwenden?

Enterprise owners can install GitHub Apps on their enterprise. App managers cannot install apps at the enterprise level.

In diesem Artikel

Hinweis

In Unternehmen installierte GitHub Apps befinden sich in public preview und können sich noch ändern.

Informationen zum Installieren von GitHub Apps in deinem Unternehmen

In Unternehmen installierte GitHub Apps sind Apps, die Berechtigungen auf Unternehmensebene erfordern und Vorgänge für dein Enterprise-Konto ausführen können. Im Gegensatz zu Organisations- oder Benutzerinstallationen haben sie keinerlei Zugriff auf Organisations- oder Repositoryberechtigungen, sondern verwalten nur das Unternehmen selbst.

Wenn ein Unternehmensbesitzer eine GitHub App in deinem Unternehmen installiert, werden der App die angeforderten Unternehmensberechtigungen erteilt. Mit diesen Berechtigungen kann die App Vorgänge wie z. B. das Erstellen von Organisationen im Unternehmen, das organisationsübergreifende Installieren von Anwendungen und das Verwalten der SCIM-Bereitstellung ausführen.

Anforderungen zum Installieren einer GitHub App in deinem Unternehmen

Die GitHub App muss Berechtigungen auf Unternehmensebene anfordern. Sie kann noch weitere Berechtigungen anfordern, doch nur die Unternehmensberechtigungen werden während der Installation erteilt.

Die App muss sich im Besitz deines Unternehmens oder einer Organisation innerhalb deines Unternehmens befinden. Apps im Besitz eines Kontos außerhalb deines Unternehmens können nicht installiert werden.

Installieren einer GitHub App in deinem Unternehmen

Wenn du eine App in deinem Unternehmen installieren möchtest, navigiere zur GitHub App-Installationsseite. Du findest sie als Installationslink, der vom App-Entwickler bereitgestellt wird, oder in der Registrierung der App. Die URL sieht in etwa wie https://github.com/apps/APP-NAME/installations/new aus. APP-NAME ist dabei der Name der GitHub App.

Wenn die App installiert werden kann, wird dein Unternehmen in der Liste der verfügbaren Installationsspeicherorte angezeigt. Du kannst dein Unternehmen auswählen, um die App zu installieren.

Nach der Installation kann die App ein Installationstoken für dein Unternehmen erstellen oder Unternehmensmitglieder anmelden, um in ihrem Namen auf Unternehmensebene zu handeln. Das Ausführen von Aktionen im Namen eines Benutzers erfordert, dass der Benutzer die gewünschten Vorgänge innerhalb des Unternehmens selbst ausführen darf. Soll die App beispielsweise andere Benutzer zu einem Unternehmen einladen, muss auch der Benutzer über die Berechtigung verfügen, Mitglieder zu diesem Unternehmen einzuladen.

Mögliche Aufgaben für Apps, die in Unternehmen installiert sind

In Unternehmen installierte GitHub Apps können nicht jede beliebige Enterprise-API aufrufen, doch es gibt bereits eine Reihe von APIs, die für die Unterstützung von GitHub-Apps aktualisiert wurden. Zu diesen APIs und GraphQL-Mutationen gehören:

Informationen zu Updates für neue APIs und Berechtigungen für GitHub Apps findest du im Änderungsprotokoll.

Weitere Informationen zu den verfügbaren Berechtigungen und API-Endpunkten findest du unter Für GitHub-Apps erforderliche Berechtigungen.

Ratenbegrenzungen für in Unternehmen installierte GitHub Apps

Das Installationstoken für in Unternehmen installierte GitHub Apps besitzt die gleiche Ratenbegrenzung wie eine GitHub Enterprise Cloud-Organisation. Ratenbegrenzungen gelten pro Installation. Wird eine App beispielsweise in einem Unternehmen und zwei Organisationen installiert, sind drei Installationstoken für den Zugriff erforderlich, und jede Installation verfügt über ein vollständiges, unabhängiges Budget für die Ratenbegrenzung. Weitere Informationen findest du unter Ratenbegrenzungen für die REST-API und Ratenbegrenzungen und Knotengrenzwerte für die GraphQL-API.

Aktuelle Einschränkungen

In Unternehmen installierte GitHub Apps befinden sich derzeit in public preview und weisen die folgenden Einschränkungen auf.

API-Unterstützung

In Unternehmen installierte GitHub Apps werden noch nicht von allen APIs unterstützt. Es werden jedoch laufend weitere Berechtigungen erstellt und APIs aktualisiert, wodurch die Unterstützung wächst. Weitere Informationen zu den APIs und Berechtigungen, die in Unternehmen installierte GitHub Apps unterstützen, findest du unter Für GitHub-Apps erforderliche Berechtigungen.

Webhook-Unterstützung

Installationen in Unternehmen unterstützen derzeit keine Webhooks. Auf Unternehmensebene installierte Apps können keine Webhookereignisse für Aktivitäten auf Unternehmensebene empfangen. Wenn du Webhookereignisse für Organisationen oder Repositorys empfangen möchtest, installiere die Apps in diesen Ressourcen.

Organisationszugriff

Installationen in Unternehmen erhalten keinen Zugriff auf Organisationen oder Repositorys innerhalb deines Unternehmens, mit Ausnahme der API für die Organisationsinstallation. Wenn du auf Organisations- oder Repositoryressourcen zugreifen möchtest, musst du die App einzeln in jeder Organisation installieren, in der Zugriff benötigt wird.

Nächste Schritte