Descobriu com els administradors d'espais de treball poden configurar la plantilla d'aplicació GitHub Enterprise a ChatGPT amb la GitHub App pròpia de la seva organització.

Visió general

Fes servir aquesta guia si ets administrador d'un espai de treball de ChatGPT i configures la plantilla d'aplicació de GitHub Enterprise per a la teva organització. Una plantilla no és l'aplicació final que fan servir els membres. És un procés de configuració que crea un esborrany d'aplicació específic per a l'espai de treball un cop hi introdueixes la configuració necessària de GitHub Enterprise.

En el cas de GitHub Enterprise, la configuració connecta ChatGPT amb l'amfitrió de GitHub Enterprise de la teva organització. Crees una GitHub App, registres l'URL de retorn de ChatGPT, generes les credencials i després enganxes aquests valors al procés de configuració de la plantilla de ChatGPT. Un cop ChatGPT ha creat l'esborrany de l'aplicació, pots publicar-la i gestionar-la com les altres aplicacions de l'espai de treball.

Per obtenir informació sobre la navegació per l'espai de treball i l'accés a les aplicacions, consulta: Controls d'administració, seguretat i compliment normatiu per a connectors i aplicacions.

Què estàs configurant

Estàs creant una aplicació de GitHub Enterprise a ChatGPT específica per a l'espai de treball. L'aplicació fa servir:

Una GitHub App registrada al teu amfitrió de GitHub Enterprise.
L'ID de client i el secret de client de la GitHub App per a l'autorització OAuth de l'usuari.
La clau privada de la GitHub App perquè ChatGPT pugui generar testimonis d'instal·lació per a les operacions amb repositoris.
Un secret i un URL del webhook perquè GitHub Enterprise pugui enviar esdeveniments d'instal·lació i de repositoris a ChatGPT.
El teu nom d'amfitrió de GitHub Enterprise, com ara github.example.com.

Crea una GitHub App, no una GitHub OAuth App independent. La configuració de la plantilla de ChatGPT requereix les credencials d'una GitHub App, una clau privada i la configuració del webhook.

Abans de començar

Necessites:

Accés d'administrador o de propietari de l'espai de treball de ChatGPT.
Accés d'administrador de GitHub Enterprise o de propietari de l'organització que permeti crear i instal·lar GitHub Apps.
Només el nom d'amfitrió de GitHub Enterprise, sense https:// ni cap camí.
Haver decidit quines accions sobre els repositoris ha d'admetre ChatGPT, com ara la cerca de repositoris de només lectura, els fluxos de treball de pull requests i d'incidències, l'edició de fitxers, GitHub Actions o fluxos de treball més amplis de Codex.
Un lloc segur on gestionar la clau privada i el secret de client de la GitHub App.

Mantén ChatGPT i GitHub Enterprise oberts en pestanyes separades. No t'inventis l'URL de retorn. Copia l'URL de retorn exacte que es mostra a ChatGPT.

Valors que cal preparar

Nom d'amfitrió de GitHub Enterprise: per exemple, github.example.com.
URL de retorn: copia'l del procés de configuració de la plantilla de ChatGPT.
ID de client de la GitHub App.
Secret de client de la GitHub App.
Clau privada de la GitHub App en format PEM.
Secret del webhook generat per ChatGPT.
URL del webhook generat després de crear l'esborrany de l'aplicació a ChatGPT.

Inicia la configuració de la plantilla a ChatGPT

A ChatGPT, canvia a l'espai de treball on ha d'estar disponible l'aplicació.
Obre Configuració de l'espai de treball > Aplicacions. També pots anar a la Consola d'administració, seleccionar l'espai de treball de ChatGPT que vulguis i obrir Connectors. Selecciona Gestiona les aplicacions heretades per obrir la pàgina Aplicacions que es conserva.
Selecciona Directori.
Cerca GitHub Enterprise.
Selecciona la plantilla d'aplicació de GitHub Enterprise i inicia la configuració.
Introdueix un nom i una descripció clars per a l'aplicació, com ara GitHub Enterprise o GitHub Enterprise - Enginyeria.
Introdueix el nom d'amfitrió de GitHub Enterprise, com ara github.example.com.
Copia l'URL de retorn que es mostra a ChatGPT. Deixa aquesta pestanya oberta.
Copia el secret del webhook generat si es mostra durant la configuració.

