{"meta":{"title":"Ändern einer GitHub App-Registrierung","intro":"Nach dem Registrieren einer GitHub App kannst du Änderungen daran vornehmen.","product":"Apps","breadcrumbs":[{"href":"/de/enterprise-cloud@latest/apps","title":"Apps"},{"href":"/de/enterprise-cloud@latest/apps/maintaining-github-apps","title":"Verwalten von GitHub Apps"},{"href":"/de/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app-registration","title":"Ändern der App-Einstellungen"}],"documentType":"article"},"body":"# Ändern einer GitHub App-Registrierung\n\nNach dem Registrieren einer GitHub App kannst du Änderungen daran vornehmen.\n\n## Informationen zu Modifikationen von GitHub App\n\nDu kannst deine GitHub App-Registrierung bearbeiten, um Einstellungen zu ändern, die beim ursprünglichen Registrieren der App ausgewählt wurden. Weitere Informationen zu den Einstellungen, die du beim Registrieren einer GitHub App auswählen kannst, findest du unter [Registrieren einer GitHub-App](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/creating-a-github-app).\n\nDu 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.\n\nDu kannst auch wählen, neue optionale Features für deine GitHub App zu testen. Weitere Informationen findest du unter [Aktivieren optionaler Features für GitHub Apps](/de/enterprise-cloud@latest/apps/maintaining-github-apps/activating-optional-features-for-github-apps).\n\n<!-- Anchor to maintain links to this heading -->\n\n<a name=\"navigating-to-your-github-app-settings\"></a>\n\n## Navigieren zu den GitHub App-Einstellungen\n\nUm eine GitHub App zu bearbeiten navigiere zuerst zur Seite mit den App-Einstellungen.\n\n1. Klicke auf GitHub in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto.\n\n2. Navigieren Sie zu den Einstellungen für Ihr Konto.\n   * Klicken Sie bei einer App, die zu einem persönlichen Konto gehört, auf **Einstellungen**.\n   * Für eine App im Besitz einer Organisation:\n     1. Klicke Sie auf **Ihre Organisationen**.\n     2. Klicken Sie rechts neben der Organisation auf **Einstellungen**.\n   * Für eine App im Besitz eines Unternehmens:\n     1. Wenn Sie Enterprise Managed Users verwenden, klicken Sie auf **Ihr Unternehmen**, um direkt zu den Enterprise-Konto Einstellungen zu wechseln.\n     2. Wenn Sie persönliche Konten verwenden, klicken Sie auf **Ihre Unternehmen** und dann rechts neben dem Unternehmen auf **Einstellungen**.\n\n3. Navigieren Sie zu den GitHub App-Einstellungen.\n   * Für eine App, die einem persönlichen Konto oder einer Organisation gehört:\n     1. Klicke in der linken Randleiste auf **<svg version=\"1.1\" width=\"16\" height=\"16\" viewBox=\"0 0 16 16\" class=\"octicon octicon-code\" aria-label=\"code\" role=\"img\"><path d=\"m11.28 3.22 4.25 4.25a.75.75 0 0 1 0 1.06l-4.25 4.25a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L13.94 8l-3.72-3.72a.749.749 0 0 1 .326-1.275.749.749 0 0 1 .734.215Zm-6.56 0a.751.751 0 0 1 1.042.018.751.751 0 0 1 .018 1.042L2.06 8l3.72 3.72a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215L.47 8.53a.75.75 0 0 1 0-1.06Z\"></path></svg> Developer settings** und dann auf **GitHub Apps**.\n   * Für eine App im Besitz eines Unternehmens:\n     1. Klicken Sie in der linken Randleiste unter „Einstellungen“, auf **GitHub Apps**.\n\n4. Klicke rechts neben der GitHub App, die du ändern möchtest, auf **Bearbeiten**.\n\n## Ändern der grundlegenden Informationen einer GitHub App\n\nDu kannst die grundlegenden Informationen deiner GitHub App ändern, z. B. den Namen, die Beschreibung oder die Homepage-URL der App.\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Bearbeite unter „Grundlegende Informationen“ die Informationen zur GitHub App, die du ändern möchtest.\n3. Klicken Sie auf **Änderungen speichern**.\n\n## Benutzerautorisierung (OAuth) während der Installation anfordern\n\nDu kannst Benutzer*innen dazu auffordern, deine GitHub App bei der Installation zu autorisieren und ein Benutzerzugriffstoken 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](/de/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Aktiviere oder deaktiviere **Benutzerautorisierung (OAuth) während der Installation anfordern** unter „Identifizieren und Autorisieren von Benutzern“.\n3. Gib unter „Rückruf-URL“ die vollständige URL ein, zu der umgeleitet werden soll, nachdem Benutzer\\*innen die Installation autorisiert haben.\n\n## Aktivieren oder Deaktivieren des Geräteflusses\n\nMit 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 zum Verwenden des Geräteflusses mit GitHub Apps findest du unter [Generieren eines Benutzerzugriffstokens für eine GitHub App](/de/enterprise-cloud@latest/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app#using-the-device-flow-to-generate-a-user-access-token).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Aktiviere oder deaktiviere **Gerätefluss aktivieren** unter „Identifizieren und Autorisieren von Benutzern“.\n\n## Hinzufügen oder Aktualisieren einer Setup-URL\n\nDu kannst Personen zu einer bestimmten URL umleiten, nachdem sie deine App installiert haben. Weitere Informationen findest du unter [Registrieren einer GitHub-App](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/creating-a-github-app).\n\nWenn 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](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/about-the-user-authorization-callback-url).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. 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.\n3. 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.\n\n## Ändern der Berechtigungen einer GitHub App\n\nDu kannst die Zugriffsberechtigungen für deine GitHub App mit den folgenden Schritten ändern.\n\nWenn du neue **Repository-**, **Organisation-** oder **Enterprise-** Berechtigungen für eine App hinzufügst, muss jedes Konto, in 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 eine E-Mail an jeden Organisationsbesitzer oder jeden Benutzer, und benachrichtigt sie über die Anforderung, die Berechtigungen der App zu aktualisieren. Aktualisierte Berechtigungen werden erst dann für eine Installation oder Benutzerautorisierung wirksam, wenn die neuen Berechtigungen genehmigt wurden. Du kannst den [installation-Webhook](/de/enterprise-cloud@latest/webhooks-and-events/webhooks/webhook-events-and-payloads?actionType=new_permissions_accepted#installation) verwenden, um herauszufinden, wann Personen neue Berechtigungen für deine App akzeptieren.\n\nWenn du Berechtigungen oder Webhooks aus deiner GitHub App entfernst, werden die Änderungen sofort wirksam. Wenn du Berechtigungen entfernst, die deiner App zuvor erteilt wurden, kann die App nicht mehr auf diese Ressourcen zugreifen.\n\nWenn du die Berechtigungen einer App änderst, die einem Unternehmen gehört, werden die Änderungen sofort für alle Installationen der App innerhalb des Unternehmens wirksam, wenn du ein Unternehmensbesitzer bist. Wenn du App-Manager bist, werden die Änderungen nur automatisch in Organisationen akzeptiert, in denen du Organisationsbesitzer bist.\n\nUpdates 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.\n\nDas Ä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](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Klicke auf der Randleiste für GitHub Apps-Einstellungen auf **Berechtigungen und Ereignisse**.\n3. Ä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](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/choosing-permissions-for-a-github-app).\n4. Füge optional unter „Hinweis an Benutzer hinzufügen“ einen Hinweis hinzu, der deinen Benutzer\\*innen mitteilt, warum du die Berechtigungen änderst, die deine GitHub App anfordert.\n5. Klicken Sie auf **Änderungen speichern**.\n\n## Aktivieren oder Deaktivieren des GitHub App-Webhooks\n\nDu kannst deine GitHub App so konfigurieren, dass sie Webhooks für bestimmte Ereignisse auf GitHub empfängt und automatisch darauf reagiert. Weitere Informationen findest du unter [Verwenden von Webhooks mit GitHub Apps](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Um einen Webhook zu aktivieren oder zu deaktivieren, wähle **Aktiv** aus oder hebe die Auswahl auf.\n3. Wenn du im vorherigen Schritt **Aktiv** ausgewählt hast, gib unter „Webhook-URL“ die URL ein, an die GitHub Webhookereignisse senden soll.\n4. Wenn du im vorherigen Schritt **Aktiv** ausgewählt hast, kannst du optional unter „Webhookgeheimnis“ ein geheimes Token eingeben, um deine Webhooks zu schützen. Wir empfehlen dringend, für GitHub ein Webhook-Geheimnis festzulegen.\n\n## Ändern der Webhookereignisabonnements einer GitHub App\n\nDu kannst die Webhookereignisse, die eine GitHub App abonniert, mit den folgenden Schritten ändern.\n\nDie 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. Weitere Informationen findest du unter [Verwenden von Webhooks mit GitHub Apps](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/using-webhooks-with-github-apps).\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Aktiviere den GitHub App-Webhook. Weitere Informationen findest du unter [Aktivieren oder Deaktivieren des GitHub App-Webhooks](/de/enterprise-cloud@latest/apps/maintaining-github-apps/modifying-a-github-app#activating-or-deactivating-the-github-app-webhook) in diesem Artikel.\n3. Klicke auf der Randleiste für GitHub Apps-Einstellungen auf **Berechtigungen und Ereignisse**.\n4. Wähle in den Abschnitten „Repositoryberechtigungen“, „Organisationsberechtigungen“ und „Kontoberechtigungen“ die Berechtigungen aus, die für die von deiner App abonnierten Ereignisse erforderlich sind. Weitere Informationen findest du unter [Ändern der Berechtigungen einer GitHub App](#changing-the-permissions-of-a-github-app).\n5. Wähle unter „Ereignisse abonnieren“ die Webhookereignisse aus, die deine GitHub App empfangen soll.\n6. Klicken Sie auf **Änderungen speichern**.\n\n## Ändern der Sichtbarkeit einer GitHub App\n\nDu kannst die Sichtbarkeitseinstellungen deiner GitHub App ändern, um zu steuern, wer die App 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](/de/enterprise-cloud@latest/apps/creating-github-apps/creating-github-apps/making-a-github-app-public-or-private).\n\nSie können die Sichtbarkeit einer GitHub App im Besitz eines Unternehmens nicht ändern. GitHub Apps, die sich im Besitz eines Unternehmens befinden, können nur in Organisationen desselben Unternehmens oder im Unternehmen selbst installiert werden.\n\n1. Navigiere zur Einstellungsseite für die App, die du ändern möchtest. Weitere Informationen findest du unter [Navigieren zu deinenGitHub App-Einstellungen](#navigating-to-your-github-app-settings) in diesem Artikel.\n2. Klicke auf der linken Seitenleiste auf **Advanced** (Erweitert).\n3. Klicke unter „Gefahrenzone“ je nach aktueller Sichtbarkeit deiner GitHub App entweder auf **Als öffentlich festlegen** oder **Als privat festlegen**."}