Installieren einer GitHub-App von einem Drittanbieter

Informationen zum Installieren von GitHub Apps

Um eine GitHub App für deine Ressourcen zu verwenden, musst du die App in deinem Organisationskonto oder persönlichen Konto installieren. Du kannst ein und dieselbe GitHub App in 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.

Beim Installieren einer App gewährst du der App die Berechtigung, auf die angeforderten Organisationsressourcen und die Repositoryressourcen zuzugreifen. Während des Installationsprozesses teilt dir GitHub mit, welche Berechtigungen die GitHub App angefordert hat. Weitere Informationen zu den REST-API-Anforderungen, die die GitHub App mit diesen Berechtigungen ausführen kann, findest du unter Erforderliche Berechtigungen für GitHub Apps.

Wenn du eine App installierst, die Repositoryberechtigungen anfordert, wählst du auch aus, auf welche Repositorys der GitHub App Zugriff gewährt werden soll.

Bevor du eine GitHub App installierst, solltest du sicher sein, dass du dem Besitzer der GitHub App vertraust. Du solltest auch die Berechtigungen überprüfen, die die GitHub App anfordert, und sicherstellen, dass du diese Berechtigungen erteilen möchtest. Weitere Informationen zu den REST-API-Anforderungen, die die GitHub App mit diesen Berechtigungen ausführen kann, findest du unter Erforderliche Berechtigungen für GitHub Apps.

Du kannst beliebig viele Apps installieren.

Unterschied zwischen Installation und Autorisierung

Nachdem du eine GitHub App installiert hast, wirst du möglicherweise auch aufgefordert, die App zu autorisieren.

Wenn du eine GitHub App in deinem Konto oder deiner Organisation installierst, erteilst du der App die Berechtigung für den Zugriff auf die angeforderten Organisations- und Repositoryressourcen. Außerdem kannst du festlegen, auf welche Repositorys die App zugreifen kann. Während des Installationsvorgangs gibt die GitHub App an, welche Repository- und Organisationsberechtigungen du gewährst. Weitere Informationen darüber, was eine GitHub App aufgrund verschiedener Berechtigungen ausführen kann, findest du unter Auswählen von Berechtigungen für eine GitHub App.

Beispielsweise könntest du die GitHub App-Berechtigung zum Lesen von Repositorymetadaten und Schreiben von Issues erteilen, und du könntest GitHub App-Zugriff auf alle deine Repositorys gewähren.

Wenn du eine GitHub App autorisierst, erteilst du der App Zugriff auf dein GitHub-Konto, basierend auf den von der App angeforderten Kontoberechtigungen. Während des Autorisierungsprozesses gibt die App an, auf welche Ressourcen die App für dein Konto zugreifen kann. Wenn du eine GitHub App autorisierst, erteilst du der App auch die Berechtigung, in deinem Namen zu handeln.

Beispielsweise kannst du der GitHub App die Berechtigung erteilen, deine E-Mail-Adressen zu lesen und Gists zu schreiben.

Du kannst eine GitHub App installieren, ohne die App zu autorisieren. Ebenso kannst du die App autorisieren, ohne sie zu installieren.

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

Anforderungen zum Installieren einer GitHub App

Jeder kann GitHub Apps in seinem persönlichen Konto installieren.

Organisationsbesitzer können GitHub Apps in ihrer Organisation installieren.

Repository-Administratorinnen und -Administratoren können GitHub Apps in der Organisation installieren, der das Repository gehört, wenn die App keine Organisationsberechtigungen und auch nicht die Berechtigung „Repository-Verwaltung“ anfordert. Dabei können sie die App nur mit Zugriff auf die Repositorys installieren, die sie verwalten.

Organisationsmitglieder und externe Mitarbeiter, die keine App in der Organisation installieren können, können die Organisation während des Installationsprozesses weiterhin auswählen. Anstatt die App zu installieren, sendet GitHub eine Benachrichtigung an dendie Organisationsbesitzerin, um beim Organisationsbesitzer bzw. der Organisationsbesitzerin die Installation der App anzufordern. 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“ ermächtigt einen Benutzer nicht, eine GitHub App in der Organisation zu installieren. Weitere Informationen findest du unter Informationen zu GitHub App-Managern.

Installieren einer GitHub App

Während des Installationsvorgangs leitet dich derdie App-Besitzerin zur Installation der GitHub App zu einer GitHub-URL weiter. Die URL sieht in etwa wie http(s)://HOSTNAME/github-apps/APP-NAME/installations/new aus. APP-NAME ist dabei der Name der GitHub App.

1. Wähle den Speicherort aus, an dem du die GitHub App installieren möchtest. Du kannst dein persönliches Konto oder eine Organisation auswählen, bei der du Mitglied bist.

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-Anforderungen, die die GitHub App mit diesen Berechtigungen ausführen kann, findest du 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 deiner Organisation keine, einige oder alle angeforderten Zugriffe für die App genehmigen muss. Weitere Informationen findest du unter Anforderungen zum Installieren einer GitHub App.