# Registrieren einer GitHub-App

Sie können ein GitHub App unter Ihrem persönlichen Konto oder unter einer Organisation, die Ihnen gehört, registrieren.

## Informationen zur Registrierung GitHub Apps

Sie können ein GitHub App auf verschiedene Arten registrieren.

* Unter Ihrem **persönlichen Konto**.
* Unter einer **-Organisation, die Sie besitzen**.
* Unter einer **Organisation**, die Ihnen die Berechtigung zum Verwalten aller zugehörigen Apps erteilt hat. Siehe [Hinzufügen und Entfernen von GitHub App-Managern in Ihrer Organisation](/de/organizations/managing-programmatic-access-to-your-organization/adding-and-removing-github-app-managers-in-your-organization).

Eine benutzende Person oder eine Organisation kann bis zu 100 GitHub Apps registrieren, aber es gibt keine Begrenzung für die GitHub Apps, die in einem Konto installiert werden können.

## Registrierung eines GitHub App

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**.

3. 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**.

4. Klicke auf der linken Randleiste auf **GitHub Apps** .

5. Klicken Sie auf **"Neu" GitHub App**.

6. Geben Sie unter "GitHub App Name" einen Namen für Ihre App ein. Du solltest einen klaren und kurzen Namen auswählen. Der Name darf nicht länger als 34 Zeichen sein. Der Name deiner App (in Kleinbuchstaben konvertiert, Leerzeichen ersetzt durch `-` und Sonderzeichen ersetzt) wird auf der Benutzeroberfläche angezeigt, wenn deine App eine Aktion ausführt.
   `My APp Näme` wird beispielsweise als `my-app-name` angezeigt.

   Der Name muss im gesamten GitHub eindeutig sein. Sie können nicht denselben Namen wie ein vorhandenes GitHub Konto verwenden, es sei denn, es handelt sich um Ihren eigenen Benutzer- oder Organisationsnamen.

7. Gib optional unter „Beschreibung“ eine Beschreibung für deine App ein. Benutzenden wird diese Beschreibung angezeigt, wenn sie deine App installieren.

8. Gib unter „Homepage-URL“ die vollständige URL der Website deiner App ein. Wenn du nicht über eine dedizierte URL verfügst und der Code deiner App in einem öffentlichen Repository gespeichert ist, kannst du diese Repository-URL verwenden. Alternativ kannst du die URL des Kontos verwenden, das die App besitzt.

9. Gib optional unter „Rückruf-URL“ die vollständige URL ein, zu der umgeleitet werden soll, nachdem Benutzer\*innen die Installation autorisiert haben.

   Du kannst bis zu zehn Rückruf-URLs eingeben. Um zusätzliche Rückruf-URLs hinzuzufügen, klicke auf **Rückruf-URL hinzufügen**.

   Wenn deine App nicht im Namen von Benutzer\*innen handeln muss (Generieren eines Benutzerzugriffstokens nicht erforderlich), wird dieses Feld ignoriert. Wenn deine App den Geräteablauf anstelle des Webanwendungsablaufs verwendet, um ein Benutzerzugriffstoken zu generieren, wird dieses Feld ignoriert.

   Weitere Informationen zur Rückruf-URL findest du unter [Informationen zur Rückruf-URL für die Benutzerautorisierung](/de/apps/creating-github-apps/registering-a-github-app/about-the-user-authorization-callback-url). Weitere Informationen zum Generieren eines Benutzerzugriffstokens für Aktionen im Namen anderer Benutzer findest du 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) und [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).

10. Um zu verhindern, dass Benutzerzugriffstoken ablaufen, kannst du optional die Option **Benutzerautorisierungstoken ablaufen lassen** deaktivieren.
    GitHub empfiehlt dringend, diese Option ausgewählt zu lassen. Weitere Informationen zum Aktualisieren abgelaufener Tokens und den Vorteilen von Benutzerzugriffstoken, die ablaufen, findest du unter [Aktualisieren von Benutzerzugriffstoken](/de/apps/creating-github-apps/authenticating-with-a-github-app/refreshing-user-access-tokens). Wenn deine App kein Benutzerzugriffstoken generieren muss, wird dieses Feld ignoriert.

11. Optional kannst du **Benutzerautorisierung (OAuth) während der Installation anfordern** aktivieren, um Benutzer*innen bei der Installation deiner App aufzufordern, diese zu autorisieren. Wenn Benutzer*innen deine App autorisieren, kann die App ein Benutzerzugriffstoken generieren, um API-Anforderungen im Namen der Benutzer*innen zu stellen und den Benutzer*innen App-Aktivitäten zuzuordnen. Weitere Informationen findest du 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) und [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).

12. Optional kannst du, falls du den Gerätefluss zum Generieren eines Benutzerzugriffstokens verwenden möchtest, **Gerätefluss aktivieren** auswählen. 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).

