Ändern einer GitHub App-Registrierung

Nach dem Registrieren einer GitHub App kannst du Änderungen daran vornehmen.

In diesem Artikel

Informationen zu GitHub App Änderungen

Sie können Ihre GitHub App Registrierung ändern, um alle Einstellungen zu ändern, die beim erstmaligen Registrieren der App ausgewählt wurden. Weitere Informationen zu den Einstellungen, die Sie bei der Registrierung von GitHub App auswählen können, finden Sie in Registrieren einer GitHub-App.

Du kannst z. B. den Namen und die Beschreibung deiner App, die Berechtigungen, die deiner App erteilt wurden, die Webhooks, die deine App abonniert hat, oder die Sichtbarkeit deiner App ändern.

Sie können auch auswählen, neue optionale Funktionen für GitHub App zu testen. Weitere Informationen findest du unter Aktivieren optionaler Features für GitHub Apps.

Zum Ändern eines GitHub App, navigieren Sie zuerst zur Seite mit den App-Einstellungen.

  1. Klicke auf GitHub in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto.

  2. Navigieren Sie zu den Einstellungen für Ihr Konto.

    • Klicken Sie bei einer App, die zu einem persönlichen Konto gehört, auf Einstellungen.
    • Für eine App im Besitz einer Organisation:
      1. Klicke Sie auf Ihre Organisationen.
      2. Klicken Sie rechts neben der Organisation auf Einstellungen.
    • Für eine App im Besitz eines Unternehmens:
      1. Wenn Sie Enterprise Managed Users verwenden, klicken Sie auf Ihr Unternehmen, um direkt zu den Enterprise-Konto Einstellungen zu wechseln.
      2. Wenn Sie persönliche Konten verwenden, klicken Sie auf Ihre Unternehmen und dann rechts neben dem Unternehmen auf Einstellungen.

  3. Navigieren Sie zu den GitHub App-Einstellungen.

    • Für eine App, die einem persönlichen Konto oder einer Organisation gehört:
      1. Klicke in der linken Randleiste auf Developer settings und dann auf GitHub Apps.
    • Für eine App im Besitz eines Unternehmens:
      1. Klicken Sie in der linken Randleiste unter „Einstellungen“, auf GitHub Apps.

  4. Klicke rechts neben der GitHub App, die du ändern möchtest, auf Bearbeiten.

Ändern der grundlegenden Informationen einer GitHub App

Sie können die grundlegenden Informationen Ihrer GitHub AppApp ändern, z. B. den Namen der App, die Beschreibung der App und die Homepage-URL der App.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Ändern Sie unter "Grundlegende Informationen" die GitHub App Informationen, die Sie ändern möchten.
  3. Klicken Sie auf Änderungen speichern.

Benutzerautorisierung (OAuth) während der Installation anfordern

Sie können Benutzer dazu auffordern, Ihr GitHub App zu autorisieren, wenn sie es installieren, und ein Benutzerzugriffs-Token zu generieren. Wenn du die Benutzerautorisierung (OAuth) während der Installation anforderst, musst du auch eine Rückruf-URL angeben, an die Benutzer*innen umgeleitet werden, nachdem sie die Installation autorisiert haben. Weitere Informationen findest du unter Generieren eines Benutzerzugriffstokens für eine GitHub App.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Aktiviere oder deaktiviere Benutzerautorisierung (OAuth) während der Installation anfordern unter „Identifizieren und Autorisieren von Benutzern“.
  3. Gib unter „Rückruf-URL“ die vollständige URL ein, zu der umgeleitet werden soll, nachdem Benutzer*innen die Installation autorisiert haben.

Aktivieren oder Deaktivieren des Geräteflusses

Mit dem Gerätefluss kannst du Benutzer*innen für eine App ohne GUI autorisieren, z. B. ein CLI-Tool oder Git Credential Manager. Weitere Informationen zur Verwendung des Geräteflusses mit GitHub Apps finden Sie unter Generieren eines Benutzerzugriffstokens für eine GitHub App.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Aktiviere oder deaktiviere Gerätefluss aktivieren unter „Identifizieren und Autorisieren von Benutzern“.

