OpenAI
Diese Seite wurde maschinell übersetzt. Den Originalartikel auf Englisch ansehen.

GitHub Enterprise-App-Vorlage in ChatGPT einrichten

Erfahre, wie Workspace-Admins die GitHub Enterprise-App-Vorlage in ChatGPT mit der eigenen GitHub App ihrer Organisation konfigurieren können.

Aktualisiert: 10 days ago

Übersicht

Nutze diese Anleitung, wenn du als ChatGPT-Workspace-Admin die GitHub Enterprise-App-Vorlage für deine Organisation einrichtest. Eine Vorlage ist nicht die finale App, die Mitglieder verwenden. Sie ist ein Einrichtungsablauf, der eine workspace-spezifische Entwurfs-App erstellt, nachdem du die erforderliche GitHub Enterprise-Konfiguration angegeben hast.

Für GitHub Enterprise verbindet die Einrichtung ChatGPT mit dem GitHub Enterprise-Host deiner Organisation. Du erstellst eine GitHub App, registrierst die ChatGPT-Callback-URL, generierst Anmeldedaten und fügst diese Werte anschließend in den Einrichtungsablauf der ChatGPT-Vorlage ein. Nachdem ChatGPT die Entwurfs-App erstellt hat, kannst du sie veröffentlichen und wie andere Workspace-Apps verwalten.

Was du einrichtest

Du erstellst in ChatGPT eine workspace-spezifische GitHub Enterprise-App. Die App verwendet:

  • Eine auf deinem GitHub Enterprise-Host registrierte GitHub App.

  • Die Client-ID und das Client-Secret der GitHub App für die OAuth-Autorisierung von Nutzer:innen.

  • Den privaten Schlüssel der GitHub App, damit ChatGPT Installations-Token für Repository-Vorgänge ausstellen kann.

  • Ein Webhook-Secret und eine Webhook-URL, damit GitHub Enterprise Installations- und Repository-Ereignisse an ChatGPT zurücksenden kann.

  • Deinen GitHub Enterprise-Hostnamen, zum Beispiel github.example.com.

Erstelle eine GitHub App, keine eigenständige GitHub OAuth App. Die Einrichtung der ChatGPT-Vorlage erfordert GitHub App-Anmeldedaten, einen privaten Schlüssel und Webhook-Einstellungen.

Bevor du beginnst

Du benötigst:

  • Admin- oder Inhaber:innenzugriff für den ChatGPT-Workspace.

  • Admin- oder Organisationsinhaber:innenzugriff für GitHub Enterprise, mit dem GitHub Apps erstellt und installiert werden können.

  • Nur den GitHub Enterprise-Hostnamen, ohne https:// oder Pfad.

  • Eine Entscheidung darüber, welche Repository-Aktionen ChatGPT unterstützen soll, etwa schreibgeschützte Repository-Suche, Pull Request-Workflows, Issue-Workflows, Dateibearbeitungen, GitHub Actions oder breitere Codex-Workflows.

  • Einen sicheren Ort für den Umgang mit dem privaten Schlüssel und dem Client-Secret der GitHub App.

Lass ChatGPT und GitHub Enterprise in separaten Tabs geöffnet. Erfinde die Callback-URL nicht. Kopiere die exakte in ChatGPT angezeigte Callback-URL.

Vorzubereitende Werte

  • GitHub Enterprise-Hostname: zum Beispiel github.example.com.

  • Callback-URL: Kopiere sie aus dem Einrichtungsablauf der ChatGPT-Vorlage.

  • Client-ID der GitHub App.

  • Client-Secret der GitHub App.

  • PEM des privaten Schlüssels der GitHub App.

  • Von ChatGPT generiertes Webhook-Secret.

  • Webhook-URL, die nach dem Erstellen der Entwurfs-App in ChatGPT generiert wird.

Vorlageneinrichtung in ChatGPT starten

  1. Wechsle in ChatGPT zu dem Workspace, in dem die App verfügbar sein soll.

  2. Öffne Workspace-Einstellungen > Apps.

  3. Wähle Verzeichnis aus.

  4. Suche nach GitHub Enterprise.

  5. Wähle die App-Vorlage für GitHub Enterprise aus und starte die Einrichtung.

  6. Gib einen eindeutigen App-Namen und eine Beschreibung ein, zum Beispiel GitHub Enterprise oder GitHub Enterprise - Engineering.

  7. Gib den Hostnamen von GitHub Enterprise ein, zum Beispiel github.example.com.

  8. Kopiere die in ChatGPT angezeigte Callback-URL. Lass diesen Tab geöffnet.

  9. Kopiere das generierte Webhook-Secret, falls es während der Einrichtung angezeigt wird.

Beispiel für eine Callback-URL: https://chatgpt.com/connector/oauth/<callback_id>

