OpenAI
Denne side er maskinoversat. Se den originale engelske artikel.

Opsæt GitHub Enterprise-appskabelonen i ChatGPT

Få mere at vide om, hvordan arbejdsområdeadministratorer kan konfigurere GitHub Enterprise-appskabelonen i ChatGPT med organisationens egen GitHub App.

Opdateret: 2 days ago

Oversigt

Brug denne vejledning, hvis du er administrator for et ChatGPT-arbejdsområde og opsætter GitHub Enterprise-appskabelonen til din organisation. En skabelon er ikke den færdige app, som medlemmerne bruger. Det er en opsætningsproces, der opretter en appkladde til det specifikke arbejdsområde, når du har angivet den nødvendige GitHub Enterprise-konfiguration.

For GitHub Enterprise forbinder opsætningen ChatGPT med din organisations GitHub Enterprise-vært. Du opretter en GitHub-app, registrerer callback-URL'en fra ChatGPT og genererer legitimationsoplysninger. Derefter indsætter du værdierne i skabelonopsætningen i ChatGPT. Når ChatGPT har oprettet appkladden, kan du udgive og administrere den ligesom andre apps i arbejdsområdet.

Læs om navigation i arbejdsområdet og adgang til apps i: Administrationsindstillinger, sikkerhed og compliance for plugins og apps.

Det opsætter du

Du opretter en GitHub Enterprise-app i ChatGPT til et specifikt arbejdsområde. Appen bruger:

  • En GitHub-app, der er registreret på din GitHub Enterprise-vært.

  • GitHub-appens klient-ID og klienthemmelighed til brugergodkendelse via OAuth.

  • GitHub-appens private nøgle, så ChatGPT kan generere installationstokens til handlinger i lagre.

  • En webhook-hemmelighed og en webhook-URL, så GitHub Enterprise kan sende installations- og lagerhændelser tilbage til ChatGPT.

  • Dit GitHub Enterprise-værtsnavn, f.eks. github.example.com.

Opret en GitHub-app, ikke en selvstændig GitHub OAuth-app. Skabelonopsætningen i ChatGPT kræver legitimationsoplysninger til en GitHub-app, en privat nøgle og webhook-indstillinger.

Før du starter

Du skal bruge:

  • Administrator- eller ejeradgang til ChatGPT-arbejdsområdet.

  • Adgang som administrator eller organisationsejer i GitHub Enterprise med tilladelse til at oprette og installere GitHub-apps.

  • Kun værtsnavnet for GitHub Enterprise, uden https:// eller en sti.

  • En beslutning om, hvilke handlinger i lagre ChatGPT skal understøtte, f.eks. lagersøgning med kun læseadgang, workflows for pull requests og issues, filredigering, GitHub Actions eller mere omfattende Codex-workflows.

  • Et sikkert sted at håndtere GitHub-appens private nøgle og klienthemmelighed.

Hold ChatGPT og GitHub Enterprise åbne i separate faner. Find ikke selv på en callback-URL. Kopiér den nøjagtige callback-URL, der vises i ChatGPT.

Værdier, du skal have klar

  • GitHub Enterprise-værtsnavn: f.eks. github.example.com.

  • Callback-URL: Kopiér den fra skabelonopsætningen i ChatGPT.

  • GitHub-appens klient-ID.

  • GitHub-appens klienthemmelighed.

  • GitHub-appens private nøgle i PEM-format.

  • Webhook-hemmelighed genereret af ChatGPT.

  • Webhook-URL genereret efter oprettelsen af appkladden i ChatGPT.

Start opsætningen af skabelonen i ChatGPT

  1. Skift til det arbejdsområde i ChatGPT, hvor appen skal være tilgængelig.

  2. Åbn Indstillinger for arbejdsområde > Apps. Du kan også gå til Administrationskonsollen, vælge det ønskede ChatGPT-arbejdsområde og åbne Plugins. Vælg Administrer ældre apps for at åbne den bevarede Apps-side.

  3. Vælg Katalog.

  4. Søg efter GitHub Enterprise.

  5. Vælg appskabelonen til GitHub Enterprise, og start opsætningen.

  6. Angiv et tydeligt navn og en beskrivelse til appen, f.eks. GitHub Enterprise eller GitHub Enterprise – Udvikling.

  7. Angiv værtsnavnet for GitHub Enterprise, f.eks. github.example.com.

  8. Kopiér den callback-URL, der vises i ChatGPT. Lad denne fane være åben.

  9. Kopiér den genererede webhook-hemmelighed, hvis den vises under opsætningen.