Hinzufügen oder Aktualisieren einer Setup-URL

Du kannst Personen zu einer bestimmten URL umleiten, nachdem sie deine App installiert haben. Weitere Informationen findest du unter Registrieren einer GitHub-App.

Wenn du Benutzerautorisierung (OAuth) während der Installation anfordern ausgewählt hast, kannst du keine Setup-URL eingeben. Benutzer*innen werden im Rahmen des Autorisierungsvorgangs stattdessen zur Rückruf-URL weitergeleitet, wo du das zusätzliche Setup beschreiben kannst. Weitere Informationen findest du unter Informationen zur Rückruf-URL für die Benutzerautorisierung.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Gib unter „Nach der Installation“ im Feld „Setup-URL“ die URL ein, an die Benutzer*innen umgeleitet werden sollen, nachdem sie deine App installiert haben.
  3. Wenn du Benutzer*innen nach dem Aktualisieren einer Installation zur Setup-URL umleiten möchtest, kannst du optional Bei Update umleiten aktivieren. Ein Update umfasst das Hinzufügen oder Entfernen eines Repositorys für eine Installation. Wenn „Setup-URL“ leer ist, wird dies ignoriert.

Ändern der Berechtigungen einer GitHub App

Sie können die Zugriffsberechtigungen ändern, die Ihnen GitHub App gewährt werden, indem Sie die folgenden Schritte ausführen.

Wenn Sie einer App neue Repository-, Organisations- oder Unternehmensberechtigungen hinzufügen, muss jedes Konto, auf dem die App installiert ist, die neuen Berechtigungen genehmigen. Wenn du die Berechtigungen einer App für das Konto hinzufügst, muss jeder Benutzer, der die App autorisiert hat, die Berechtigungsänderungen genehmigen. In beiden Fällen sendet GitHub jedem Organisationsbesitzer bzw. Benutzer eine E-Mail, um ihn über die Aufforderung zur Aktualisierung der App-Berechtigungen zu informieren. Aktualisierte Berechtigungen werden erst dann für eine Installation oder Benutzerautorisierung wirksam, wenn die neuen Berechtigungen genehmigt wurden. Du kannst den installation-Webhook verwenden, um herauszufinden, wann Personen neue Berechtigungen für deine App akzeptieren.

Wenn Sie Berechtigungen oder Webhooks aus Ihrem GitHub App entfernen, werden die Änderungen sofort wirksam. Wenn du Berechtigungen entfernst, die deiner App zuvor erteilt wurden, kann die App nicht mehr auf diese Ressourcen zugreifen.

Wenn Sie die Berechtigungen einer App ändern, die einem Unternehmen gehört, werden die Änderungen sofort für alle Installationen der App innerhalb des Unternehmens wirksam, wenn Sie Unternehmensbesitzer sind. Wenn Sie ein App-Manager sind, werden die Änderungen nur in Organisationen, in denen Sie ein Organisationsbesitzer sind, automatisch akzeptiert.

Updates können nicht automatisch akzeptiert werden, wenn du einer App zum ersten Mal Repositoryberechtigungen hinzufügst. In diesem Fall muss jeder Organisationsbesitzer das Update genehmigen, damit er auswählen kann, auf welche Repositorys die App zugreifen kann.

Das Ändern der Berechtigungen einer App kann auch die Webhooks ändern, die deine App abonnieren kann, sowie die Aktionen, die deine App mit der API ausführen kann. Weitere Informationen findest du unter Auswählen von Berechtigungen für eine GitHub App.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Klicken Sie in der Einstellungs-Randleiste GitHub Apps auf Berechtigungen und Ereignisse.
  3. Ändere in den Abschnitten „Repositoryberechtigungen“, „Organisationsberechtigungen“ und „Kontoberechtigungen“ die gewünschten Berechtigungen. Wähle für jeden Berechtigungstyp entweder „Schreibgeschützt“, „Lesen und schreiben“ oder „Kein Zugriff“ in der Dropdownliste aus. Weitere Informationen findest du unter Auswählen von Berechtigungen für eine GitHub App.
  4. Fügen Sie optional unter „Nutzern einen Hinweis hinzufügen“ eine Notiz hinzu, in der Sie Ihren Nutzern mitteilen, warum Sie die Berechtigungen ändern, die Ihre GitHub App anfordert.
  5. Klicken Sie auf Änderungen speichern.

