OpenAI
Denne siden ble maskinoversatt. Se den opprinnelige engelske artikkelen.

Konfigurer GitHub Enterprise-appmalen i ChatGPT

Finn ut hvordan arbeidsområdeadministratorer kan konfigurere GitHub Enterprise-appmalen i ChatGPT ved hjelp av organisasjonens egen GitHub App.

Oppdatert: 7 days ago

Oversikt

Bruk denne veiledningen hvis du er administrator for et ChatGPT-arbeidsområde og skal sette opp appmalen for GitHub Enterprise for organisasjonen din. En mal er ikke den ferdige appen som medlemmene bruker. Den er en oppsettsprosess som oppretter et apputkast for arbeidsområdet etter at du har angitt den nødvendige GitHub Enterprise-konfigurasjonen.

For GitHub Enterprise kobler oppsettet ChatGPT til organisasjonens GitHub Enterprise-vert. Du oppretter en GitHub-app, registrerer tilbakeringings-URL-en fra ChatGPT, genererer påloggingsinformasjon og limer deretter inn disse verdiene i maloppsettet i ChatGPT. Når ChatGPT har opprettet apputkastet, kan du publisere og administrere det som andre apper i arbeidsområdet.

For navigasjon i arbeidsområdet og tilgang til apper, se: Administratorkontroller, sikkerhet og samsvar for programtillegg og apper.

Dette setter du opp

Du oppretter en GitHub Enterprise-app i ChatGPT som er spesifikk for arbeidsområdet. Appen bruker:

  • En GitHub-app som er registrert på GitHub Enterprise-verten din.

  • GitHub-appens klient-ID og klienthemmelighet for brukerautorisasjon via OAuth.

  • GitHub-appens private nøkkel, slik at ChatGPT kan utstede installasjonstokener for operasjoner på lagre.

  • En webhook-hemmelighet og en webhook-URL, slik at GitHub Enterprise kan sende installasjons- og lagerhendelser tilbake til ChatGPT.

  • Vertsnavnet for GitHub Enterprise, for eksempel github.example.com.

Opprett en GitHub-app, ikke en frittstående GitHub OAuth-app. Maloppsettet i ChatGPT krever påloggingsinformasjon for en GitHub-app, en privat nøkkel og webhook-innstillinger.

Før du starter

Du trenger:

  • Administrator- eller eiertilgang til ChatGPT-arbeidsområdet.

  • Tilgang som administrator eller organisasjonseier i GitHub Enterprise, med rettigheter til å opprette og installere GitHub-apper.

  • Bare vertsnavnet for GitHub Enterprise, uten https:// eller en bane.

  • En avklaring av hvilke handlinger på lagre ChatGPT skal støtte, som lagersøk med bare lesetilgang, arbeidsflyter for pull requests og saker, filredigering, GitHub Actions eller mer omfattende Codex-arbeidsflyter.

  • Et sikkert sted å håndtere GitHub-appens private nøkkel og klienthemmelighet.

Hold ChatGPT og GitHub Enterprise åpne i separate faner. Ikke lag din egen tilbakeringings-URL. Kopier tilbakeringings-URL-en nøyaktig slik den vises i ChatGPT.

Verdier du må ha klare

  • Vertsnavn for GitHub Enterprise: for eksempel github.example.com.

  • Tilbakeringings-URL: Kopier denne fra maloppsettet i ChatGPT.

  • GitHub-appens klient-ID.

  • GitHub-appens klienthemmelighet.

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

  • Webhook-hemmelighet generert av ChatGPT.

  • Webhook-URL generert etter at apputkastet er opprettet i ChatGPT.

Start oppsettet av malen i ChatGPT

  1. Bytt til arbeidsområdet der appen skal være tilgjengelig, i ChatGPT.

  2. Åpne Innstillinger for arbeidsområdet > Apper. Du kan også gå til Administrasjonskonsollen, velge det aktuelle ChatGPT-arbeidsområdet og åpne Programtillegg. Velg Administrer eldre apper for å åpne den tidligere Apper-siden, som fortsatt er tilgjengelig.

  3. Velg Katalog.

  4. Søk etter GitHub Enterprise.

  5. Velg appmalen for GitHub Enterprise og start oppsettet.

  6. Angi et tydelig appnavn og en beskrivelse, for eksempel GitHub Enterprise eller GitHub Enterprise – Utvikling.

  7. Angi vertsnavnet for GitHub Enterprise, for eksempel github.example.com.

  8. Kopier tilbakeringings-URL-en som vises i ChatGPT. Hold denne fanen åpen.

  9. Kopier den genererte webhook-hemmeligheten hvis den vises under oppsettet.

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