Entferne die Callback-ID nicht, füge keinen abschließenden Schrägstrich hinzu und ersetze sie nicht durch eine generische ChatGPT-URL.

GitHub App in GitHub Enterprise erstellen

  1. Öffne deinen GitHub Enterprise-Host, zum Beispiel https://github.example.com.

  2. Gehe zu der Organisation oder dem Konto, der bzw. dem die App gehören soll.

  3. Öffne Einstellungen > Entwicklereinstellungen > GitHub Apps.

  4. Wähle Neue GitHub App aus.

  5. Gib einen eindeutigen App-Namen ein, zum Beispiel ChatGPT GitHub Enterprise Connector.

  6. Gib eine Homepage-URL ein. Wenn es keine dedizierte interne Seite gibt, verwende die URL der GitHub Enterprise-Organisation.

  7. Füge unter Callback-URL die exakte aus ChatGPT kopierte Callback-URL ein.

  8. Lass „Autorisierungs-Token für Nutzer:innen ablaufen lassen“ aktiviert, sofern dein Sicherheitsteam keinen konkreten Grund für eine Änderung hat.

  9. Aktiviere „Nutzer:innenautorisierung während der Installation anfordern“, damit Nutzer:innen die App während der Installation oder im Verbindungsablauf autorisieren können.

  10. Unter „Wo kann diese GitHub App installiert werden?“, wähle die engste Option, die zu deinem Rollout passt.

  11. Erstelle die GitHub App.

Berechtigungen und Ereignisse konfigurieren

Wähle die Mindestberechtigungen aus, die für die ChatGPT-Aktionen erforderlich sind, die du aktivieren möchtest.

Beginne für schreibgeschützte Repository-Erkennung und Fragen und Antworten mit Leseberechtigungen wie:

  • Metadaten: schreibgeschützt. GitHub erfordert Metadaten für GitHub Apps.

  • Inhalte: schreibgeschützt, für den Zugriff auf Datei- und Repository-Inhalte.

  • Issues: schreibgeschützt, wenn die Suche nach Issues oder das Lesen von Issues benötigt wird.

  • Pull Requests: schreibgeschützt, wenn die Suche nach Pull Requests oder Review-Kontext benötigt wird.

  • Actions: schreibgeschützt, wenn Status von Workflow-Ausführungen, Jobs, Logs oder Artefakte benötigt werden.

Füge für Schreib-Workflows nur dort Schreibberechtigungen hinzu, wo sie nötig sind, etwa für Inhalte, Pull Requests, Issues, Actions oder Workflows. Nutze die engsten Berechtigungen, die die vorgesehenen ChatGPT-Aktionen unterstützen.

Webhook-Ereignisse sollten zu den Workflows passen, die du unterstützt. Häufige Ereignisse sind Installation, Installations-Repositorys, Push, Pull Request, Issues, Issue-Kommentar, Workflow-Ausführung und Workflow-Job.

GitHub App-Anmeldedaten generieren und kopieren

  1. Kopiere in den GitHub App-Einstellungen die Client-ID.

  2. Generiere ein Client-Secret und kopiere es sofort.

  3. Generiere unter Private Schlüssel einen privaten Schlüssel.

  4. Lade die .pem-Datei herunter und speichere sie sicher.

  5. Öffne die .pem-Datei lokal und kopiere den vollständigen PEM-Text einschließlich der Anfangs- und Endzeilen.

Der private Schlüssel ist vertraulich. Behandle ihn wie Anmeldedaten. Falls er offengelegt wird, generiere einen neuen privaten Schlüssel, aktualisiere die ChatGPT-App-Einrichtung und lösche den kompromittierten Schlüssel in GitHub Enterprise.

Einrichtung in ChatGPT abschließen

  1. Kehre zum Tab für die ChatGPT-Vorlageneinrichtung zurück.

  2. Füge die Client-ID der GitHub App in OAuth-Client-ID ein.

  3. Füge das Client-Secret der GitHub App in OAuth-Client-Secret ein.

  4. Lass Scopes unverändert, sofern deine Organisation die Vorlagenstandards nicht bewusst überschreiben muss.

  5. Bestätige, dass der GitHub Enterprise-Hostname nur der Hostname ist, zum Beispiel github.example.com.

  6. Füge das PEM des privaten Schlüssels der GitHub App in „Privater Schlüssel der GitHub App“ ein oder lade es dort hoch.

  7. Bestätige, dass das generierte Webhook-Secret vorhanden ist.

  8. Erstelle die Entwurfs-App.

  9. Öffne die Details der erstellten Entwurfs-App in ChatGPT und kopiere die generierte Webhook-URL.

