Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.
All products
Apps

Diese Version von GitHub Enterprise wurde eingestellt am 2023-03-15. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für bessere Leistung, verbesserte Sicherheit und neue Features aktualisiere auf die neueste Version von GitHub Enterprise. Wende dich an den GitHub Enterprise-Support, um Hilfe zum Upgrade zu erhalten.

Erstellen einer GitHub-App

Du kannst eine GitHub-App unter deinem persönlichen Konto oder unter einer beliebigen Organisation erstellen und registrieren, auf die du Administatorzugriff besitzt.

  1. Navigiere zu den Einstellungen für dein Konto.

    • Wenn es sich um eine GitHub App im Besitz eines persönlichen Kontos handelt, klicke in der rechten oberen Ecke einer beliebigen Seite auf dein Profilfoto und dann auf Einstellungen. Symbol „Einstellungen“ auf der Benutzerleiste
    • Wenn es sich um eine GitHub App im Besitz einer Organisation handelt, klicke in der oberen rechten Ecke einer beliebigen Seite auf dein Profilfoto und dann auf Deine Organisationen. Klicke dann rechts neben der Organisation auf Einstellungen. Deine Organisationen im Profilmenü Schaltfläche „Einstellungen“

  2. Klicken Sie in der linken Seitenleiste auf Entwicklereinstellungen. Entwicklereinstellungen 1. Klicke auf der linken Randleiste auf GitHub-Apps. Abschnitt „GitHub-Apps“

  3. Klicke auf Neue GitHub-App.

  4. Gib in „GitHub-App-Name“ den Namen deiner App ein.

    Gib deiner App einen klaren und kurzen Namen. Deine App kann nicht denselben Namen wie ein vorhandenes GitHub-Konto haben, es sei denn, es handelt sich um deinen eigenen Benutzer- oder Organisationsnamen. Eine Slugversion des Namens deiner App wird in der Benutzeroberfläche angezeigt, wenn deine Integration eine Aktion ausführt.

  5. Gib optional unter „Beschreibung“ eine Beschreibung deiner App ein, die Benutzern angezeigt wird.

  6. Gib unter „Homepage-URL“ die vollständige URL der Website deiner App ein.

  7. Gib in „Rückruf-URL“ die vollständige URL ein, zu der umgeleitet werden soll, nachdem ein Benutzer die Installation autorisiert hat. Diese URL wird verwendet, wenn deine App Benutzer-zu-Server-Anforderungen identifizieren und autorisieren muss.

    Über die Schaltfläche Rückruf-URL hinzufügen kannst du maximal 10 zusätzliche Rückruf-URLs bereitstellen.

  8. Um die Sicherheit deiner App zu verbessern, verwendet deine App standardmäßig ablaufende Benutzerberechtigungstoken. Um die Verwendung ablaufender Benutzertoken zu deaktivieren, musst du „Benutzerautorisierungs-Token ablaufen lassen“ deaktivieren. Weitere Informationen zum Einrichten eines Aktualisierungstokenflows und der Vorteile des Ablaufs von Benutzertoken findest du unter Aktualisieren von Benutzerzugriffstoken.

  9. Wenn deine App Benutzer mit dem OAuth-Flow autorisiert, kannst du Während der Installation „Benutzerautorisierung anfordern (OAuth)“ auswählen auswählen, damit die Benutzer die App autorisieren können, wenn sie sie installieren, und dabei einen Schritt sparen. Wenn du diese Option auswählst, ist die „Setup-URL“ nicht mehr verfügbar, und Benutzer werden nach der Installation der App zu deiner „Rückruf-URL für Benutzerautorisierung“ umgeleitet. Weitere Informationen findest du unter Installieren von GitHub-Apps.

  10. Wenn nach der Installation zusätzliche Setups erforderlich sind, füge eine „Setup-URL“ hinzu, um Benutzer dorthin umzuleiten, nachdem sie deine App installiert haben.

    Hinweis: Wenn du im vorherigen Schritt Während der Installation „Benutzerautorisierung anfordern (OAuth)“ auswählen ausgewählt hast, ist dieses Feld nicht mehr verfügbar, und die Benutzer werden nach der Installation der App zur „Rückruf-URL für Benutzerautorisierung“ umgeleitet.

  11. Gib unter „Webhook-URL“ die URL ein, an die die Ereignisse GEPOSTET werden sollen. Jede App erhält einen eigenen Webhook, der dich jedes Mal benachrichtigt, wenn die App installiert oder geändert wird, sowie über alle anderen Ereignisse, die die App abonniert hat.

  12. Gib optional unter „Webhook-Geheimnis“ ein optionales geheimes Token ein, das zum Sichern deines Webhooks verwendet wird.

    Hinweis: Es wird dringend empfohlen, ein geheimes Token festzulegen. Weitere Informationen findest du unter Sobald dein Server für das Erhalten von Nutzdaten konfiguriert ist, lauscht dieser auf jegliche Nutzdaten, die zu dem von dir konfigurierten Endpunkt gesendet werden..

  13. Wähle unter „Berechtigungen“ die Berechtigungen aus, die deine App anfordert. Verwende für jeden Berechtigungstyp das Dropdownmenü, und wähle Schreibgeschützt, Lesen & schreiben oder Kein Zugriff aus.

  14. Wähle in „Ereignisse abonnieren“ die Ereignisse aus, die deine App empfangen soll.

  15. Um auszuwählen, wo die App installiert werden kann, wähle entweder Nur auf diesem Konto oder Beliebiges Konto aus. Weitere Informationen zu den Installationsoptionen findest du unter Making a GitHub App public or private.

  16. Klicke auf GitHub-App erstellen.