Installieren einer -App von einem Drittanbieter

Informationen zum Installieren von Apps

In diesem Artikel wird beschrieben, wie du eine App direkt vom App-Besitzer bzw. der App-Besitzerin statt vom Marketplace installierst. Weitere Informationen zum Installieren von Apps aus dem Marketplace findest du unter Installieren einer -App aus dem Marketplace für dein persönliches Konto und Installieren einer -App aus dem Marketplace für deine Organisationen. Weitere Informationen zum Installieren von Apps in deinem Besitz findest du unter Installieren einer eigenen -App.

Um eine App in deinen Repositorys oder deiner Organisation zu verwenden, musst du die App im Organisationskonto oder in deinem persönlichen Konto installieren. Du kannst ein und dieselbe 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.

Wenn du eine App installierst, gewährst du der App die Berechtigung, auf die angeforderten Organisations- und Repositoryressourcen zuzugreifen. Während des Installationsprozesses teilt dir mit, welche Berechtigungen die App angefordert hat. Weitere Informationen zu den REST-API-Anforderungen, die die App mit diesen Berechtigungen ausführen kann, findest du unter Für -Apps erforderliche Berechtigungen.

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

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

Du kannst beliebig viele Apps installieren.

Unterschied zwischen Installation und Autorisierung

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

Wenn du eine 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 App an, welche Repository- und Organisationsberechtigungen du gewährst. Weitere Informationen darüber, was eine App aufgrund verschiedener Berechtigungen ausführen kann, findest du unter Auswählen von Berechtigungen für eine -App.

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

Wenn du eine App autorisierst, erteilst du der App Zugriff auf dein -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 App autorisierst, erteilst du der App auch die Berechtigung, in deinem Namen zu handeln.

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

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

Weitere Informationen zur Autorisierung von Apps findest du unter Autorisieren von -Apps.

Anforderungen zum Installieren einer App

Jeder kann Apps in seinem persönlichen Konto installieren.

Organisationsbesitzer*innen können Apps in ihrer Organisation installieren.

Administratorinnen von Repositorys, die sich im Besitz einer Organisation befinden, können Apps auch für die Organisation installieren, wenn sie der App nur Zugriff auf Repositorys gewähren, für die sie Administratorin sind, und wenn die App keine Organisationsrechte oder die Verwaltungsberechtigung für das Repository anfordert. Organisationsbesitzerinnen können verhindern, dass externe Projektmitarbeiterinnen, die Repositoryadministrator*innen sind, Apps installieren.

Organisationsmitglieder, die nicht Organisationsbesitzerinnen oder Repositoryadministratorinnen sind, können während des Installationsvorgangs weiterhin die Organisation auswählen. Anstatt die App zu installieren, sendet eine Benachrichtigung an dendie Organisationsbesitzerin, um beim Organisationsbesitzer bzw. der Organisationsbesitzerin die Installation der App anzufordern.

Die Rolle „App-Manager“ in einer Organisation gibt einer Person nicht die Möglichkeit, eine App in der Organisation zu installieren. Weitere Informationen findest du unter Informationen zu -App-Manager*innen.

Installieren einer App

Während des Installationsvorgangs leitet dich derdie App-Besitzerin zur Installation der App zu einer -URL weiter. Die URL sieht in etwa wie https://.com/apps/APP-NAME/installations/new aus. APP-NAME ist dabei der Name der App.

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

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 .

   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 App mit diesen Berechtigungen ausführen kann, findest du unter Für -Apps erforderliche Berechtigungen.

5. Klicke auf Installieren, Installieren und anfordern oder Anfordern. Welche Schaltfläche angezeigt wird, hängt davon ab, ob dein Organisationsbesitzer bzw. deine Organisationsbesitzerin den angeforderten Zugriff für die App teilweise oder vollständig genehmigen muss. Weitere Informationen findest du unter Anforderungen zum Installieren einer App.