Ikke fjern tilbakeringings-ID-en, legg til en skråstrek på slutten eller erstatt URL-en med en generell ChatGPT-URL.

Opprett GitHub-appen i GitHub Enterprise

  1. Åpne GitHub Enterprise-verten din, for eksempel https://github.example.com.

  2. Gå til organisasjonen eller kontoen som skal eie appen.

  3. Åpne Innstillinger > Utviklerinnstillinger > GitHub-apper.

  4. Velg Ny GitHub-app.

  5. Angi et tydelig appnavn, for eksempel ChatGPT-kobling for GitHub Enterprise.

  6. Angi en URL til en hjemmeside. Hvis det ikke finnes en egen intern side, bruk organisasjonens URL i GitHub Enterprise.

  7. Lim inn tilbakeringings-URL-en du kopierte fra ChatGPT, nøyaktig som den er, i Tilbakeringings-URL.

  8. La La brukerautorisasjonstokener utløpe være aktivert, med mindre sikkerhetsteamet har en konkret grunn til å endre innstillingen.

  9. Aktiver Be om brukerautorisasjon under installasjon, slik at brukere kan autorisere appen under installasjons- eller tilkoblingsprosessen.

  10. Under Hvor kan denne GitHub-appen installeres?, velg det mest begrensede alternativet som passer for utrullingen.

  11. Opprett GitHub-appen.

Konfigurer tillatelser og hendelser

Velg bare tillatelsene som kreves for ChatGPT-handlingene du planlegger å aktivere.

For å finne lagre og stille spørsmål om dem uten å gjøre endringer, start med lesetillatelser som:

  • Metadata: bare lesing. GitHub krever tilgang til metadata for GitHub-apper.

  • Innhold: bare lesing, for tilgang til filer og innhold i lagre.

  • Saker: bare lesing, hvis det er behov for å søke etter eller lese saker.

  • Pull requests: bare lesing, hvis det er behov for å søke etter pull requests eller hente kontekst for kodegjennomgang.

  • Handlinger: bare lesing, hvis det er behov for status for arbeidsflytkjøringer, jobber, logger eller artefakter.

For arbeidsflyter som gjør endringer, legg bare til skrivetillatelser der det er nødvendig, for eksempel for Innhold, Pull requests, Saker, Handlinger eller Arbeidsflyter. Bruk de mest begrensede tillatelsene som støtter de tiltenkte ChatGPT-handlingene.

Webhook-hendelsene bør samsvare med arbeidsflytene du støtter. Vanlige hendelser er Installasjon, Installasjonslagre, Push, Pull request, Saker, Sakskommentar, Arbeidsflytkjøring og Arbeidsflytjobb.

Generer og kopier påloggingsinformasjon for GitHub-appen

  1. Kopier Klient-ID i GitHub-appens innstillinger.

  2. Generer en Klienthemmelighet og kopier den med en gang.

  3. Generer en privat nøkkel under Private nøkler.

  4. Last ned .pem-filen og oppbevar den sikkert.

  5. Åpne .pem-filen lokalt og kopier hele PEM-teksten, inkludert start- og sluttlinjene.

Den private nøkkelen er sensitiv. Behandle den som påloggingsinformasjon. Hvis den kommer på avveie, generer en ny privat nøkkel, oppdater appoppsettet i ChatGPT og slett den kompromitterte nøkkelen i GitHub Enterprise.

Fullfør oppsettet i ChatGPT

  1. Gå tilbake til fanen med maloppsettet i ChatGPT.

  2. Lim inn GitHub-appens klient-ID i OAuth-klient-ID.

  3. Lim inn GitHub-appens klienthemmelighet i OAuth-klienthemmelighet.

  4. La Tilgangsomfang stå uendret med mindre organisasjonen har et konkret behov for å overstyre malens standardverdier.

  5. Kontroller at vertsnavnet for GitHub Enterprise bare inneholder selve vertsnavnet, for eksempel github.example.com.

  6. Lim inn eller last opp GitHub-appens private nøkkel i PEM-format i Privat nøkkel for GitHub-app.

  7. Kontroller at den genererte webhook-hemmeligheten er på plass.

  8. Opprett apputkastet.

  9. Åpne detaljene for det opprettede apputkastet i ChatGPT og kopier den genererte webhook-URL-en.

