Apžvalga
Šis vadovas skirtas „ChatGPT“ darbo erdvės administratoriams, savo organizacijoje atliekantiems „GitHub“ „Enterprise“ programos šablono sąranką. Šablonas nėra galutinė programa, kurią naudoja nariai. Tai sąrankos procesas, kurio metu, pateikus reikiamus „GitHub Enterprise“ konfigūracijos duomenis, sukuriamas konkrečiai darbo erdvei skirtas programos juodraštis.
Atliekant „GitHub Enterprise“ sąranką, „ChatGPT“ prijungiamas prie jūsų organizacijos „GitHub Enterprise“ serverio. Sukuriate „GitHub“ programą, užregistruojate „ChatGPT“ grįžtamojo iškvietimo URL, sugeneruojate kredencialus ir įklijuojate šias reikšmes atlikdami „ChatGPT“ šablono sąranką. Kai „ChatGPT“ sukuria programos juodraštį, galite jį paskelbti ir tvarkyti kaip kitas darbo erdvės programas.
Apie naršymą darbo erdvėje ir prieigą prie programų skaitykite straipsnyje Priedų ir programų administravimo valdikliai, saugumas ir atitiktis.
Ką nustatote
„ChatGPT“ kuriate konkrečiai darbo erdvei skirtą „GitHub Enterprise“ programą. Programa naudoja:
Jūsų „GitHub Enterprise“ serveryje užregistruotą „GitHub“ programą.
„GitHub“ programos kliento ID ir kliento slaptąjį raktą naudotojų autorizacijai per OAuth.
„GitHub“ programos privatųjį raktą, kad „ChatGPT“ galėtų generuoti diegimo prieigos raktus operacijoms su saugyklomis.
Žiniatinklio gaudyklės slaptąjį raktą ir URL, kad „GitHub Enterprise“ galėtų siųsti diegimo ir saugyklų įvykius į „ChatGPT“.
Jūsų „GitHub Enterprise“ serverio vardą, pavyzdžiui,
github.example.com.
Sukurkite „GitHub“ programą, o ne atskirą „GitHub OAuth“ programą. „ChatGPT“ šablono sąrankai reikalingi „GitHub“ programos kredencialai, privatusis raktas ir žiniatinklio gaudyklės nustatymai.
Prieš pradedant
Jums reikės:
„ChatGPT“ darbo erdvės administratoriaus arba savininko prieigos.
„GitHub Enterprise“ administratoriaus arba organizacijos savininko prieigos, leidžiančios kurti ir diegti „GitHub“ programas.
Tik „GitHub Enterprise“ serverio vardo, be
https://ar kelio.Nuspręsti, kokius veiksmus su saugyklomis turėtų palaikyti „ChatGPT“, pavyzdžiui, tik skaitymui skirtą saugyklų paiešką, pull request darbo eigas, problemų darbo eigas, failų redagavimą, „GitHub Actions“ ar platesnes „Codex“ darbo eigas.
Saugios vietos „GitHub“ programos privačiajam raktui ir kliento slaptajam raktui tvarkyti.
Laikykite „ChatGPT“ ir „GitHub Enterprise“ atidarytus atskiruose skirtukuose. Nekurkite grįžtamojo iškvietimo URL patys. Nukopijuokite tikslų „ChatGPT“ rodomą grįžtamojo iškvietimo URL.
Reikšmės, kurias reikia paruošti
„GitHub Enterprise“ serverio vardas, pavyzdžiui,
github.example.com.Grįžtamojo iškvietimo URL: nukopijuokite jį iš „ChatGPT“ šablono sąrankos.
„GitHub“ programos kliento ID.
„GitHub“ programos kliento slaptasis raktas.
„GitHub“ programos privatusis raktas PEM formatu.
„ChatGPT“ sugeneruotas žiniatinklio gaudyklės slaptasis raktas.
Žiniatinklio gaudyklės URL, sugeneruotas sukūrus programos juodraštį „ChatGPT“.
Pradėkite šablono sąranką „ChatGPT“
„ChatGPT“ perjunkite į darbo erdvę, kurioje programa turėtų būti pasiekiama.
Atidarykite Darbo erdvės nustatymai > Programos. Taip pat galite atidaryti administravimo konsolę, pasirinkti reikiamą „ChatGPT“ darbo erdvę ir atidaryti Priedai. Pasirinkite Tvarkyti ankstesnes programas, kad atidarytumėte išsaugotą puslapį Programos.
Pasirinkite Katalogas.
Ieškokite „GitHub Enterprise“.
Pasirinkite „GitHub Enterprise“ programos šabloną ir pradėkite sąranką.
Įveskite aiškų programos pavadinimą ir aprašą, pavyzdžiui, „GitHub Enterprise“ arba „GitHub Enterprise – inžinerija“.
Įveskite „GitHub Enterprise“ serverio vardą, pavyzdžiui,
github.example.com.Nukopijuokite „ChatGPT“ rodomą grįžtamojo iškvietimo URL. Palikite šį skirtuką atidarytą.
Nukopijuokite sugeneruotą žiniatinklio gaudyklės slaptąjį raktą, jei jis rodomas atliekant sąranką.
Grįžtamojo iškvietimo URL pavyzdys: https://chatgpt.com/connector/oauth/<callback_id>
Nepašalinkite grįžtamojo iškvietimo ID, nepridėkite pasvirojo brūkšnio gale ir nekeiskite šio adreso bendruoju „ChatGPT“ URL.
Sukurkite „GitHub“ programą „GitHub Enterprise“
Atidarykite savo „GitHub Enterprise“ serverį, pavyzdžiui,
https://github.example.com.Eikite į organizaciją arba paskyrą, kuriai turėtų priklausyti programa.
Atidarykite „Nustatymai > Kūrėjo nustatymai > GitHub programos“.
Pasirinkite Nauja „GitHub“ programa.
Įveskite aiškų programos pavadinimą, pavyzdžiui, „ChatGPT GitHub Enterprise jungtis“.
Įveskite pagrindinio puslapio URL. Jei nėra specialaus vidinio puslapio, naudokite „GitHub Enterprise“ organizacijos URL.
Į lauką „Grįžtamojo iškvietimo URL“ įklijuokite tikslų iš „ChatGPT“ nukopijuotą grįžtamojo iškvietimo URL.
Palikite įjungtą parinktį „Riboti naudotojų autorizacijos raktų galiojimą“, nebent jūsų saugumo komanda turi konkrečią priežastį ją pakeisti.
Įjunkite parinktį „Prašyti naudotojo autorizacijos diegiant“, kad naudotojai galėtų suteikti programai leidimą diegimo arba prijungimo metu.
Skiltyje „Kur galima įdiegti šią „GitHub“ programą?“ pasirinkite siauriausią parinktį, atitinkančią jūsų diegimo planą.
Sukurkite „GitHub“ programą.
Nustatykite leidimus ir įvykius
Pasirinkite minimalius leidimus, reikalingus „ChatGPT“ veiksmams, kuriuos planuojate įjungti.
Jei saugyklas norite tik rasti ir gauti atsakymus į klausimus jų nekeisdami, pradėkite nuo skaitymo leidimų, pavyzdžiui:
Metaduomenys: tik skaityti. „GitHub“ programoms privaloma suteikti prieigą prie metaduomenų.
Turinys: tik skaityti, kad būtų galima pasiekti failų ir saugyklų turinį.
Problemos: tik skaityti, jei reikia ieškoti problemų arba jas skaityti.
Pull requests: tik skaityti, jei reikia ieškoti pull request arba gauti peržiūrai reikalingą kontekstą.
Veiksmai: tik skaityti, jei reikia darbo eigų vykdymo būsenos, užduočių, žurnalų arba artefaktų.
Darbo eigoms, kurios keičia duomenis, pridėkite rašymo leidimus tik ten, kur būtina, pavyzdžiui, turiniui, pull requests, problemoms, veiksmams arba darbo eigoms. Suteikite kuo siauresnius leidimus, kurių pakaktų numatytiems „ChatGPT“ veiksmams.
Žiniatinklio gaudyklės įvykiai turėtų atitikti palaikomas darbo eigas. Dažnai naudojami įvykiai: diegimas, diegimo saugyklos, pakeitimų siuntimas, pull request, problemos, problemos komentaras, darbo eigos vykdymas ir darbo eigos užduotis.
Sugeneruokite ir nukopijuokite „GitHub“ programos kredencialus
„GitHub“ programos nustatymuose nukopijuokite Kliento ID.
Sugeneruokite Kliento slaptąjį raktą ir iš karto jį nukopijuokite.
Skiltyje Privatieji raktai sugeneruokite privatųjį raktą.
Atsisiųskite .pem failą ir saugiai jį laikykite.
Atidarykite .pem failą savo kompiuteryje ir nukopijuokite visą PEM tekstą, įskaitant pradžios ir pabaigos eilutes.
Privatusis raktas yra konfidencialus. Saugokite jį kaip prisijungimo duomenis. Jei jis nutekėjo, sugeneruokite naują privatųjį raktą, atnaujinkite „ChatGPT“ programos sąranką ir ištrinkite pažeistą raktą iš „GitHub Enterprise“.
Užbaikite sąranką „ChatGPT“
Grįžkite į „ChatGPT“ šablono sąrankos skirtuką.
Įklijuokite „GitHub“ programos kliento ID į lauką OAuth kliento ID.
Įklijuokite „GitHub“ programos kliento slaptąjį raktą į lauką OAuth kliento slaptasis raktas.
Nekeiskite lauko Prieigos sritys, nebent jūsų organizacijai būtina pakeisti numatytąsias šablono reikšmes.
Patikrinkite, ar „GitHub Enterprise“ serverio vardo lauke įvestas tik serverio vardas, pavyzdžiui,
github.example.com.Įklijuokite arba įkelkite „GitHub“ programos privatųjį raktą PEM formatu į lauką „GitHub programos privatusis raktas“.
Patikrinkite, ar yra sugeneruotas žiniatinklio gaudyklės slaptasis raktas.
Sukurkite programos juodraštį.
„ChatGPT“ atidarykite sukurto programos juodraščio informaciją ir nukopijuokite sugeneruotą žiniatinklio gaudyklės URL.
Žiniatinklio gaudyklės URL turėtų atrodyti taip: https://connectors.api.openai.org/connectors/<connector_id>/webhook
Užbaikite žiniatinklio gaudyklės sąranką „GitHub Enterprise“
Grįžkite į „GitHub“ programos nustatymus „GitHub Enterprise“.
Atidarykite „GitHub“ programos bendruosius nustatymus.
Įjunkite parinktį „Aktyvios žiniatinklio gaudyklės“, jei ji dar neįjungta.
Įklijuokite „ChatGPT“ žiniatinklio gaudyklės URL į lauką „Žiniatinklio gaudyklės URL“.
Įklijuokite „ChatGPT“ žiniatinklio gaudyklės slaptąjį raktą į lauką „Žiniatinklio gaudyklės slaptasis raktas“.
Palikite SSL tikrinimą įjungtą.
Patikrinkite, ar prenumeruojami žiniatinklio gaudyklės įvykiai atitinka suteiktus leidimus ir įjungtus veiksmus.
Išsaugokite pakeitimus.
Paskelbkite ir tvarkykite programą „ChatGPT“
Sukūrus programos juodraštį, programa automatiškai netampa pasiekiama nariams. Peržiūrėję juodraštį:
Paskelbkite programos juodraštį.
Darbo erdvės nustatymuose atidarykite puslapį Programos, tada Įjungtos ir patikrinkite, ar programa rodoma. Puslapį „Programos“ taip pat galite atidaryti pasirinkę „Tvarkyti ankstesnes programas“ skiltyje „Administravimo konsolė > Priedai“.
Skiltyje Naudotojų prieiga nustatykite, kuriems vaidmenims leidžiama naudoti programą.
Skiltyje Veiksmų valdymas peržiūrėkite skaitymo ir rašymo veiksmų nustatymus.
Peržiūrėkite Programos leidimus ir pasirinkite, kada prieš naudodamas programą „ChatGPT“ turi prašyti narių patvirtinimo.
Paprašykite prieigą turinčio bandomojo naudotojo atidaryti „ChatGPT“ programas ir patikrinti, ar programa rodoma.
Šie programos leidimai taikomi „ChatGPT“ pokalbiams. Darbo erdvės agentams taikomi atskiri jų kūrėjų nustatyti valdikliai, pagal kuriuos nustatoma, kokie programos veiksmai pasiekiami ir kada galutinių naudotojų prašoma juos patvirtinti. Apie agentų veikimą skaitykite straipsnyje „ChatGPT“ darbo erdvės agentai „Enterprise“ ir „Business“ planuose.
Įdiekite ir išbandykite „GitHub“ programą
„GitHub Enterprise“ įdiekite „GitHub“ programą organizacijoje arba paskyroje.
Pagal darbo erdvės politiką pasirinkite visas arba tik tam tikras saugyklas.
Prisijungę kaip prieigą turintis naudotojas, pradėkite prijungimo procesą „ChatGPT“.
Kai būsite paraginti, suteikite „GitHub“ programai leidimą.
Pirmiausia atlikite nedidelį skaitymo veiksmą, pavyzdžiui, gaukite pasiekiamų saugyklų sąrašą arba žinomą pull request.
Jei įjungti rašymo veiksmai, prieš pradėdami platesnį naudojimą išbandykite juos saugykloje, kurioje pakeitimai kelia mažą riziką.
Serverio vardas ir OAuth veikimas
„ChatGPT“ pagal serverio vardą nustato „GitHub Enterprise“ galinių taškų adresus. Įveskite tik serverio vardą, pavyzdžiui, github.example.com arba octocorp.ghe.com.
Neįveskite API ar saugyklos kelio. Taip pat neįveskite github.com, nebent tai tikslus šios programos „GitHub Enterprise“ serverio vardas.
Trikčių šalinimas
Peradresavimo URI neatitiktis: patikrinkite, ar „GitHub“ programos grįžtamojo iškvietimo URL tiksliai atitinka „ChatGPT“ rodomą grįžtamojo iškvietimo URL.
„ChatGPT“ negali sukurti arba išsaugoti programos juodraščio: patikrinkite, ar užpildyti visi privalomi laukai, įskaitant serverio vardą, OAuth kliento ID, OAuth kliento slaptąjį raktą, privatųjį raktą ir žiniatinklio gaudyklės slaptąjį raktą.
Autentifikavimas sėkmingas, bet saugyklos iškvietimai nepavyksta: patikrinkite, ar „GitHub“ programa įdiegta ir turi prieigą prie saugyklos.
API grąžina 403 arba praneša, kad nepakanka leidimų: pridėkite trūkstamą „GitHub“ programos leidimą ir, jei prašoma, paprašykite programos diegimo savininko patvirtinti atnaujintus leidimus.
Nerodomos jokios saugyklos: patikrinkite, ar diegiant programą įtrauktos reikiamos saugyklos ir ar „ChatGPT“ autorizaciją suteikiantis naudotojas turi prieigą prie jų.
Nepavyksta pristatyti žiniatinklio gaudyklės pranešimų: patikrinkite, ar žiniatinklio gaudyklės URL ir slaptasis raktas atitinka „ChatGPT“ reikšmes, palikite SSL tikrinimą įjungtą ir įsitikinkite, kad „GitHub Enterprise“ serveris gali pasiekti
connectors.api.openai.org.Privačiojo rakto klaidos: patikrinkite, ar nukopijuotas visas PEM turinys, įskaitant pradžios ir pabaigos eilutes.