{"meta":{"title":"Migrieren von OAuth-Apps zu GitHub Apps","intro":"Erfahren Sie mehr über die Vorteile der Migration Ihres OAuth app zu einem GitHub App, und erfahren Sie, wie Sie Ihr OAuth app migrieren.","product":"Apps","breadcrumbs":[{"href":"/de/apps","title":"Apps"},{"href":"/de/apps/creating-github-apps","title":"Erstellung von GitHub-Apps"},{"href":"/de/apps/creating-github-apps/about-creating-github-apps","title":"Informationen zum Erstellen von GitHub Apps"},{"href":"/de/apps/creating-github-apps/about-creating-github-apps/migrating-oauth-apps-to-github-apps","title":"Migration von OAuth apps"}],"documentType":"article"},"body":"# Migrieren von OAuth-Apps zu GitHub Apps\n\nErfahren Sie mehr über die Vorteile der Migration Ihres OAuth app zu einem GitHub App, und erfahren Sie, wie Sie Ihr OAuth app migrieren.\n\n## Vorteile der Migration von OAuth apps zu GitHub Apps\n\nGitHub Apps sind die empfohlene Möglichkeit zur Integration in GitHub.\nGitHub Apps bieten viele Vorteile gegenüber OAuth apps, einschließlich:\n\n* Verbesserte Sicherheitsfeatures (z. B. differenzierte Berechtigungen, Optionen für den Repositoryzugriff und kurzlebige Tokens)\n* Möglichkeit, unabhängig von oder im Namen von Benutzenden zu handeln\n* Skalierbare Ratenlimits\n* Integrierte Webhooks\n\nWeitere Informationen finden Sie unter [Informationen zum Erstellen von GitHub Apps](/de/apps/creating-github-apps/about-creating-github-apps/about-creating-github-apps).\n\n## Konvertieren einer OAuth app in eine GitHub App\n\nDie folgenden Schritte bieten eine Übersicht über die Migration von einer OAuth app zu einer GitHub App. Die genauen Schritte hängen von deiner App ab.\n\n### 1. Überprüfen Ihrer OAuth app\n\nMachen Sie sich erneut mit dem Code für Ihr OAuth app vertraut. Die API-Anfragen, die Ihre OAuth app stellt, helfen Ihnen bei der Entscheidung, welche Berechtigungen Sie für Ihre GitHub App auswählen sollten.\n\nDarüber hinaus gibt es einige REST-API-Endpunkte, die für OAuth appsnicht verfügbar sind. Stellen Sie sicher, dass alle von Ihnen verwendeten REST-Endpunkte für GitHub Apps verfügbar sind, indem Sie [Für GitHub App-Installationszugriffstoken verfügbare Endpunkte](/de/rest/authentication/endpoints-available-for-github-app-installation-access-tokens) überprüfen.\n\n### 2. Registrieren einer GitHub App\n\nRegistrieren Sie ein neues GitHub App. Weitere Informationen finden Sie unter [Registrieren einer GitHub-App](/de/apps/creating-github-apps/registering-a-github-app/registering-a-github-app).\n\nIm Vergleich zu einem OAuth app, haben Sie mehr Kontrolle über GitHub App Einstellungen. Weitere wichtige Vorteile sind:\n\n* Im Gegensatz zu einem OAuth app, der immer im Namen eines Benutzers handelt, können Sie Ihr GitHub App veranlassen, im eigenen Namen oder im Namen eines Benutzers Aktionen auszuführen. Wenn Sie nicht möchten, dass Ihr Neues GitHub App Aktionen im Namen eines Benutzers ausführt, können Sie die Einstellungen \"Identifizieren und Autorisieren von Benutzern\" überspringen. Weitere Informationen finden Sie unter [Informationen zur Authentifizierung mit einer GitHub-App](/de/apps/creating-github-apps/authenticating-with-a-github-app/about-authentication-with-a-github-app).\n\n* Sie können Webhooks verwenden, um GitHub App zu benachrichtigen, wenn bestimmte Ereignisse eintreten. Im Gegensatz zu Webhooks für OAuth apps, die Sie über die API für jedes Repository oder jede Organisation konfigurieren müssen, sind Webhooks in GitHub Apps integriert. Wenn Sie Ihre GitHub AppRegistrierung durchführen, können Sie die Webhook-Ereignisse auswählen, die Sie empfangen möchten. Außerdem sollten Sie, wenn Ihr OAuth app derzeit Polling verwendet, um festzustellen, ob ein Ereignis eingetreten ist, stattdessen Webhooks abonnieren, damit Ihr GitHub App innerhalb des Ratenlimits bleibt. Weitere Informationen finden Sie unter [Verwenden von Webhooks mit GitHub Apps](/de/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps).\n\n* Mit einem OAuth app fordern Sie Berechtigungsbereiche an, wenn ein Benutzer Ihre App autorisiert. Mit einem GitHub App, geben Sie Berechtigungen in den App-Einstellungen an. Diese Berechtigungen sind präziser als Bereiche und ermöglichen es dir, nur die Berechtigungen auszuwählen, die deine App benötigt. Darüber hinaus werden diese Berechtigungen REST-API-Endpunkten und Webhook-Ereignissen zugeordnet, sodass Sie ganz einfach bestimmen können, welche Berechtigungen Sie GitHub App benötigen, um auf einen bestimmten REST-API-Endpunkt zuzugreifen oder einen bestimmten Webhook zu abonnieren. Die Berechtigungen für GraphQL-Anforderungen sind derzeit nicht dokumentiert. Weitere Informationen finden Sie unter [Auswählen von Berechtigungen für eine GitHub App](/de/apps/creating-github-apps/registering-a-github-app/choosing-permissions-for-a-github-app).\n\n### 3. Anpassen des Codes für deine App\n\nNachdem Sie einen GitHub Appregistriert haben, passen Sie den Code von Ihrem alten OAuth app an, um mit Ihrem neuen GitHub Appzu arbeiten.\n\n#### Aktualisieren der Authentifizierung\n\nSie müssen den Code Ihrer App aktualisieren, um die API-Authentifizierung für Ihre GitHub AppApp zu verarbeiten. Eine GitHub App kann auf drei Arten authentifiziert werden:\n\n* Als die App selbst, um Details zur GitHub App-Registrierung abzurufen oder zu ändern oder um ein Installationszugriffstoken zu erstellen. Weitere Informationen finden Sie unter [Authentifizieren als GitHub-App](/de/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app).\n* Als App-Installation, um eigenständig Maßnahmen zu ergreifen. Weitere Informationen finden Sie unter [Authentifizieren als GitHub App-Installation](/de/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-as-a-github-app-installation).\n* Im Namen eines Benutzers oder einer Benutzerin, um diesem oder dieser Aktionen zuzuordnen. Weitere Informationen finden Sie unter [Authentifizieren mit einer GitHub App im Namen eines Benutzers](/de/apps/creating-github-apps/authenticating-with-a-github-app/authenticating-with-a-github-app-on-behalf-of-a-user).\n\nWenn Sie die offizielle Octokit.js-Bibliothek verwenden GitHub, können Sie das integrierte `App` Objekt verwenden, um sich zu authentifizieren. Beispiele findest du unter [Skripterstellung mit der REST-API und JavaScript](/de/rest/guides/scripting-with-the-rest-api-and-javascript) und [Erstellen einer GitHub-App, die auf Webhook-Ereignisse reagiert](/de/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events).\n\n#### Überprüfen der Ratenlimits\n\nÜberprüfen Sie die Unterschiede bei den Ratenbegrenzungen zwischen OAuth apps und GitHub Apps.\nGitHub Apps Verwenden Sie Gleitregeln für Zinslimits, die basierend auf der Anzahl der Repositorys und der Anzahl der Benutzer in der Organisation erhöht werden können. Weitere Informationen finden Sie unter [Preisbeschränkungen für GitHub Apps](/de/apps/creating-github-apps/registering-a-github-app/rate-limits-for-github-apps).\n\nZiehe nach Möglichkeit die Verwendung bedingter Anforderungen und das Abonnieren von Webhooks anstelle von Abfragen in Betracht, damit die Ratenlimits nicht überschritten werden. Weitere Informationen zu bedingten Anforderungen findest du unter [Bewährte Methoden für die Verwendung der REST-API](/de/rest/using-the-rest-api/best-practices-for-using-the-rest-api). Weitere Informationen zur Verwendung von Webhooks mit Ihrem GitHub App finden Sie in [Verwenden von Webhooks mit GitHub Apps](/de/apps/creating-github-apps/registering-a-github-app/using-webhooks-with-github-apps) und [Erstellen einer GitHub-App, die auf Webhook-Ereignisse reagiert](/de/apps/creating-github-apps/writing-code-for-a-github-app/building-a-github-app-that-responds-to-webhook-events).\n\n#### Testen des Codes\n\nTesten Sie Das neue GitHub App , um sicherzustellen, dass Ihr Code wie erwartet funktioniert.\n\n### 4. Machen Sie Ihr neues GitHub App bekannt\n\nWenn Sie möchten, dass andere Konten Ihr neues GitHub AppKonto verwenden können, stellen Sie sicher, dass Ihre App öffentlich ist. Wenn Sie Ihre GitHub App App besser auffindbar machen möchten, nehmen Sie Ihre App in GitHub Marketplace auf.\nWeitere Informationen finden Sie unter [Informationen zu GitHub Marketplace für Apps](/de/apps/github-marketplace/github-marketplace-overview/about-github-marketplace-for-apps) und [Erstellen einer GitHub App öffentlich oder privat](/de/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private).\n\n### 5. Auffordern von Benutzer\\*innen zur Migration\n\nSobald Ihr neues GitHub App bereit ist, weisen Sie die Benutzer Ihres alten OAuth app an, auf Ihr neues GitHub App zu migrieren. Es gibt keine Möglichkeit, die Benutzer\\*innen automatisch zu migrieren. Jeder Benutzer muss Ihre GitHub App selbst installieren und/oder autorisieren.\n\nAls App-Besitzer sollten Sie Handlungsaufrufe einbeziehen, um Ihre Benutzer aufzufordern, die neue GitHub App Autorisierung zu installieren/zu autorisieren und die Autorisierung für die alte OAuth appzu widerrufen. Auch die Dokumentation und Benutzeroberflächenelemente sollten entsprechend aktualisiert werden.\n\n#### Benutzer dazu auffordern, Ihr GitHub App zu installieren\n\nWenn Sie möchten, dass Ihre GitHub App API-Anfragen in eigenem Namen stellt oder auf Organisations- oder Repository-Ressourcen zugreift, muss der Benutzer Ihre GitHub App installieren. Wenn ein Benutzer ein GitHub App in seinem Konto oder seiner Organisation installiert, wählt er aus, auf welche Repositorys die App zugreifen kann, und erteilt der App die von ihr angeforderten Organisations- und Repository-Berechtigungen.\n\nUm Ihren Benutzern die Installation Ihres GitHub App zu erleichtern, können Sie auf der Webseite Ihrer App einen Link hinzufügen, über den Benutzer das GitHub App installieren können. Die Installations-URL hat folgendes Format: `https://github.com/apps/YOUR_APP_NAME/installations/new`. Ersetzen Sie `YOUR_APP_NAME` durch den als Slug formatierten Namen Ihrer GitHub App, den Sie im Feld „Öffentlicher Link“ auf der Einstellungsseite für Ihre GitHub App finden.\n\nUm beliebige Repositorys, auf die Ihr OAuth app Zugriff hatte, vorab auszuwählen, können Sie der Installations-URL `/permissions` und Abfrageparameter anhängen. Dies hilft Benutzern, Ihren GitHub App Zugriff auf Repositorys zu gewähren, auf die Ihr OAuth app bereits Zugriff hat. Die Abfrageparameter lauten:\n\n* `suggested_target_id`: Die ID des Benutzers oder der Organisation, der bzw. die Ihr GitHub App installiert. Dieser Parameter ist erforderlich.\n* `repository_ids[]`: Die Repository-IDs, die für die Installation ausgewählt werden sollen. Wenn keine angegeben werden, werden alle Repositorys ausgewählt. Die maximale Anzahl von Repositorys, die vorab ausgewählt werden können, beträgt 100. Um eine Liste von Repositories abzurufen, auf die OAuth app Zugriff hat, verwenden Sie die Endpunkte [Repositories für den authentifizierten Benutzer auflisten](/de/rest/repos/repos#list-repositories-for-the-authenticated-user) und [Organisations-Repositories auflisten](/de/rest/repos/repos#list-organization-repositories).\n\nBeispiel: `https://github.com/apps/YOUR_APP_NAME/installations/new/permissions?suggested_target_id=ID_OF_USER_OR_ORG&repository_ids[]=REPO_A_ID&repository_ids[]=REPO_B_ID`.\n\nWeitere Informationen zur Installation GitHub Appsfinden Sie unter [Installieren einer GitHub-App aus dem GitHub Marketplace für dein persönliches Konto](/de/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-personal-account), [Installieren einer GitHub-App aus dem GitHub Marketplace für deine Organisationen](/de/apps/using-github-apps/installing-a-github-app-from-github-marketplace-for-your-organizations),[Installieren einer GitHub-App von einem Drittanbieter](/de/apps/using-github-apps/installing-a-github-app-from-a-third-party) und [Installieren Ihrer eigenen GitHub App](/de/apps/using-github-apps/installing-your-own-github-app).\n\n#### Auffordern von Benutzer\\*innen zur Autorisierung der App\n\nWenn Ihr GitHub App API-Anfragen im Namen eines Benutzers senden soll, muss der Benutzer die App autorisieren. Wenn Benutzer*innen eine App autorisieren, gewähren sie der App die Berechtigung, in ihrem Namen zu handeln, sowie die von der App angeforderten Kontoberechtigungen. Wenn die App in einem Organisationskonto installiert ist, muss jede*r Benutzer\\*in innerhalb dieser Organisation die App autorisieren, damit die App in dessen oder deren Namen handeln kann.\n\nFühre die Benutzer\\*innen durch den Webanwendungs- oder Geräteablauf zur Autorisierung deiner App. Weitere Informationen finden Sie unter [Generieren eines Benutzerzugriffstokens für eine GitHub App](/de/apps/creating-github-apps/authenticating-with-a-github-app/generating-a-user-access-token-for-a-github-app).\n\nWeitere Informationen zur Autorisierung GitHub Appsfinden Sie unter [Autorisieren von GitHub Apps](/de/apps/using-github-apps/authorizing-github-apps).\n\n#### Ermutigen Sie Ihre Nutzer, ihren Zugriff OAuth app zu widerrufen.\n\nSie sollten Ihre Benutzer auch dazu ermutigen, den Zugriff für Ihre alte OAuth app zu widerrufen. Dies wird Ihnen helfen, vollständig von Ihrem OAuth app zu migrieren, und dazu beitragen, die Daten Ihrer Nutzer sicher zu halten. Weitere Informationen finden Sie unter [Überprüfen der autorisierten OAuth-Apps](/de/apps/oauth-apps/using-oauth-apps/reviewing-your-authorized-oauth-apps).\n\n#### Aktualisieren von Benutzeroberflächen oder Dokumentationen\n\nSie sollten jede Benutzeroberfläche oder Dokumentation im Zusammenhang mit Ihrer App aktualisieren, um die Änderung von einem OAuth app zu einem GitHub App widerzuspiegeln.\n\n### 6. Entfernen von Webhooks für Ihre alte OAuth app\n\nWenn ein Benutzer Ihre GitHub App installiert und Zugriff auf ein Repository gewährt, sollten Sie alle Webhooks für Ihre alte OAuth app entfernen. Wenn Ihre neue GitHub App und Ihre alte OAuth app auf Webhooks für dasselbe Ereignis reagieren, kann der Benutzer doppelte Reaktionen feststellen.\n\nUm Repositorywebhooks zu entfernen, kannst du dem `installation_repositories`-Webhook mit der `added`-Aktion lauschen. Wenn Ihr GitHub App dieses Ereignis empfängt, können Sie die REST-API verwenden, um den Webhook in diesen Repositorys für Ihr OAuth app zu löschen. Weitere Informationen findest du unter [Webhook-Ereignisse und Webhook-Nutzlasten](/de/webhooks/webhook-events-and-payloads?actionType=added#installation_repositories) und [REST-API-Endpunkte für Repository-Webhooks](/de/rest/repos/webhooks#delete-a-repository-webhook).\n\nUm Organisationswebhooks zu entfernen, kannst du dem `installation`-Webhook mit der `created`-Aktion lauschen. Wenn Ihr GitHub App dieses Ereignis für eine Organisation empfängt, können Sie die REST-API verwenden, um den Webhook für diese Organisation und die zugehörigen Repositorys für Ihr OAuth app zu löschen. Weitere Informationen findest du unter [Webhook-Ereignisse und Webhook-Nutzlasten](/de/webhooks/webhook-events-and-payloads?actionType=created#installation), [REST-API-Endpunkte für Organisationswebhooks](/de/rest/orgs/webhooks#delete-an-organization-webhook) und [REST-API-Endpunkte für Repository-Webhooks](/de/rest/repos/webhooks#delete-a-repository-webhook).\n\n### 7. Löschen Sie Ihre alte OAuth app\n\nNachdem Ihre Benutzer zu Ihrem neuen GitHub Appmigriert haben, sollten Sie Die alte OAuth applöschen. Dadurch wird verhindert, dass die Anmeldeinformationen von OAuth app missbraucht werden. Mit dieser Aktion werden auch alle verbleibenden Autorisierungen von OAuth app widerrufen. Weitere Informationen finden Sie unter [Löschen einer OAuth-App](/de/apps/oauth-apps/maintaining-oauth-apps/deleting-an-oauth-app). Wenn Ihr OAuth app auf GitHub Marketplace aufgeführt ist, müssen Sie sich möglicherweise zuerst an GitHub-Support wenden, um Ihre App aus dem Marktplatz zu entfernen."}