Skip to main content

Installieren einer GitHub-App aus dem GitHub Marketplace für deine Organisationen

Du kannst GitHub Apps aus dem GitHub Marketplace installieren, um sie in deinen Organisationen zu verwenden.

Informationen zum GitHub Marketplace

Dieser Artikel bezieht sich auf die Installation und den Kauf von GitHub Appss über den GitHub Marketplace. Weitere Informationen zum Installieren von GitHub Apps aus einer anderen Quelle als GitHub Marketplace finden Sie unter Installieren einer GitHub-App von einem Drittanbieter.

Hinweis

Apps aus GitHub Marketplace sind derzeit nicht auf GHE.com verfügbar.

Wenn du eine GitHub App in deinem Organisationskonto installierst und einen kostenpflichtigen Plan auswählst, bezahlst du für dein App-Abonnement am aktuellen Abrechnungsdatum deiner Organisation mit der vorhandenen Zahlungsmethode deiner Organisation.

Wenn Du einen kostenpflichtigen Plan mit einer kostenfreien Testphase wählst, kannst Du jederzeit während Deiner Testphase ohne Gebühren kündigen, aber Du verlierst automatisch den Zugriff auf die App. Dein kostenpflichtiges Abonnement beginnt am Ende der 14-tägigen Testphase. Weitere Informationen finden Sie unter GitHub Marketplace-App-Abonnements.

Informationen zum Installieren einer OAuth app anstelle einer GitHub App von GitHub Marketplace finden Sie unter Installieren einer OAuth-App in deiner Organisation.

Informationen zum Installieren von GitHub Apps

Um ein GitHub App für Ihre Ressourcen zu verwenden, müssen Sie die App für Ihr Unternehmenskonto, 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 angeforderten Unternehmens- oder 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

Nachdem du eine GitHub App installiert hast, wirst du 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.

Screenshot der Seite zum Installieren einer GitHub-App. Die App fordert Lesezugriff auf Metadaten sowie Schreibzugriff auf Issues an.

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.

Screenshot der Seite zum Autorisieren einer GitHub-App. Die App fordert Lesezugriff auf E-Mails und Schreibzugriff auf Gists an.

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 von GitHub Apps finden Sie unter Autorisieren von GitHub Apps.

Anforderungen zum Installieren einer GitHub App für eine Organisation

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

In Unternehmen, die per Kreditkarte bezahlen, können Unternehmensbesitzerinnen, die auch Organisationsbesitzerinnen sind, GitHub Apps in Organisationen innerhalb ihres Unternehmens 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.

Die Rolle „App-Manager“ ermächtigt einen Benutzer nicht, eine GitHub App in der Organisation oder im Unternehmen zu installieren. Weitere Informationen finden Sie unter Informationen zu GitHub App-Managern.

Bei von Unternehmen verwalteten Benutzerkonten können nur Unternehmensbesitzende eine kostenpflichtige GitHub App für eine Organisation innerhalb des Unternehmens erwerben und installieren. Enterprise-Mitglieder können keine kostenpflichtige GitHub App erwerben. Organisationsbesitzende mit einem vom Unternehmen verwalteten Benutzerkonto können weiterhin eine kostenlose GitHub App installieren.

Installieren einer GitHub App in deiner Organisation

  1. Wähle in der oberen linken Ecke von GitHub Marketplace die Option aus, und klicke auf Marketplace, um GitHub zu öffnen.

    Screenshot: Navigationsleiste auf GitHub Das Symbol „Globales Navigationsmenü öffnen“ ist dunkelorange umrandet.

  2. Navigiere zur App, die Du installieren möchtest, und klicke anschließend auf den Namen der App.

  3. Klicke auf der App-Seite unter „Preise und Setup“ auf den Tarifplan, den du verwenden möchtest.

  4. Klicke auf Kostenlos installieren, Mit GitHub kaufen oder 14 Tage lang kostenlos testen.

  5. Wähle eine Installationsorganisation für die App aus. Abhängig von den Nutzungsbedingungen deiner Organisation unterscheidet sich dieser Prozess geringfügig.

    • Wenn du GitHub die Berechtigung zum Sammeln von Namens- und Adressinformationen für deine Organisation erteilt hast, wähle im Abschnitt „Abrechnungsinformationen“ das Dropdownmenü Abrechnungskonto wechseln aus, und klicke dann auf die Organisation, in der du die App installieren möchtest.

    Screenshot des Kaufbildschirms der GitHub Marketplace-App. Ein reduziertes blaues Dropdownmenü mit der Beschriftung „Abrechnungskonto wechseln“ ist in dunklem Orange eingerahmt.

    • Wähle andernfalls unter „Bestellung überprüfen“ das Dropdownmenü Konto aus, und klicke dann auf die Organisation, in der du die App installieren möchtest.

    Screenshot des Kaufbildschirms der GitHub Marketplace-App. Ein reduziertes graues Dropdownmenü mit der Beschriftung „Konto“ ist in dunklem Orange eingerahmt.

    Hinweis

    Wenn deine Organisation SAML-SSO verwendet und deine Organisation nicht aufgeführt ist, musst du möglicherweise eine aktive SAML-Sitzung für deine Organisation starten. Weitere Informationen finden Sie unter SAML- und GitHub-Apps.

  6. Bei Auswahl eines kostenpflichtigen Plans überprüfe bitte dein Zahlungsmethode.

    • Um die hinterlegte Zahlungsmethode für die Organisation zu ändern, klicke auf Bearbeiten, und fülle anschließend das Formular aus, um eine neue Zahlungsmethode hinzuzufügen.
    • Wenn keine Zahlungsmethode für die Organisation hinterlegt ist, klicke auf Zahlungsmethode hinzufügen, und fülle anschließend das Formular aus, um eine Kreditkarte oder ein PayPal-Konto hinzuzufügen.
  7. Klicke auf Bestellung abschließen und Installation beginnen.

  8. Wenn die App Zugriff auf Repositorys erfordert, wähle Alle Repositorys oder Nur ausgewählte Repositorys aus.

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

  9. Wenn Du Dich dafür entschließt, der App nur auf begrenzte statt auf all Deine Repositorys Zugriff zu gewähren, gib den Namen jedes Repository ein, für welches Du der App Zugriffe geben willst, dann klicke auf den Repository-Namen um es auszuwählen.

  10. Überprüfe die Zugriffsberechtigungen der App, und klicke anschließend auf Installieren.

Weiterführende Themen