Exemple d'URL de retorn: https://chatgpt.com/connector/oauth/<callback_id>

No eliminis l'ID de retorn, no hi afegeixis una barra al final ni substitueixis l'URL per un URL genèric de ChatGPT.

Crea la GitHub App a GitHub Enterprise

Obre el teu amfitrió de GitHub Enterprise, com ara https://github.example.com.
Ves a l'organització o al compte que ha de ser propietari de l'aplicació.
Obre Configuració > Configuració per a desenvolupadors > GitHub Apps.
Selecciona Nova GitHub App.
Introdueix un nom clar per a l'aplicació, com ara Connector de GitHub Enterprise per a ChatGPT.
Introdueix un URL de pàgina d'inici. Si no hi ha cap pàgina interna dedicada, fes servir l'URL de l'organització de GitHub Enterprise.
A URL de retorn, enganxa l'URL de retorn exacte que has copiat de ChatGPT.
Mantén activada l'opció Fes caducar els testimonis d'autorització d'usuari, tret que el teu equip de seguretat tingui un motiu concret per canviar-la.
Activa l'opció Sol·licita l'autorització de l'usuari durant la instal·lació perquè els usuaris puguin autoritzar l'aplicació durant el procés d'instal·lació o de connexió.
A l'apartat On es pot instal·lar aquesta GitHub App?, tria l'opció més restrictiva que s'ajusti al teu desplegament.
Crea la GitHub App.

Configura els permisos i els esdeveniments

Tria els permisos mínims necessaris per a les accions de ChatGPT que preveus activar.

Per trobar repositoris i fer-hi preguntes en mode de només lectura, comença amb permisos de lectura com ara:

Metadades: només lectura. GitHub exigeix l'accés a les metadades per a les GitHub Apps.
Continguts: només lectura, per accedir als fitxers i al contingut dels repositoris.
Incidències: només lectura, si cal cercar o llegir incidències.
Pull requests: només lectura, si cal cercar pull requests o obtenir context per revisar-les.
Accions: només lectura, si cal accedir a l'estat d'execució dels fluxos de treball, les tasques, els registres o els artefactes.

Per als fluxos de treball d'escriptura, afegeix permisos d'escriptura només on calgui, com ara a Continguts, Pull requests, Incidències, Accions o Fluxos de treball. Fes servir els permisos més restrictius que permetin executar les accions de ChatGPT previstes.

Els esdeveniments del webhook han de correspondre als fluxos de treball que admetis. Alguns esdeveniments habituals són Instal·lació, Repositoris de la instal·lació, Enviament, Pull request, Incidències, Comentari d'incidència, Execució de flux de treball i Tasca de flux de treball.

Genera i copia les credencials de la GitHub App

A la configuració de la GitHub App, copia l'ID de client.
Genera un Secret de client i copia'l immediatament.
A Claus privades, genera una clau privada.
Baixa el fitxer .pem i desa'l de manera segura.
Obre el fitxer .pem localment i copia tot el text PEM, incloses les línies d'inici i de final.

La clau privada és informació sensible. Tracta-la com una credencial. Si queda exposada, genera una clau privada nova, actualitza la configuració de l'aplicació a ChatGPT i elimina la clau compromesa a GitHub Enterprise.

Completa la configuració a ChatGPT

Torna a la pestanya de configuració de la plantilla de ChatGPT.
Enganxa l'ID de client de la GitHub App a ID de client OAuth.
Enganxa el secret de client de la GitHub App a Secret de client OAuth.
Deixa Àmbits sense canvis, tret que la teva organització necessiti modificar expressament els valors predeterminats de la plantilla.
Confirma que el nom d'amfitrió de GitHub Enterprise conté només el nom d'amfitrió, com ara github.example.com.
Enganxa o puja la clau privada de la GitHub App en format PEM a Clau privada de la GitHub App.
Confirma que hi ha el secret del webhook generat.
Crea l'esborrany de l'aplicació.
Obre els detalls de l'esborrany de l'aplicació creat a ChatGPT i copia l'URL del webhook generat.

L'URL del webhook hauria de tenir aquest format: https://connectors.api.openai.org/connectors/<connector_id>/webhook