13. Gib optional unter „Setup-URL“ die URL ein, zu der Benutzer*innen nach der Installation deiner App weitergeleitet werden sollen. Wenn nach der Installation ein zusätzliches Setup erforderlich ist, kannst du diese URL verwenden, um Benutzer*innen mitzuteilen, welche Schritte nach der Installation ausgeführt werden müssen. Weitere Informationen finden Sie unter [Informationen zur Setup-URL](/de/apps/creating-github-apps/registering-a-github-app/about-the-setup-url).

    Wenn du **Benutzerautorisierung (OAuth) während der Installation anfordern** in einem früheren Schritt aktiviert hast, kannst du hier keine URL eingeben. Benutzer\*innen werden im Rahmen des Autorisierungsvorgangs stattdessen zur Rückruf-URL weitergeleitet, wo du das zusätzliche Setup beschreiben kannst.

14. 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.

15. Optional kannst du **Aktiv** deaktivieren, wenn deine App keine Webhookereignisse empfangen soll. Wenn deine App beispielsweise nur für die Authentifizierung verwendet wird oder nicht auf Webhooks reagieren muss, deaktiviere diese Option. 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).

16. Wenn Sie im vorherigen Schritt **"Aktiv"** ausgewählt haben, geben Sie unter "Webhook-URL" die URL GitHub ein, an die Webhook-Ereignisse gesendet werden sollen. 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).

17. Optional, wenn du im vorherigen Schritt **Aktiv** ausgewählt hast, gib unter "Webhook-Geheimnis" ein geheimes Token ein, um deine Webhooks zu schützen.
    GitHub empfiehlt dringend, ein Webhook-Geheimnis festzulegen. 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).

18. Wenn du eine Webhook-URL eingegeben hast, wähle unter „SSL-Überprüfung“ aus, ob die SSL-Überprüfung aktiviert werden soll.
    GitHub empfiehlt dringend, die SSL-Überprüfung zu aktivieren.

19. Wähle unter „Berechtigungen“ die Berechtigungen aus, die deine App benötigt. Verwende für jede Berechtigung das Dropdownmenü, und klicke auf **Nur-Lesen**, **Lesen und Schreiben** oder **Kein Zugriff**. Du solltest die mindestens erforderlichen Berechtigungen für deine App auswählen. 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).

20. Wenn du im vorherigen Schritt **Aktiv** ausgewählt hast, um anzugeben, dass deine App Webhookereignisse empfangen soll, wähle unter „Ereignisse abonnieren“ die Webhookereignisse aus, die deine App empfangen soll. Die Berechtigungen, die du im vorherigen Schritt ausgewählt hast, legen fest, welche Webhookereignisse verfügbar sind. Weitere Informationen zu den einzelnen Webhookereignissen findest du unter [Webhook-Ereignisse und Webhook-Nutzlasten](/de/webhooks/webhook-events-and-payloads).

21. Wählen Sie unter „Wo kann dieses GitHub App installiert werden?“ **Nur auf diesem Konto** oder **Jedes Konto** aus. Weitere Informationen zu Installationsoptionen finden Sie unter [Erstellen einer GitHub App öffentlich oder privat](/de/apps/creating-github-apps/registering-a-github-app/making-a-github-app-public-or-private).

22. Klicken Sie auf **Erstellen GitHub App**.

## Nächste Schritte

Nachdem Sie ein GitHub App registriert haben, möchten Sie Code schreiben, damit Ihr GitHub App etwas tut. Beispiele für das Schreiben von Code findest du unter:

* [Schnellstart zum Erstellen von GitHub Apps](/de/apps/creating-github-apps/writing-code-for-a-github-app/quickstart)
* [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)
* [Erstellen einer Schaltfläche "Anmelden mit GitHub" mit einer GitHub-App](/de/apps/creating-github-apps/writing-code-for-a-github-app/building-a-login-with-github-button-with-a-github-app)
* [Erstellen einer CLI mit einer GitHub-App](/de/apps/creating-github-apps/writing-code-for-a-github-app/building-a-cli-with-a-github-app)
* [Erstellen authentifizierter API-Anforderungen mit einer GitHub App in einem GitHub Actions-Workflow](/de/apps/creating-github-apps/authenticating-with-a-github-app/making-authenticated-api-requests-with-a-github-app-in-a-github-actions-workflow)

Du solltest versuchen, bewährten Methoden zu folgen. Weitere Informationen finden Sie unter [Bewährte Methoden zum Erstellen einer GitHub-App](/de/apps/creating-github-apps/about-creating-github-apps/best-practices-for-creating-a-github-app).

Sobald Ihr GitHub App vollständig erstellt ist, können Sie Ihr GitHub App installieren und Ihr GitHub App mit anderen teilen. Weitere Informationen findest du unter [Installieren Ihrer eigenen GitHub App](/de/apps/using-github-apps/installing-your-own-github-app) und [Freigeben deiner GitHub-App](/de/apps/sharing-github-apps/sharing-your-github-app).

Sie können jederzeit Änderungen an den Einstellungen für Ihre GitHub App vornehmen. Weitere Informationen finden Sie unter [Ändern einer GitHub App-Registrierung](/de/apps/maintaining-github-apps/modifying-a-github-app-registration).