Aktivieren oder Deaktivieren des GitHub App Webhooks

Sie können Ihren GitHub App so konfigurieren, dass er Webhooks für bestimmte Ereignisse auf GitHub empfängt und automatisch darauf reagiert. Weitere Informationen findest du unter Verwenden von Webhooks mit GitHub Apps.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Um einen Webhook zu aktivieren oder zu deaktivieren, wähle Aktiv aus oder hebe die Auswahl auf.
  3. Wenn Sie im vorherigen Schritt "Aktiv " ausgewählt haben, geben Sie unter "Webhook-URL" die URL ein, GitHub an die Webhook-Ereignisse gesendet werden sollen.
  4. Wenn du im vorherigen Schritt Aktiv ausgewählt hast, kannst du optional unter „Webhookgeheimnis“ ein geheimes Token eingeben, um deine Webhooks zu schützen. GitHub empfiehlt dringend, ein Webhook-Geheimnis festzulegen.

Änderung der Abonnements für Webhook-Ereignisse eines GitHub App

Sie können die Webhook-Ereignisse, die von GitHub App abonniert werden, mithilfe der folgenden Schritte ändern.

Die spezifischen Webhookereignisse, die du für deine GitHub App-Registrierung auswählen kannst, werden durch den Typ der Berechtigungen bestimmt, die du für deine App ausgewählt hast. Du musst zuerst die Berechtigungen auswählen, über die deine App verfügen soll, und dann kannst du deine App für Webhookereignisse abonnieren, die sich auf diesen Berechtigungssatz beziehen. Siehe Verwenden von Webhooks mit GitHub Apps.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Aktivieren Sie den GitHub App Webhook. Siehe Aktivieren oder Deaktivieren des GitHub App Webhooks in diesem Artikel.
  3. Klicken Sie in der Einstellungs-Randleiste GitHub Apps auf Berechtigungen und Ereignisse.
  4. Wähle in den Abschnitten „Repositoryberechtigungen“, „Organisationsberechtigungen“ und „Kontoberechtigungen“ die Berechtigungen aus, die für die von deiner App abonnierten Ereignisse erforderlich sind. Siehe die Berechtigungen für eine GitHub App ändern.
  5. Wählen Sie unter „Ereignisse abonnieren“ die Webhook-Ereignisse aus, die Ihr GitHub App empfangen soll.
  6. Klicken Sie auf Änderungen speichern.

Die Sichtbarkeit von GitHub App ändern

Sie können die Sichtbarkeitseinstellungen Ihres GitHub App Steuerelements ändern, um zu steuern, wer sie installieren kann. Öffentliche Apps können nicht als privat festgelegt werden, wenn sie in anderen Konten installiert sind. Weitere Informationen findest du unter Erstellen einer GitHub App öffentlich oder privat.

Sie können die Sichtbarkeit eines GitHub App, das einem Unternehmen gehört, nicht ändern. GitHub Apps im Besitz eines Unternehmens kann nur bei Organisationen innerhalb des Unternehmens oder beim Unternehmen selbst installiert werden.

  1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter Navigieren zu deinenGitHub App-Einstellungen in diesem Artikel.
  2. Klicke auf der linken Seitenleiste auf Advanced (Erweitert).
  3. Klicken Sie unter „Gefahrenbereich“ je nach aktueller Sichtbarkeit Ihrer GitHub App entweder auf Öffentlich machen oder auf Privat machen.