Installieren einer GitHub-App von einem Drittanbieter

Informationen zur Installation GitHub Apps

Um ein GitHub App für Ihre Ressourcen zu verwenden, müssen Sie die App für Ihr Organisationskonto oder persönliches Konto installieren. Sie können dasselbe GitHub App auf mehreren Konten installieren. Wenn du die App beispielsweise in deinem persönliches Konto und dann in einigen Organisationen in deinem Besitz installierst, kannst du sie in deinen persönlichen Repositorys, in den Organisationen, in denen du die App installiert hast, und in Repositorys verwenden, die sich im Besitz dieser Organisationen befinden.

Wenn Sie eine App installieren, erteilen Sie der App die Berechtigung für den Zugriff auf die Organisationsressourcen und Repositoryressourcen. Während des Installationsvorgangs zeigt Ihnen GitHub, welche Berechtigungen die GitHub App angefordert hat. Weitere Informationen zu den REST-API-Anfragen, die GitHub App mit diesen Berechtigungen stellen kann, finden Sie unter Erforderliche Berechtigungen für GitHub Apps.

Wenn Sie eine App installieren, die Repositoryberechtigungen anfordert, wählen Sie auch aus, auf welche Repositorys der GitHub App Zugriff gewährt werden soll.

Bevor Sie ein GitHub App installieren, sollten Sie sicherstellen, dass Sie dem Besitzer des GitHub App vertrauen. Sie sollten auch die Berechtigungen überprüfen, die von GitHub App angefordert werden, und sicherstellen, dass Sie mit deren Erteilung einverstanden sind. Weitere Informationen zu den REST-API-Anfragen, die GitHub App mit diesen Berechtigungen stellen kann, finden Sie unter Erforderliche Berechtigungen für GitHub Apps.

Du kannst beliebig viele Apps installieren.

Unterschied zwischen Installation und Autorisierung

Nach der Installation einer GitHub AppApp werden Sie möglicherweise auch aufgefordert, die App zu autorisieren.

Wenn Sie eine GitHub App in Ihrem Konto oder Ihrer Organisation installieren, erteilen Sie der App die Berechtigung, auf die von ihr angeforderten Organisations- und Repository-Ressourcen zuzugreifen. Außerdem kannst du festlegen, auf welche Repositorys die App zugreifen kann. Während des Installationsvorgangs zeigt GitHub App an, welche Repository- und Organisationsberechtigungen Sie gewähren. Weitere Informationen darüber, welche verschiedenen Aufgaben eine GitHub App mit den Berechtigungen ausführen kann, finden Sie unter Auswählen von Berechtigungen für eine GitHub App.

Sie können z. B. die GitHub App Berechtigung zum Lesen von Repositorymetadaten und Zum Schreiben von Problemen erteilen, und Sie können den GitHub App Zugriff auf alle Repositorys gewähren.

Wenn Sie die Autorisierung für ein GitHub App erteilen, gewähren Sie der App entsprechend den von der App angeforderten Kontoberechtigungen Zugriff auf Ihr GitHub-Konto. Während des Autorisierungsprozesses gibt die App an, auf welche Ressourcen die App für dein Konto zugreifen kann. Wenn Sie ein GitHub AppAutorisieren, erteilen Sie der App auch die Berechtigung, in Ihrem Auftrag zu handeln.

Sie können z. B. die GitHub App Berechtigung zum Lesen Ihrer E-Mail-Adressen und zum Schreiben von Gists erteilen.

Sie können eine GitHub App App installieren, ohne die App zu autorisieren. Ebenso kannst du die App autorisieren, ohne sie zu installieren.

Weitere Informationen zur Autorisierung GitHub Appsfinden Sie unter Autorisieren von GitHub Apps.

Anforderungen für die Installation einer GitHub App

Jeder kann GitHub Apps in seinem persönlichen Konto.

Organisationsbesitzer können GitHub Apps auf ihrer Organisation installieren.

Repository-Administratoren können GitHub Apps in der Organisation installieren, der das Repository gehört, wenn die App weder Organisationsberechtigungen noch die Berechtigung „Repository-Administration“ anfordert. Auf diese Weise können sie die App nur mit Zugriff auf die Repositorys installieren, die sie verwalten. Organisationsbesitzer können die Installation durch Repositoryadministratoren einschränken GitHub App . Wenn diese Einschränkung aktiviert ist, können Repositoryadministratoren nicht installieren GitHub Apps und müssen stattdessen anfordern, dass Organisationsbesitzer die gewünschte App installieren. Weitere Informationen finden Sie unter Einschränken von OAuth-App- und GitHub App-Zugriffsanforderungen und -installationen.

Organisationsmitglieder und externe Mitarbeiter, die keine App in der Organisation installieren können, können die Organisation während des Installationsprozesses weiterhin auswählen. Statt die App zu installieren, sendet sie eine Benachrichtigung an den Organisationsbesitzer, um den Organisationsbesitzer aufzufordern, GitHub die App zu installieren. Die Möglichkeit, diese Anforderungen zu stellen, kann mithilfe von App-Zugriffsanforderungsrichtlinien gesteuert werden. Weitere Informationen findest du unter Einschränken von OAuth-App- und GitHub App-Zugriffsanforderungen und -installationen.

Die Rolle "App-Manager" gibt einer Person nicht die Möglichkeit, eine GitHub App Installation in der Organisation oder im Unternehmen durchzuführen. Weitere Informationen findest du unter Informationen zu GitHub App-Managern.

Installieren eines GitHub App

Während des Installationsvorgangs leitet der App-Besitzer Sie zu einer GitHub URL weiter, um die GitHub App zu installieren. Die URL sieht ungefähr so aus: http(s)://HOSTNAME/github-apps/APP-NAME/installations/new, wobei APP-NAME den Namen des GitHub App darstellt.

1. Wählen Sie den Speicherort aus, an dem Sie die GitHub AppDatei installieren möchten. Sie können Ihr persönliches Konto oder eine Organisation auswählen, bei der Sie Mitglied sind.

2. Wenn die App Repositoryberechtigungen erfordert, wähle Alle Repositorys oder Nur ausgewählte Repositorys aus. Die App hat immer mindestens schreibgeschützten Zugriff auf alle öffentlichen Repositorys auf GitHub.

   Wenn die App keine Repositoryberechtigungen erfordert, werden diese Optionen weggelassen.

3. Wenn du im vorherigen Schritt Nur ausgewählte Repositorys ausgewählt hast, wähle im Dropdownmenü Repositorys auswählen die Repositorys aus, auf die die App zugreifen soll.

   Wenn die App Repositorys erstellt, wird ihr automatisch auch Zugriff auf diese Repositorys gewährt.

4. Überprüfe die Berechtigungen, die die App anfordert. Weitere Informationen zu den REST-API-Anfragen, die GitHub App mit diesen Berechtigungen stellen kann, finden Sie unter Erforderliche Berechtigungen für GitHub Apps.

5. Klicke auf Installieren, Installieren und anfordern oder Anfordern. Die angezeigte Schaltfläche hängt davon ab, ob der Besitzer Ihrer Organisation keine, einige oder alle angeforderten Zugriffe für die App genehmigen muss. Weitere Informationen finden Sie unter Anforderungen zur Installation eines GitHub App.