Ħarsa ġenerali
Uża din il-gwida jekk int amministratur ta’ workspace ta’ ChatGPT li qed tikkonfigura l-mudell tal-app Enterprise ta’ GitHub għall-organizzazzjoni tiegħek. Mudell mhuwiex l-app finali li jużaw il-membri. Huwa fluss 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 lil ChatGPT mal-host ta’ GitHub Enterprise tal-organizzazzjoni tiegħek. Toħloq App ta’ GitHub, tirreġistra l-URL ta’ callback ta’ ChatGPT, tiġġenera kredenzjali, imbagħad twaħħal dawk il-valuri fil-fluss tal-konfigurazzjoni tal-mudell ta’ ChatGPT. Wara li ChatGPT joħloq l-abbozz tal-app, tista’ tippubblikaha u timmaniġġjaha bħal apps oħra tal-workspace.
X’qed tikkonfigura
Qed toħloq app GitHub Enterprise speċifika għall-workspace f’ChatGPT. L-app tuża:
App ta’ GitHub irreġistrata fuq il-host tiegħek ta’ GitHub Enterprise.
L-ID tal-klijent u s-sigriet tal-klijent tal-App ta’ GitHub għall-awtorizzazzjoni OAuth tal-utent.
Iċ-ċavetta privata tal-App ta’ GitHub sabiex ChatGPT ikun jista’ joħroġ tokens ta’ installazzjoni għall-operazzjonijiet tar-repożitorji.
Sigriet tal-webhook u URL tal-webhook sabiex GitHub Enterprise ikun jista’ jibgħat avvenimenti ta’ installazzjoni u repożitorji lura lil ChatGPT.
L-isem tal-host tiegħek ta’ GitHub Enterprise, bħal
github.example.com.
Oħloq App ta’ GitHub, mhux App OAuth ta’ GitHub separata. Il-konfigurazzjoni tal-mudell ta’ ChatGPT teħtieġ kredenzjali tal-App ta’ GitHub, ċavetta privata, u settings tal-webhook.
Qabel tibda
Għandek bżonn:
Aċċess ta’ amministratur jew sid tal-workspace ta’ ChatGPT.
Aċċess ta’ amministratur ta’ GitHub Enterprise jew sid ta’ organizzazzjoni li jista’ joħloq u jinstalla GitHub Apps.
L-isem tal-host ta’ GitHub Enterprise biss, mingħajr
https://jew mogħdija.Deċiżjoni dwar liema azzjonijiet tar-repożitorji għandu jappoġġja ChatGPT, bħal tiftix ta’ repożitorji bil-qari biss, workflows ta’ talbiet ta’ pull, workflows ta’ kwistjonijiet, editjar ta’ fajls, GitHub Actions, jew workflows usa’ ta’ Codex.
Post sigur fejn timmaniġġja ċ-ċavetta privata u s-sigriet tal-klijent tal-App ta’ GitHub.
Żomm ChatGPT u GitHub Enterprise miftuħa f’tabs separati. Tivvintax l-URL ta’ callback. Ikkopja l-URL ta’ callback eżatt muri f’ChatGPT.
Valuri li għandek tipprepara
Isem tal-host ta’ GitHub Enterprise: pereżempju,
github.example.com.URL ta’ callback: ikkopjah mill-fluss tal-konfigurazzjoni tal-mudell ta’ ChatGPT.
ID tal-klijent tal-App ta’ GitHub.
Sigriet tal-klijent tal-App ta’ GitHub.
PEM taċ-ċavetta privata tal-App ta’ GitHub.
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ħ Settings tal-workspace > Apps.
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 - Engineering.
Daħħal l-isem tal-host ta’ GitHub Enterprise, bħal
github.example.com.Ikkopja l-URL ta’ callback muri f’ChatGPT. Żomm din it-tab miftuħa.
Ikkopja s-sigriet tal-webhook iġġenerat jekk jintwera 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 tibdlux 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 is-sid tal-app.
Iftaħ Settings > Settings tal-iżviluppatur > GitHub Apps.
Agħżel App ta’ GitHub ġdida.
Daħħal isem ċar għall-app, bħal ChatGPT GitHub Enterprise Connector.
Daħħal URL tal-homepage. Jekk m’hemmx paġna interna ddedikata, uża l-URL tal-organizzazzjoni GitHub Enterprise.
F’URL ta’ Callback, waħħal l-URL ta’ callback eżatt ikkupjat minn ChatGPT.
Żomm Skadenza tat-tokens tal-awtorizzazzjoni tal-utent 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-fluss tal-installazzjoni jew tal-konnessjoni.
Taħt Fejn tista’ tiġi installata din l-App ta’ GitHub?, agħżel l-aktar għażla dejqa li taqbel mat-tnedija tiegħek.
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.
Għal skoperta ta’ repożitorji u M&T bil-qari biss, ibda b’permessi tal-qari bħal:
Metadata: qari biss. GitHub jeħtieġ metadata għal GitHub Apps.
Kontenut: qari biss, għal aċċess għall-kontenut tal-fajls u tar-repożitorji.
Kwistjonijiet: qari biss, jekk ikun meħtieġ tiftix jew qari ta’ kwistjonijiet.
Talbiet ta’ pull: qari biss, jekk ikun meħtieġ tiftix ta’ talbiet ta’ pull jew kuntest ta’ rieżami.
Azzjonijiet: qari biss, jekk ikunu meħtieġa status ta’ ġirjiet ta’ workflow, kompiti, logs, jew artefatti.
Għal workflows tal-kitba, żid permessi tal-kitba biss fejn meħtieġ, bħal Kontenut, Talbiet ta’ pull, Kwistjonijiet, Azzjonijiet, jew Workflows. Uża l-aktar permessi dejqa li jappoġġjaw l-azzjonijiet maħsuba ta’ ChatGPT.
L-avvenimenti tal-webhook għandhom jaqblu mal-workflows li tappoġġja. Avvenimenti komuni jinkludu Installazzjoni, Repożitorji tal-installazzjoni, Push, Talba ta’ pull, Kwistjonijiet, Kumment fuq kwistjoni, Ġirja ta’ workflow, u Kompitu ta’ workflow.
Iġġenera u kkopja l-kredenzjali tal-App ta’ GitHub
Fis-settings tal-App ta’ GitHub, 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 sħiħ, inklużi l-linji tal-bidu u tat-tmiem.
Iċ-ċavetta privata hija sensittiva. Ittrattaha bħal kredenzjal. Jekk tiġi esposta, iġġenera ċavetta privata ġdida, aġġorna l-konfigurazzjoni tal-app ta’ ChatGPT, u ħassar iċ-ċavetta kompromessa f’GitHub Enterprise.
Lesti l-konfigurazzjoni f’ChatGPT
Erġa’ lura għat-tab tal-konfigurazzjoni tal-mudell ta’ ChatGPT.
Waħħal l-ID tal-Klijent tal-App ta’ GitHub f’ID tal-klijent OAuth.
Waħħal is-sigriet tal-Klijent tal-App ta’ GitHub f’sigriet tal-klijent OAuth.
Ħalli Ambiti kif inhuma sakemm l-organizzazzjoni tiegħek ma jkollhiex bżonn apposta tegħleb il-valuri predefiniti tal-mudell.
Ikkonferma li l-isem tal-host ta’ GitHub Enterprise huwa isem tal-host biss, bħal
github.example.com.Waħħal jew tella’ l-PEM taċ-ċavetta privata tal-App ta’ GitHub f’ċavetta privata tal-App ta’ GitHub.
Ikkonferma li s-sigriet tal-webhook iġġenerat huwa preżenti.
Oħloq l-abbozz tal-app.
Iftaħ id-dettalji tal-abbozz tal-app maħluq f’ChatGPT u kkopja l-URL tal-webhook iġġenerat.
L-URL tal-webhook għandu jidher hekk: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Lesti l-konfigurazzjoni tal-webhook f’GitHub Enterprise
Erġa’ lura għas-settings tal-App ta’ GitHub f’GitHub Enterprise.
Iftaħ is-settings Ġenerali tal-App ta’ GitHub.
Attiva webhooks attivi jekk mhumiex diġà attivati.
Waħħal l-URL tal-webhook ta’ ChatGPT f’URL tal-webhook.
Waħħal is-sigriet tal-webhook ta’ ChatGPT f’sigriet tal-webhook.
Żomm il-verifika SSL attivata.
Ikkonferma li l-avvenimenti webhook abbonati 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 tirrieżamina l-abbozz:
Ippubblika l-abbozz tal-app.
Ikkonferma li l-app tidher f’Settings tal-workspace > Apps > Attivati.
Ikkonfigura Aċċess tal-utenti għar-rwoli li għandhom jużawha.
Irrevedi Kontroll tal-azzjonijiet għall-azzjonijiet tal-qari u tal-kitba.
Irrevedi Permessi tal-app biex tagħżel meta ChatGPT jistaqsi lill-membri qabel juża l-app.
Staqsi lil utent tat-test permess biex jiftaħ Apps f’ChatGPT u jikkonferma li l-app tidher.
Dawn il-permessi tal-app japplikaw għall-konverżazzjonijiet ta’ ChatGPT. L-Aġenti tal-Workspace jużaw kontrolli għal kull aġent stabbiliti mill-bennej tal-aġent biex jiddeterminaw liema azzjonijiet tal-app huma disponibbli u meta l-utenti finali jintalbu japprovawhom. Għall-imġiba tal-aġent, ara: Aġenti tal-Workspace ta’ ChatGPT għal Enterprise u Business.
Installa u ttestja l-App ta’ GitHub
F’GitHub Enterprise, installa l-app ta’ 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-fluss ta’ konnessjoni minn ChatGPT bħala utent permess.
Awtorizza l-app ta’ GitHub meta tintalab.
Ħaddem azzjoni żgħira ta’ qari l-ewwel, bħal elenkar ta’ repożitorji aċċessibbli jew ġibda ta’ talba ta’ pull magħrufa.
Jekk l-azzjonijiet tal-kitba huma attivati, ittestja b’repożitorju ta’ riskju baxx qabel tnedija usa’.
Isem tal-host u mġiba ta’ OAuth
ChatGPT juża l-isem tal-host biex jidderiva l-punti ta’ tmiem 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
Nuqqas ta’ qbil fl-URI tar-ridirezzjoni: ikkonferma li l-URL ta’ callback tal-App ta’ GitHub jaqbel eżatt mal-URL ta’ callback muri f’ChatGPT.
ChatGPT ma jistax joħloq jew isejvja l-abbozz tal-app: ikkonferma li l-oqsma meħtieġa kollha huma preżenti, inklużi l-isem tal-host, ID tal-klijent OAuth, sigriet tal-klijent OAuth, ċavetta privata, u sigriet tal-webhook.
L-awtentikazzjoni tirnexxi iżda s-sejħiet tar-repożitorju jfallu: ikkonferma li l-App ta’ GitHub hija installata u għandha aċċess għar-repożitorju.
L-API tirritorna 403 jew permessi insuffiċjenti: żid il-permess nieqes tal-App ta’ GitHub u qabbad lis-sid tal-installazzjoni japprova l-permessi aġġornati jekk jintalab.
Ma jidhrux repożitorji: ikkonferma li l-installazzjoni tal-app tinkludi r-repożitorji mistennija u li l-utent li jawtorizza f’ChatGPT għandu aċċess għalihom.
Il-kunsinni 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 kun żgur li l-host ta’ GitHub Enterprise jista’ jilħaq
connectors.api.openai.org.Żbalji taċ-ċavetta privata: ikkonferma li l-kontenut PEM sħiħ ġie kkupjat, inklużi l-linji tal-bidu u tat-tmiem.