Webhook-URL-en skal se slik ut: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Fullfør webhook-oppsettet i GitHub Enterprise

  1. Gå tilbake til GitHub-appens innstillinger i GitHub Enterprise.

  2. Åpne GitHub-appens generelle innstillinger.

  3. Slå på Aktive webhooks hvis de ikke allerede er aktivert.

  4. Lim inn webhook-URL-en fra ChatGPT i Webhook-URL.

  5. Lim inn webhook-hemmeligheten fra ChatGPT i Webhook-hemmelighet.

  6. La SSL-verifisering være aktivert.

  7. Kontroller at webhook-hendelsene du abonnerer på, samsvarer med tillatelsene og handlingene du har aktivert.

  8. Lagre endringene.

Publiser og administrer appen i ChatGPT

Appen blir ikke automatisk tilgjengelig for medlemmene når du oppretter apputkastet. Etter at du har gjennomgått utkastet:

  1. Publiser apputkastet.

  2. Gå til Innstillinger for arbeidsområdet, åpne siden Apper, åpne Aktivert og kontroller at appen vises. Du kan også åpne Apper-siden via Administrer eldre apper i Administrasjonskonsollen > Programtillegg.

  3. Konfigurer Brukertilgang for rollene som skal bruke den.

  4. Gå gjennom Handlingskontroll for lese- og skrivehandlinger.

  5. Gå gjennom Apptillatelser for å velge når ChatGPT skal spørre medlemmene før appen brukes.

  6. Be en testbruker med tilgang om å åpne Apper i ChatGPT og kontrollere at appen vises.

Disse apptillatelsene gjelder for ChatGPT-samtaler. Arbeidsområdeagenter bruker kontroller som agentens oppretter angir for hver enkelt agent. Disse avgjør hvilke apphandlinger som er tilgjengelige, og når sluttbrukere blir bedt om å godkjenne dem. For informasjon om hvordan agenter fungerer, se: ChatGPT-arbeidsområdeagenter for Enterprise og Business.

Installer og test GitHub-appen

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

  2. Velg alle lagre eller utvalgte lagre i henhold til arbeidsområdets retningslinjer.

  3. Start tilkoblingsprosessen fra ChatGPT som en bruker med tilgang.

  4. Autoriser GitHub-appen når du blir bedt om det.

  5. Kjør først en enkel lesehandling, som å liste opp tilgjengelige lagre eller hente en kjent pull request.

  6. Hvis skrivehandlinger er aktivert, test i et lager med lav risiko før bredere utrulling.

Vertsnavn og hvordan OAuth fungerer

ChatGPT bruker vertsnavnet til å utlede endepunkter for GitHub Enterprise. Angi bare vertsnavnet, for eksempel github.example.com eller octocorp.ghe.com.

Ikke angi en API-bane, en lagerbane eller github.com med mindre dette er den eksakte GitHub Enterprise-verten for denne appen.

Feilsøking

  • Omdirigerings-URI samsvarer ikke: Kontroller at GitHub-appens tilbakeringings-URL er helt lik tilbakeringings-URL-en som vises i ChatGPT.

  • ChatGPT kan ikke opprette eller lagre apputkastet: Kontroller at alle obligatoriske felt er fylt ut, inkludert vertsnavn, OAuth-klient-ID, OAuth-klienthemmelighet, privat nøkkel og webhook-hemmelighet.

  • Autentiseringen lykkes, men kall til lagre mislykkes: Kontroller at GitHub-appen er installert og har tilgang til lageret.

  • API-et returnerer 403 eller utilstrekkelige tillatelser: Legg til den manglende tillatelsen for GitHub-appen, og be installasjonseieren godkjenne de oppdaterte tillatelsene hvis det blir bedt om det.

  • Ingen lagre vises: Kontroller at appinstallasjonen inkluderer de forventede lagrene, og at brukeren som autoriserer i ChatGPT, har tilgang til dem.

  • Webhook-leveranser mislykkes: Kontroller at webhook-URL-en og webhook-hemmeligheten samsvarer med verdiene fra ChatGPT, la SSL-verifisering være aktivert, og sørg for at GitHub Enterprise-verten kan nå connectors.api.openai.org.

  • Feil med privat nøkkel: Kontroller at hele PEM-innholdet ble kopiert, inkludert start- og sluttlinjene.

Referanser

Var denne artikkelen nyttig?