Eksempel på callback-URL: https://chatgpt.com/connector/oauth/<callback_id>

Du må ikke fjerne callback-ID'et, tilføje en afsluttende skråstreg eller erstatte URL'en med en generisk ChatGPT-URL.

Opret GitHub-appen i GitHub Enterprise

  1. Åbn din GitHub Enterprise-vært, f.eks. https://github.example.com.

  2. Gå til den organisation eller konto, der skal eje appen.

  3. Åbn Indstillinger > Udviklerindstillinger > GitHub-apps.

  4. Vælg Ny GitHub-app.

  5. Giv appen et tydeligt navn, f.eks. ChatGPT GitHub Enterprise.

  6. Angiv en URL til hjemmesiden. Hvis der ikke findes en særskilt intern side, skal du bruge URL'en til GitHub Enterprise-organisationen.

  7. Indsæt den nøjagtige callback-URL, du kopierede fra ChatGPT, i feltet Callback-URL.

  8. Lad indstillingen Lad brugergodkendelsestokens udløbe være aktiveret, medmindre dit sikkerhedsteam har en konkret grund til at ændre den.

  9. Aktivér Anmod om brugergodkendelse under installationen, så brugerne kan godkende appen under installationen eller tilslutningen.

  10. Under Hvor kan denne GitHub-app installeres? skal du vælge den mest begrænsede mulighed, der passer til din udrulning.

  11. Opret GitHub-appen.

Konfigurer tilladelser og hændelser

Vælg kun de tilladelser, der er nødvendige for de ChatGPT-handlinger, du vil aktivere.

Hvis du kun vil finde lagre og stille spørgsmål om dem uden at foretage ændringer, kan du starte med læsetilladelser som:

  • Metadata: skrivebeskyttet. GitHub kræver adgang til metadata for GitHub-apps.

  • Indhold: skrivebeskyttet, til adgang til filer og lagerindhold.

  • Issues: skrivebeskyttet, hvis der er behov for at søge efter eller læse issues.

  • Pull requests: skrivebeskyttet, hvis der er behov for at søge efter pull requests eller få kontekst til kodegennemgang.

  • Handlinger: skrivebeskyttet, hvis der er behov for status for workflowkørsler, job, logfiler eller artefakter.

Ved workflows med skriveadgang skal du kun tilføje skrivetilladelser, hvor der er behov for dem, f.eks. Indhold, Pull requests, Issues, Handlinger eller Workflows. Begræns tilladelserne mest muligt, så de kun understøtter de ønskede ChatGPT-handlinger.

Webhook-hændelser skal svare til de workflows, du understøtter. Almindelige hændelser omfatter Installation, Installationslagre, Push, Pull request, Issues, Kommentar til issue, Workflowkørsel og Workflowjob.

Generér og kopiér legitimationsoplysninger til GitHub-appen

  1. Kopiér Klient-ID i GitHub-appens indstillinger.

  2. Generér en Klienthemmelighed, og kopiér den med det samme.

  3. Generér en privat nøgle under Private nøgler.

  4. Download .pem-filen, og opbevar den sikkert.

  5. Åbn .pem-filen lokalt, og kopiér hele PEM-teksten, inklusive start- og slutlinjerne.

Den private nøgle er fortrolig. Behandl den som en legitimationsoplysning. Hvis den bliver eksponeret, skal du generere en ny privat nøgle, opdatere appopsætningen i ChatGPT og slette den kompromitterede nøgle i GitHub Enterprise.

Fuldfør opsætningen i ChatGPT

  1. Gå tilbage til fanen med skabelonopsætningen i ChatGPT.

  2. Indsæt GitHub-appens klient-ID i OAuth-klient-ID.

  3. Indsæt GitHub-appens klienthemmelighed i OAuth-klienthemmelighed.

  4. Lad Omfang være uændret, medmindre din organisation har et konkret behov for at tilsidesætte skabelonens standardindstillinger.

  5. Kontrollér, at værtsnavnet for GitHub Enterprise kun indeholder selve værtsnavnet, f.eks. github.example.com.

  6. Indsæt eller upload GitHub-appens private nøgle i PEM-format i feltet Privat nøgle til GitHub-app.

  7. Kontrollér, at den genererede webhook-hemmelighed er angivet.

  8. Opret appkladden.

  9. Åbn oplysningerne om den oprettede appkladde i ChatGPT, og kopiér den genererede webhook-URL.

