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: 10 days ago

Oversikt

Bruk denne veiledningen hvis du er ChatGPT-arbeidsområdeadministrator og konfigurerer GitHub Enterprise-appmalen for organisasjonen. En mal er ikke den endelige appen som medlemmene bruker. Det er en oppsettflyt som oppretter en arbeidsområdespesifikk utkastapp etter at du har oppgitt den nødvendige GitHub Enterprise-konfigurasjonen.

For GitHub Enterprise kobler oppsettet ChatGPT til organisasjonens GitHub Enterprise-vert. Du oppretter en GitHub App, registrerer ChatGPT-callback-URL-en, genererer legitimasjon og limer deretter inn disse verdiene i oppsettflyten for ChatGPT-malen. Etter at ChatGPT har opprettet utkastappen, kan du publisere og administrere den som andre arbeidsområdeapper.

Dette konfigurerer du

Du oppretter en arbeidsområdespesifikk GitHub Enterprise-app i ChatGPT. Appen bruker:

  • En GitHub App registrert på GitHub Enterprise-verten din.

  • GitHub App-klient-ID-en og klienthemmeligheten for brukerautorisasjon med OAuth.

  • GitHub App-privatnøkkelen slik at ChatGPT kan utstede installasjonstoken for lageroperasjoner.

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

  • GitHub Enterprise-vertsnavnet ditt, for eksempel github.example.com.

Opprett en GitHub App, ikke en frittstående GitHub OAuth App. ChatGPT-maloppsettet krever GitHub App-legitimasjon, en privat nøkkel og webhook-innstillinger.

Før du starter

Du trenger:

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

  • Administrator- eller organisasjonseiertilgang i GitHub Enterprise som kan opprette og installere GitHub Apps.

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

  • En beslutning om hvilke lagerhandlinger ChatGPT skal støtte, for eksempel skrivebeskyttet lagersøk, arbeidsflyter for pull-forespørsler, saksarbeidsflyter, filredigeringer, GitHub Actions eller bredere Codex-arbeidsflyter.

  • Et sikkert sted å håndtere GitHub App-privatnøkkelen og klienthemmeligheten.

Hold ChatGPT og GitHub Enterprise åpne i separate faner. Ikke finn på callback-URL-en. Kopier den nøyaktige callback-URL-en som vises i ChatGPT.

Verdier å klargjøre

  • GitHub Enterprise-vertsnavn: for eksempel github.example.com.

  • Callback-URL: kopier denne fra oppsettflyten for ChatGPT-malen.

  • GitHub App-klient-ID.

  • GitHub App-klienthemmelighet.

  • GitHub App-privatnøkkel-PEM.

  • Webhook-hemmelighet generert av ChatGPT.

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

Start maloppsettet i ChatGPT

  1. I ChatGPT bytter du til arbeidsområdet der appen skal være tilgjengelig.

  2. Åpne Arbeidsområdeinnstillinger > Apper.

  3. Velg Katalog.

  4. Søk etter GitHub Enterprise.

  5. Velg appmalen GitHub Enterprise og start oppsettet.

  6. Skriv inn et tydelig appnavn og en beskrivelse, for eksempel GitHub Enterprise eller GitHub Enterprise - Engineering.

  7. Skriv inn vertsnavnet for GitHub Enterprise, for eksempel github.example.com.

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

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

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

Ikke fjern callback-ID-en, legg til en skråstrek på slutten eller erstatt den med en generisk ChatGPT-URL.

Opprett GitHub App i GitHub Enterprise

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

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

  3. Åpne Innstillinger > Utviklerinnstillinger > GitHub Apps.

  4. Velg Ny GitHub App.

  5. Skriv inn et tydelig appnavn, for eksempel ChatGPT GitHub Enterprise Connector.

  6. Skriv inn en URL til startsiden. Hvis det ikke finnes en egen intern side, bruker du URL-en til GitHub Enterprise-organisasjonen.

  7. Lim inn den nøyaktige callback-URL-en som ble kopiert fra ChatGPT, i Callback URL.

  8. La Utløp for brukerautorisasjonstoken være aktivert med mindre sikkerhetsteamet har en spesifikk grunn til å endre det.

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

  10. Under Hvor kan denne GitHub App installeres?, velger du det smaleste alternativet som passer utrullingen.

  11. Opprett GitHub App.

Konfigurer tillatelser og hendelser

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

For skrivebeskyttet oppdagelse av lagre og spørsmål og svar starter du med lesetillatelser som:

  • Metadata: skrivebeskyttet. GitHub krever metadata for GitHub Apps.

  • Innhold: skrivebeskyttet, for tilgang til fil- og lagerinnhold.

  • Saker: skrivebeskyttet, hvis søk etter eller lesing av saker er nødvendig.

  • Pull-forespørsler: skrivebeskyttet, hvis søk etter pull-forespørsler eller gjennomgangskontekst er nødvendig.

  • Handlinger: skrivebeskyttet, hvis status for arbeidsflytkjøring, jobber, logger eller artefakter er nødvendig.

