Installieren einer GitHub-App in deinem Unternehmen

Sie können auf Ihrem Unternehmen installieren GitHub Apps , um Ihr Unternehmenskonto 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

Von Enterprise installierte GitHub Apps befinden sich in Öffentliche Vorschau und können sich ändern.

Informationen zur Installation GitHub Apps in Ihrem Unternehmen

Unternehmensseitig installierte GitHub Apps sind Apps, die Berechtigungen auf Unternehmensebene anfordern und Aktionen in Ihrem Unternehmenskonto 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 Unternehmensinhaber in Ihrem Unternehmen ein GitHub App installiert, erhält die App die von ihr angeforderten Unternehmensberechtigungen. 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 für die Installation eines GitHub App in Ihrem Unternehmen

Die GitHub App Berechtigung muss auf Unternehmensebene angefordert werden. 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.

Installation eines GitHub App in Ihrem Unternehmen

Um eine App in Ihrem Unternehmen zu installieren, navigieren Sie zur GitHub App Installationsseite. Du findest sie als Installationslink, der vom App-Entwickler bereitgestellt wird, oder in der Registrierung der App. Die URL sieht ungefähr so aus: https://github.com/apps/APP-NAME/installations/new, wobei APP-NAME den Namen des GitHub App darstellt.

Wenn die App installiert werden kann, wird Ihr Unternehmen in der Liste der verfügbaren Installationsorte 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

Enterprise-installed GitHub Apps kann nicht jede Unternehmens-API aufrufen, aber mehrere APIs wurden bereits aktualisiert, um GitHub Apps zu unterstützen. Zu diesen APIs und GraphQL-Mutationen gehören:

Überprüfen Sie das Änderungsprotokoll auf Updates über neue APIs und Berechtigungen für GitHub Apps.

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

Ratenbegrenzungen für unternehmensweit installierte GitHub Apps

Das Installationstoken für ein von einem Unternehmen installiertes GitHub Apps hat dieselbe 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 Abfragegrenzwerte für die GraphQL-API.

Aktuelle Einschränkungen

Unternehmensseitig installierte GitHub Apps befinden sich derzeit in Öffentliche Vorschau mit den folgenden Einschränkungen.

API-Unterstützung

Noch nicht alle APIs unterstützen die Installation GitHub Apps von Unternehmen. Es werden jedoch laufend weitere Berechtigungen erstellt und APIs aktualisiert, wodurch die Unterstützung wächst. Weitere Informationen zu den APIs und Berechtigungen für unternehmensweit installierte GitHub Apps finden Sie unter Erforderliche Berechtigungen für GitHub Apps.

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 Webhook-Ereignisse für eine Organisation oder ein Repository 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.

Wenn Sie dieselbe App in vielen Organisationen installieren müssen, können Sie dies mit einer API automatisieren. Weitere Informationen findest du unter Automatisieren von App-Installationen in den Unternehmen.

Nächste Schritte