Completa la configuració del webhook a GitHub Enterprise

Torna a la configuració de la GitHub App a GitHub Enterprise.
Obre la configuració general de la GitHub App.
Activa l'opció Webhooks actius si encara no està activada.
Enganxa l'URL del webhook de ChatGPT a URL del webhook.
Enganxa el secret del webhook de ChatGPT a Secret del webhook.
Mantén activada la verificació SSL.
Confirma que els esdeveniments del webhook als quals t'has subscrit corresponen als permisos i a les accions que has activat.
Desa els canvis.

Publica i gestiona l'aplicació a ChatGPT

Crear l'esborrany de l'aplicació no la posa automàticament a disposició dels membres. Després de revisar l'esborrany:

Publica l'esborrany de l'aplicació.
A Configuració de l'espai de treball, obre la pàgina Aplicacions, obre Activades i confirma que l'aplicació hi apareix. També pots obrir la pàgina Aplicacions amb l'opció Gestiona les aplicacions heretades a Consola d'administració > Connectors.
Configura l'Accés d'usuaris per als rols que l'hagin de fer servir.
Revisa el Control d'accions per a les accions de lectura i escriptura.
Revisa els Permisos de l'aplicació per triar quan ChatGPT ha de demanar permís als membres abans de fer-la servir.
Demana a un usuari de prova autoritzat que obri Aplicacions a ChatGPT i confirmi que l'aplicació hi apareix.

Aquests permisos de l'aplicació s'apliquen a les converses de ChatGPT. Els agents de l'espai de treball fan servir controls específics per a cada agent, definits pel seu creador, per determinar quines accions de les aplicacions estan disponibles i quan es demana als usuaris finals que les aprovin. Per obtenir informació sobre el comportament dels agents, consulta: Agents de l'espai de treball de ChatGPT per a Enterprise i Business.

Instal·la i prova la GitHub App

A GitHub Enterprise, instal·la l'aplicació de GitHub a l'organització o al compte.
Tria tots els repositoris o només alguns de seleccionats segons la política de l'espai de treball.
Inicia el procés de connexió des de ChatGPT com a usuari autoritzat.
Autoritza l'aplicació de GitHub quan se't demani.
Executa primer una acció de lectura senzilla, com ara llistar els repositoris accessibles o obtenir una pull request coneguda.
Si les accions d'escriptura estan activades, fes una prova amb un repositori de baix risc abans d'ampliar el desplegament.

Nom d'amfitrió i comportament d'OAuth

ChatGPT fa servir el nom d'amfitrió per determinar els punts finals de GitHub Enterprise. Introdueix només l'amfitrió, com ara github.example.com o octocorp.ghe.com.

No introdueixis un camí d'API, un camí de repositori ni github.com, tret que aquest sigui exactament l'amfitrió de GitHub Enterprise d'aquesta aplicació.

Resolució de problemes

L'URI de redirecció no coincideix: confirma que l'URL de retorn de la GitHub App coincideix exactament amb el que es mostra a ChatGPT.
ChatGPT no pot crear o desar l'esborrany de l'aplicació: confirma que tots els camps obligatoris estan emplenats, inclosos el nom d'amfitrió, l'ID de client OAuth, el Secret de client OAuth, la clau privada i el secret del webhook.
L'autenticació funciona però les crides al repositori fallen: confirma que la GitHub App està instal·lada i té accés al repositori.
L'API retorna un error 403 o de permisos insuficients: afegeix el permís que falta a la GitHub App i demana al propietari de la instal·lació que aprovi els permisos actualitzats si se li sol·licita.
No apareix cap repositori: confirma que la instal·lació de l'aplicació inclou els repositoris previstos i que l'usuari que concedeix l'autorització a ChatGPT hi té accés.
Els lliuraments del webhook fallen: confirma que l'URL i el secret del webhook coincideixen amb els valors de ChatGPT, mantén activada la verificació SSL i assegura't que l'amfitrió de GitHub Enterprise pot accedir a connectors.api.openai.org.
Errors de clau privada: confirma que s'ha copiat tot el contingut PEM, incloses les línies d'inici i de final.

Configureu la plantilla d'aplicació GitHub Enterprise a ChatGPT