For skrivearbeidsflyter legger du bare til skrivetillatelser der det er nødvendig, for eksempel Innhold, Pull-forespørsler, Saker, Handlinger eller Arbeidsflyter. Bruk de smaleste tillatelsene som støtter de tiltenkte ChatGPT-handlingene.

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

Generer og kopier GitHub App-legitimasjon

  1. I GitHub App-innstillingene kopierer du Klient-ID.

  2. Generer en Klienthemmelighet og kopier den umiddelbart.

  3. Under Private nøkler genererer du en privat nøkkel.

  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 legitimasjon. Hvis den blir eksponert, genererer du en ny privat nøkkel, oppdaterer ChatGPT-appoppsettet og sletter den kompromitterte nøkkelen i GitHub Enterprise.

Fullfør oppsettet i ChatGPT

  1. Gå tilbake til fanen for ChatGPT-maloppsett.

  2. Lim inn GitHub App-klient-ID-en i OAuth-klient-ID.

  3. Lim inn GitHub App-klienthemmeligheten i OAuth-klienthemmelighet.

  4. La Omfang være uendret med mindre organisasjonen bevisst må overstyre standardverdiene i malen.

  5. Bekreft at GitHub Enterprise-vertsnavnet bare er vertsnavnet, for eksempel github.example.com.

  6. Lim inn eller last opp GitHub App-privatnøkkel-PEM i GitHub App-privatnøkkel.

  7. Bekreft at den genererte webhook-hemmeligheten finnes.

  8. Opprett utkastappen.

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

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

Fullfør webhook-oppsettet i GitHub Enterprise

  1. Gå tilbake til GitHub App-innstillingene i GitHub Enterprise.

  2. Åpne de generelle GitHub App-innstillingene.

  3. Aktiver Aktive webhooks hvis de ikke allerede er aktivert.

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

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

  6. La SSL-verifisering være aktivert.

  7. Bekreft at webhook-hendelsene du abonnerer på, samsvarer med tillatelsene og handlingene du aktiverte.

  8. Lagre endringene.

Publiser og administrer appen i ChatGPT

Når du oppretter utkastappen, blir den ikke automatisk tilgjengelig for medlemmer. Etter at du har gjennomgått utkastet:

  1. Publiser utkastappen.

  2. Bekreft at appen vises i Arbeidsområdeinnstillinger > Apper > Aktivert.

  3. Konfigurer Brukertilgang for rollene som skal bruke den.

  4. Se gjennom Handlingskontroll for lese- og skrivehandlinger.

  5. Se gjennom Apptillatelser for å velge når ChatGPT spør medlemmer før appen brukes.

  6. Be en tillatt testbruker om å åpne Apper i ChatGPT og bekrefte at appen vises.

Disse apptillatelsene gjelder for ChatGPT-samtaler. Arbeidsområdeagenter bruker kontroller per agent, angitt av agentens bygger, til å bestemme hvilke apphandlinger som er tilgjengelige, og når sluttbrukere blir bedt om å godkjenne dem. For agentatferd, se: ChatGPT Workspace Agents for Enterprise and Business.

Installer og test GitHub App

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

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

  3. Start tilkoblingsflyten fra ChatGPT som en tillatt bruker.

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

  5. Kjør først en liten lesehandling, for eksempel å liste tilgjengelige lagre eller hente en kjent pull-forespørsel.

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

Vertsnavn og OAuth-atferd

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

Ikke skriv inn en API-bane, en lagerbane eller github.com med mindre det er den nøyaktige GitHub Enterprise-verten for denne appen.

Feilsøking

  • U samsvar i omdirigerings-URI: bekreft at callback-URL-en for GitHub App samsvarer nøyaktig med callback-URL-en som vises i ChatGPT.

  • ChatGPT kan ikke opprette eller lagre utkastappen: bekreft at alle obligatoriske felt finnes, inkludert vertsnavn, OAuth-klient-ID, OAuth-klienthemmelighet, privat nøkkel og webhook-hemmelighet.

  • Autentisering lykkes, men lagerkall mislykkes: bekreft at GitHub App er installert og har tilgang til lageret.

  • API-et returnerer 403 eller utilstrekkelige tillatelser: legg til den manglende GitHub App-tillatelsen, og få installasjonseieren til å godkjenne oppdaterte tillatelser hvis du blir bedt om det.

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

  • Webhook-leveranser mislykkes: bekreft 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: bekreft at hele PEM-innholdet ble kopiert, inkludert start- og sluttlinjene.

Referanser

Var denne artikkelen nyttig?