Die Webhook-URL sollte so aussehen: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Webhook-Einrichtung in GitHub Enterprise abschließen

  1. Kehre zu den GitHub App-Einstellungen in GitHub Enterprise zurück.

  2. Öffne die allgemeinen Einstellungen der GitHub App.

  3. Aktiviere aktive Webhooks, falls sie noch nicht aktiviert sind.

  4. Füge die ChatGPT-Webhook-URL in „Webhook-URL“ ein.

  5. Füge das ChatGPT-Webhook-Secret in „Webhook-Secret“ ein.

  6. Lass die SSL-Verifizierung aktiviert.

  7. Bestätige, dass die abonnierten Webhook-Ereignisse zu den aktivierten Berechtigungen und Aktionen passen.

  8. Speichere die Änderungen.

App in ChatGPT veröffentlichen und verwalten

Durch das Erstellen der Entwurfs-App ist sie nicht automatisch für Mitglieder verfügbar. Nach der Prüfung des Entwurfs:

  1. Veröffentliche die Entwurfs-App.

  2. Bestätige, dass die App unter Workspace-Einstellungen > Apps > Aktiviert angezeigt wird.

  3. Konfiguriere Nutzer:innenzugriff für die Rollen, die die App verwenden sollen.

  4. Prüfe Aktionssteuerung für Lese- und Schreibaktionen.

  5. Prüfe App-Berechtigungen, um festzulegen, wann ChatGPT Mitglieder vor der Nutzung der App fragt.

  6. Bitte eine zugelassene Testperson, Apps in ChatGPT zu öffnen und zu bestätigen, dass die App angezeigt wird.

Diese App-Berechtigungen gelten für ChatGPT-Unterhaltungen. Workspace Agents nutzen pro Agent festgelegte Steuerungen der Agent-Builder:innen, um zu bestimmen, welche App-Aktionen verfügbar sind und wann Endnutzer:innen um Genehmigung gebeten werden. Zum Agent-Verhalten siehe: ChatGPT Workspace Agents für Enterprise und Business.

GitHub App installieren und testen

  1. Installiere die GitHub App in GitHub Enterprise in der Organisation oder im Konto.

  2. Wähle gemäß der Workspace-Richtlinie alle Repositorys oder ausgewählte Repositorys aus.

  3. Starte den Verbindungsablauf aus ChatGPT als zugelassene:r Nutzer:in.

  4. Autorisiere die GitHub App, wenn du dazu aufgefordert wirst.

  5. Führe zuerst eine kleine Leseaktion aus, etwa das Auflisten zugänglicher Repositorys oder das Abrufen eines bekannten Pull Requests.

  6. Wenn Schreibaktionen aktiviert sind, teste sie vor einem breiteren Rollout mit einem risikoarmen Repository.

Hostname und OAuth-Verhalten

ChatGPT verwendet den Hostnamen, um GitHub Enterprise-Endpunkte abzuleiten. Gib nur den Host ein, zum Beispiel github.example.com oder octocorp.ghe.com.

Gib keinen API-Pfad, keinen Repository-Pfad und nicht github.com ein, sofern dies nicht der exakte GitHub Enterprise-Host für diese App ist.

Fehlerbehebung

  • Redirect URI stimmt nicht überein: Bestätige, dass die Callback-URL der GitHub App exakt mit der in ChatGPT angezeigten Callback-URL übereinstimmt.

  • ChatGPT kann die Entwurfs-App nicht erstellen oder speichern: Bestätige, dass alle erforderlichen Felder vorhanden sind, einschließlich Hostname, OAuth-Client-ID, OAuth-Client-Secret, privater Schlüssel und Webhook-Secret.

  • Authentifizierung ist erfolgreich, aber Repository-Aufrufe schlagen fehl: Bestätige, dass die GitHub App installiert ist und Zugriff auf das Repository hat.

  • API gibt 403 oder unzureichende Berechtigungen zurück: Füge die fehlende GitHub App-Berechtigung hinzu und lass die Inhaber:innen der Installation aktualisierte Berechtigungen genehmigen, falls sie dazu aufgefordert werden.

  • Es werden keine Repositorys angezeigt: Bestätige, dass die App-Installation die erwarteten Repositorys umfasst und die in ChatGPT autorisierenden Nutzer:innen Zugriff darauf haben.

  • Webhook-Zustellungen schlagen fehl: Bestätige, dass Webhook-URL und Webhook-Secret mit den Werten aus ChatGPT übereinstimmen, lass die SSL-Verifizierung aktiviert und stelle sicher, dass der GitHub Enterprise-Host connectors.api.openai.org erreichen kann.

  • Fehler bei privaten Schlüsseln: Bestätige, dass der vollständige PEM-Inhalt einschließlich der Anfangs- und Endzeilen kopiert wurde.

Referenzen

War dieser Artikel hilfreich?