Ħarsa ġenerali
Uża din il-gwida jekk inti amministratur ta’ workspace ta’ ChatGPT u qed tikkonfigura il-mudell tal-app GitHub Enterprise għall-organizzazzjoni tiegħek. Mudell mhuwiex l-app finali li jużaw il-membri. Huwa proċess ta’ konfigurazzjoni li joħloq abbozz ta’ app speċifiku għall-workspace wara li tipprovdi l-konfigurazzjoni meħtieġa ta’ GitHub Enterprise.
Għal GitHub Enterprise, il-konfigurazzjoni tqabbad ChatGPT mal-host ta’ GitHub Enterprise tal-organizzazzjoni tiegħek. Toħloq GitHub App, tirreġistra l-URL ta’ callback ta’ ChatGPT, tiġġenera l-kredenzjali, u mbagħad tippejstja dawk il-valuri fil-proċess tal-konfigurazzjoni tal-mudell ta’ ChatGPT. Wara li ChatGPT joħloq l-abbozz tal-app, tista’ tippubblikah u timmaniġġjah bħall-apps l-oħra tal-workspace.
Għan-navigazzjoni fil-workspace u l-aċċess għall-apps, ara: Kontrolli tal-amministratur, sigurtà u konformità għall-plugins u l-apps.
X’qed tikkonfigura
Qed toħloq app GitHub Enterprise f’ChatGPT speċifika għall-workspace. L-app tuża:
GitHub App irreġistrata fuq il-host ta’ GitHub Enterprise tiegħek.
L-ID tal-klijent u s-sigriet tal-klijent tal-GitHub App għall-awtorizzazzjoni OAuth tal-utent.
Iċ-ċavetta privata tal-GitHub App sabiex ChatGPT ikun jista’ jiġġenera tokens tal-installazzjoni għall-operazzjonijiet tar-repożitorju.
Sigriet tal-webhook u URL tal-webhook sabiex GitHub Enterprise ikun jista’ jibgħat avvenimenti tal-installazzjoni u tar-repożitorju lura lil ChatGPT.
L-isem tal-host ta’ GitHub Enterprise tiegħek, bħal
github.example.com.
Oħloq GitHub App, mhux GitHub OAuth App awtonoma. Il-konfigurazzjoni tal-mudell ta’ ChatGPT teħtieġ kredenzjali ta’ GitHub App, ċavetta privata u s-settings tal-webhook.
Qabel tibda
Għandek bżonn:
Aċċess bħala amministratur jew sid ta’ workspace ta’ ChatGPT.
Aċċess bħala amministratur ta’ GitHub Enterprise jew sid ta’ organizzazzjoni li jippermettilek toħloq u tinstalla GitHub Apps.
L-isem tal-host ta’ GitHub Enterprise biss, mingħajr
https://jew mogħdija.Deċiżjoni dwar liema azzjonijiet tar-repożitorju ChatGPT għandu jappoġġja, bħal tiftix fir-repożitorji b’aċċess għall-qari biss, flussi tax-xogħol tal-pull requests jew tal-kwistjonijiet, editjar tal-fajls, GitHub Actions, jew flussi tax-xogħol usa’ ta’ Codex.
Post sigur biex timmaniġġja ċ-ċavetta privata u s-sigriet tal-klijent tal-GitHub App.
Żomm ChatGPT u GitHub Enterprise miftuħa f’tabs separati. Tivvintax il-URL ta’ callback. Ikkopja l-URL eżatt ta’ callback li jidher f’ChatGPT.
Valuri li għandek tipprepara
Isem tal-host ta’ GitHub Enterprise: pereżempju,
github.example.com.URL ta’ callback: ikkopjah mill-proċess tal-konfigurazzjoni tal-mudell ta’ ChatGPT.
ID tal-klijent tal-GitHub App.
Sigriet tal-klijent tal-GitHub App.
Ċavetta privata tal-GitHub App fil-format PEM.
Sigriet tal-webhook iġġenerat minn ChatGPT.
URL tal-webhook iġġenerat wara li jinħoloq l-abbozz tal-app f’ChatGPT.
Ibda l-konfigurazzjoni tal-mudell f’ChatGPT
F’ChatGPT, aqleb għall-workspace fejn l-app għandha tkun disponibbli.
Iftaħ Issettjar tal-workspace > Apps. Tista’ wkoll tmur fil-Konsola tal-amministrazzjoni, tagħżel il-workspace ta’ ChatGPT mixtieq, u tiftaħ Plugins. Agħżel Immaniġġja l-apps preċedenti biex tiftaħ il-paġna Apps li nżammet.
Agħżel Direttorju.
Fittex GitHub Enterprise.
Agħżel il-mudell tal-app GitHub Enterprise u ibda l-konfigurazzjoni.
Daħħal isem u deskrizzjoni ċari għall-app, bħal GitHub Enterprise jew GitHub Enterprise - Inġinerija.
Daħħal l-isem tal-host ta’ GitHub Enterprise, bħal
github.example.com.Ikkopja l-URL ta’ callback li jidher f’ChatGPT. Żomm din it-tab miftuħa.
Ikkopja s-sigriet tal-webhook iġġenerat jekk jidher waqt il-konfigurazzjoni.
Eżempju ta’ URL ta’ callback: https://chatgpt.com/connector/oauth/<callback_id>
Tneħħix l-ID tal-callback, iżżidx slash fl-aħħar, u tibdilx il-URL b’URL ġeneriku ta’ ChatGPT.
Oħloq l-app ta’ GitHub f’GitHub Enterprise
Iftaħ il-host tiegħek ta’ GitHub Enterprise, bħal
https://github.example.com.Mur fl-organizzazzjoni jew fil-kont li għandu jkun sid l-app.
Iftaħ Settings > Settings għall-iżviluppaturi > Apps ta’ GitHub.
Agħżel App ġdida ta’ GitHub.
Daħħal isem ċar għall-app, bħal ChatGPT GitHub Enterprise.
Daħħal URL tal-paġna ewlenija. Jekk ma hemmx paġna interna ddedikata, uża l-URL tal-organizzazzjoni f’GitHub Enterprise.
Fil-qasam URL tal-callback, waħħal il-URL eżatt tal-callback li kkupjajt minn ChatGPT.
Żomm l-għażla Skadenza tat-tokens tal-awtorizzazzjoni tal-utenti attivata sakemm it-tim tas-sigurtà tiegħek ma jkollux raġuni speċifika biex jibdilha.
Attiva Itlob l-awtorizzazzjoni tal-utent waqt l-installazzjoni sabiex l-utenti jkunu jistgħu jawtorizzaw l-app waqt il-proċess ta’ installazzjoni jew konnessjoni.
Taħt Fejn tista’ tiġi installata din l-app ta’ GitHub?, agħżel l-aktar għażla ristretta li taqbel mal-pjan tiegħek għat-tnedija.
Oħloq l-app ta’ GitHub.
Ikkonfigura l-permessi u l-avvenimenti
Agħżel il-permessi minimi meħtieġa għall-azzjonijiet ta’ ChatGPT li qed tippjana li tattiva.
Biex issib repożitorji u tikseb tweġibiet b’aċċess għall-qari biss, ibda b’permessi tal-qari bħal:
Metadata: qari biss. GitHub jeħtieġ metadata għall-GitHub Apps.
Kontenut: qari biss, għall-aċċess għall-kontenut tal-fajls u tar-repożitorji.
Kwistjonijiet: qari biss, jekk ikun meħtieġ li tfittex jew taqra kwistjonijiet.
Pull requests: qari biss, jekk ikun meħtieġ li tfittex pull requests jew tikseb kuntest għar-reviżjoni.
Azzjonijiet: qari biss, jekk ikunu meħtieġa l-istat tal-eżekuzzjoni tal-flussi tax-xogħol, kompiti, reġistri jew artefatti.
Għal flussi tax-xogħol li jiktbu d-data, żid permessi tal-kitba biss fejn ikun meħtieġ, bħal Kontenut, Pull requests, Kwistjonijiet, Azzjonijiet jew Flussi tax-xogħol. Uża l-aktar permessi restrittivi li jippermettu l-azzjonijiet mixtieqa ta’ ChatGPT.
L-avvenimenti tal-webhook għandhom jaqblu mal-flussi tax-xogħol li tappoġġja. Avvenimenti komuni jinkludu Installazzjoni, Repożitorji tal-installazzjoni, Push, Pull request, Kwistjonijiet, Kumment fuq kwistjoni, Eżekuzzjoni ta’ fluss tax-xogħol u Kompitu ta’ fluss tax-xogħol.
Iġġenera u kkopja l-kredenzjali tal-GitHub App
Fis-settings tal-GitHub App, ikkopja l-ID tal-klijent.
Iġġenera Sigriet tal-klijent u kkopjah minnufih.
Taħt Ċwievet privati, iġġenera ċavetta privata.
Niżżel il-fajl .pem u aħżnu b’mod sigur.
Iftaħ il-fajl .pem lokalment u kkopja t-test PEM kollu, inklużi l-linji tal-bidu u tat-tmiem.
Iċ-ċavetta privata hija sensittiva. Ittrattaha bħal kredenzjal. Jekk tiġi żvelata, iġġenera ċavetta privata ġdida, aġġorna l-konfigurazzjoni tal-app f’ChatGPT, u ħassar iċ-ċavetta kompromessa f’GitHub Enterprise.
Lesti l-konfigurazzjoni f’ChatGPT
Erġa’ lura fit-tab tal-konfigurazzjoni tal-mudell ta’ ChatGPT.
Ippejstja l-ID tal-klijent tal-GitHub App fil-qasam ID tal-klijent OAuth.
Ippejstja s-sigriet tal-klijent tal-GitHub App fil-qasam Sigriet tal-klijent OAuth.
Ħalli Ambiti kif inhu sakemm l-organizzazzjoni tiegħek ma jkollhiex bżonn tibdel apposta l-valuri prestabbiliti tal-mudell.
Ikkonferma li l-isem tal-host ta’ GitHub Enterprise fih biss l-isem tal-host, bħal
github.example.com.Ippejstja jew tella’ ċ-ċavetta privata tal-GitHub App fil-format PEM fil-qasam Ċavetta privata tal-GitHub App.
Ikkonferma li s-sigriet tal-webhook iġġenerat huwa preżenti.
Oħloq l-abbozz tal-app.
Iftaħ id-dettalji tal-abbozz tal-app li ħloqt f’ChatGPT u kkopja l-URL tal-webhook iġġenerat.
Il-URL tal-webhook għandu jkollu din il-forma: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Lesti l-konfigurazzjoni tal-webhook f’GitHub Enterprise
Erġa’ lura fis-settings tal-GitHub App f’GitHub Enterprise.
Iftaħ Issettjar ġenerali tal-GitHub App.
Attiva Webhooks attivi jekk għadhom mhumiex attivati.
Ippejstja l-URL tal-webhook ta’ ChatGPT fil-qasam URL tal-webhook.
Ippejstja s-sigriet tal-webhook ta’ ChatGPT fil-qasam Sigriet tal-webhook.
Żomm il-verifika SSL attivata.
Ikkonferma li l-avvenimenti tal-webhook li abbonajt għalihom jaqblu mal-permessi u l-azzjonijiet li attivajt.
Issejvja l-bidliet.
Ippubblika u mmaniġġja l-app f’ChatGPT
Il-ħolqien tal-abbozz tal-app ma jagħmilhiex disponibbli awtomatikament għall-membri. Wara li tirrevedi l-abbozz:
Ippubblika l-abbozz tal-app.
Fis-settings tal-workspace, iftaħ il-paġna Apps, iftaħ Attivati, u kkonferma li l-app tidher. Tista’ wkoll tiftaħ il-paġna Apps billi tuża Immaniġġja l-apps preċedenti fil-Konsola tal-amministrazzjoni > Plugins.
F’Enterprise u Edu, uża Aċċess tal-utenti biex tagħżel liema rwoli jistgħu jużaw l-app. F’Business, immaniġġja d-disponibbiltà tal-app fil-workspace kollu.
Irrevedi Kontroll tal-azzjonijiet għall-azzjonijiet ta’ qari u kitba.
Irrevedi Permessi tal-app biex tagħżel meta ChatGPT jitlob il-permess tal-membri qabel juża l-app.
Itlob lil utent tat-test li għandu aċċess jiftaħ Apps f’ChatGPT u jikkonferma li l-app tidher.
Dawn il-permessi tal-app japplikaw għall-konverżazzjonijiet f’ChatGPT. L-aġenti tal-workspace jużaw kontrolli individwali għal kull aġent, stabbiliti mill-persuna li tibnih, biex jiddeterminaw liema azzjonijiet tal-app huma disponibbli u meta l-utenti finali jintalbu japprovawhom. Għal informazzjoni dwar l-imġiba tal-aġenti, ara: Aġenti tal-workspace ta’ ChatGPT għal Enterprise u Business.
Installa u ttestja l-GitHub App
F’GitHub Enterprise, installa l-app GitHub fuq l-organizzazzjoni jew il-kont.
Agħżel ir-repożitorji kollha jew repożitorji magħżula skont il-politika tal-workspace.
Ibda l-proċess ta’ konnessjoni minn ChatGPT bħala utent li għandu l-permess.
Awtorizza l-app GitHub meta tintalab.
L-ewwel wettaq azzjoni żgħira tal-qari, bħal li telenka r-repożitorji aċċessibbli jew iġġib pull request magħrufa.
Jekk l-azzjonijiet tal-kitba huma attivati, ittestja b’repożitorju ta’ riskju baxx qabel ma twessa’ l-użu.
L-isem tal-host u kif jaħdem OAuth
ChatGPT juża l-isem tal-host biex jiddetermina l-endpoints ta’ GitHub Enterprise. Daħħal biss il-host, bħal github.example.com jew octocorp.ghe.com.
Iddaħħalx mogħdija tal-API, mogħdija ta’ repożitorju, jew github.com sakemm dak ma jkunx il-host eżatt ta’ GitHub Enterprise għal din l-app.
Soluzzjoni tal-problemi
Il-URI tar-ridirezzjonament ma jaqbilx: ikkonferma li l-URL ta’ callback tal-GitHub App jaqbel eżatt mal-URL ta’ callback li jidher f’ChatGPT.
ChatGPT ma jistax joħloq jew isalva l-abbozz tal-app: ikkonferma li l-oqsma meħtieġa kollha huma mimlija, inklużi l-isem tal-host, ID tal-klijent OAuth, Sigriet tal-klijent OAuth, iċ-ċavetta privata u s-sigriet tal-webhook.
L-awtentikazzjoni tirnexxi iżda s-sejħiet għar-repożitorju jfallu: ikkonferma li l-GitHub App hija installata u għandha aċċess għar-repożitorju.
L-API tirritorna 403 jew permessi insuffiċjenti: żid il-permess nieqes tal-GitHub App u, jekk tintalab approvazzjoni, itlob lis-sid tal-installazzjoni japprova l-permessi aġġornati.
Ma jidher ebda repożitorju: ikkonferma li l-installazzjoni tal-app tinkludi r-repożitorji mistennija u li l-utent li qed jagħti l-awtorizzazzjoni f’ChatGPT għandu aċċess għalihom.
It-trażmissjonijiet tal-webhook ifallu: ikkonferma li l-URL tal-webhook u s-sigriet tal-webhook jaqblu mal-valuri minn ChatGPT, żomm il-verifika SSL attivata, u żgura li l-host ta’ GitHub Enterprise jista’ jaċċessa
connectors.api.openai.org.Żbalji taċ-ċavetta privata: ikkonferma li ġie kkupjat il-kontenut PEM kollu, inklużi l-linji tal-bidu u tat-tmiem.