Webhook-URL'en skal se sådan ud: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Fuldfør webhook-opsætningen i GitHub Enterprise

  1. Gå tilbage til GitHub-appens indstillinger i GitHub Enterprise.

  2. Åbn GitHub-appens generelle indstillinger.

  3. Slå Aktive webhooks til, hvis de ikke allerede er aktiveret.

  4. Indsæt webhook-URL'en fra ChatGPT i feltet Webhook-URL.

  5. Indsæt webhook-hemmeligheden fra ChatGPT i feltet Webhook-hemmelighed.

  6. Lad SSL-verificering være aktiveret.

  7. Kontrollér, at de webhook-hændelser, du abonnerer på, svarer til de tilladelser og handlinger, du har aktiveret.

  8. Gem ændringerne.

Udgiv og administrer appen i ChatGPT

Når du opretter appen som kladde, bliver den ikke automatisk tilgængelig for medlemmerne. Når du har gennemgået kladden:

  1. Udgiv appkladden.

  2. Åbn siden Apps i indstillingerne for arbejdsområdet, åbn Aktiveret, og kontrollér, at appen vises. Du kan også åbne siden Apps via Administrer ældre apps i Administrationskonsol > Plugins.

  3. I Enterprise og Edu kan du bruge Brugeradgang til at vælge, hvilke roller der kan bruge appen. I Business administrerer du appens tilgængelighed for hele arbejdsområdet.

  4. Gennemgå Handlingsstyring for læse- og skrivehandlinger.

  5. Gennemgå Apptilladelser for at vælge, hvornår ChatGPT skal spørge medlemmerne, før appen bruges.

  6. Bed en testbruger med adgang om at åbne Apps i ChatGPT og kontrollere, at appen vises.

Disse apptilladelser gælder for samtaler i ChatGPT. Arbejdsområdeagenter bruger individuelle indstillinger, som agentens opretter angiver, til at afgøre, hvilke apphandlinger der er tilgængelige, og hvornår slutbrugerne bliver bedt om at godkende dem. Læs om agenters adfærd i ChatGPT-arbejdsområdeagenter til Enterprise og Business.

Installer og test GitHub-appen

  1. Installer GitHub-appen på organisationen eller kontoen i GitHub Enterprise.

  2. Vælg alle lagre eller udvalgte lagre i henhold til arbejdsområdets politik.

  3. Start tilslutningsprocessen fra ChatGPT som en bruger med adgang.

  4. Godkend GitHub-appen, når du bliver bedt om det.

  5. Udfør først en enkel læsehandling, f.eks. at vise en liste over tilgængelige lagre eller hente en kendt pull request.

  6. Hvis skrivehandlinger er aktiveret, skal du teste dem i et lager med lav risiko, før appen udrulles bredere.

Værtsnavn og OAuth-adfærd

ChatGPT bruger værtsnavnet til at udlede GitHub Enterprise-endpoints. Angiv kun værtsnavnet, f.eks. github.example.com eller octocorp.ghe.com.

Angiv ikke en API-sti, en lagersti eller github.com, medmindre det er den præcise GitHub Enterprise-vært for denne app.

Fejlfinding

  • Omdirigerings-URI stemmer ikke overens: Kontrollér, at GitHub-appens callback-URL er nøjagtig den samme som den callback-URL, der vises i ChatGPT.

  • ChatGPT kan ikke oprette eller gemme appkladden: Kontrollér, at alle obligatoriske felter er udfyldt, herunder værtsnavn, OAuth-klient-ID, OAuth-klienthemmelighed, privat nøgle og webhook-hemmelighed.

  • Godkendelsen lykkes, men kald til lagre mislykkes: Kontrollér, at GitHub-appen er installeret og har adgang til lageret.

  • API'et returnerer 403 eller utilstrækkelige tilladelser: Tilføj den manglende tilladelse til GitHub-appen, og bed installationens ejer om at godkende de opdaterede tilladelser, hvis der anmodes om det.

  • Ingen lagre vises: Kontrollér, at appinstallationen omfatter de forventede lagre, og at den bruger, der giver godkendelse i ChatGPT, har adgang til dem.

  • Webhook-leveringer mislykkes: Kontrollér, at webhook-URL'en og webhook-hemmeligheden stemmer overens med værdierne fra ChatGPT. Lad SSL-verificering være aktiveret, og sørg for, at GitHub Enterprise-værten kan nå connectors.api.openai.org.

  • Fejl med den private nøgle: Kontrollér, at hele PEM-indholdet er kopieret, inklusive start- og slutlinjerne.

Referencer

Var denne artikel nyttig?