Programos „GitHub“ naudojimas sistemoje „Google Chat“

Naudokite programą „GitHub“ programoje „Chat“, kad gautumėte pranešimus apie „GitHub“ įvykius, pvz., problemas, gautas užklausas ir komentarus.

Prieš pradedant

Jei norite naudoti „GitHub“ programą, skirtą „Chat“, atlikite toliau nurodytus veiksmus.

• Turite gauti Google Workspace administratoriaus leidimą įdiegti programas.
• Pridėkite programą prie „Chat“. Sužinokite, kaip rasti programas ir pridėti jas prie „Chat“.
• Reikalinga „GitHub“ paskyra.
• Turite įdiegti „Google Chat“ programą, skirtą „GitHub“ saugyklai.

„GitHub“ programos ir „OAuth“ programos autentifikavimo mechanizmų paaiškinimas

Čia aprašomos skirtingos „GitHub“ programų ir „OAuth“ programų charakteristikos bei veikimo modeliai, kurie yra pagrindiniai trečiųjų šalių paslaugų integravimo su „GitHub“ šaltiniais ir prieigos prie jų mechanizmai. Norint išlaikyti optimalią saugos būseną organizacijoje, labai svarbu išsamiai suprasti šiuos skirtumus.

1. Lyginamoji analizė: pagrindiniai skirtumai

Pagrindiniai dviejų modelių skirtumai yra prieigai naudojama tapatybė (Subjektas) ir mechanizmas, reglamentuojantis šaltinių prieigos teisę.

Atributas	„GitHub“ programa (rekomenduojama prisijungti)	„OAuth“ programa (pasenęs prisijungimas)
Subjekto tapatybė	Veikia kaip nepriklausoma programos tapatybė, atskirta nuo bet kurio naudotojo, arba įgalioto naudotojo vardu, atsižvelgiant į naudojimo atvejį.	Veikia įgalioto naudotojo vardu, perimdama jo privilegijas.
Įgaliojimo modelis	Išsamūs leidimai (rekomenduojama): naudojamas mažiausių privilegijų principas, leidžiantis pasiekti konkrečias saugyklas ir šaltinių tipus. Pavyzdžiui: tik skaitymo prieiga prie metaduomenų.	Plati apimtis: prieiga apibrėžiama pagal plačią apimtį, pvz., suteikiant prieigą prie visų šaltinių, matomų įgaliotam naudotojui.
Prisijungimo duomenų galiojimo laikas	Trumpalaikiai prieigos raktai: prieigos raktų galiojimo laikas yra ribotas (paprastai viena valanda) ir juos reikia dažnai atnaujinti, todėl gerokai sumažėja rizika, jei jie būtų pažeisti.	Ilgai saugomi prieigos raktai: prieigos raktai išlieka, kol naudotojas juos anuliuoja neautomatiniu būdu, todėl kyla ilgalaikio duomenų atskleidimo rizika.
Diegimo reikalavimas	Turi įdiegti administratorius arba organizacijos savininkas, nustatydamas oficialią nuorodą į paskyrą ar organizaciją ir įgaliotas naudotojo naudoti tais atvejais, kai programa veikia naudotojo vardu.	Turi leisti atskiras naudotojas, susiedamas prieigą tiesiogiai su to naudotojo tapatybe.

Jei reikia išsamesnės dokumentacijos, žr. skiltį „GitHub“ programų ir „OAuth“ programų skirtumai“.

2. Rekomendacija

Atsižvelgiant į geriausios saugos praktikos pavyzdžius, „GitHub“ programos autentifikavimo mechanizmas rekomenduojamas visoms trečiųjų šalių ir organizacijų integracijoms. Šis modelis taiko mažiausių privilegijų principą ir naudoja patikimus, pagal laiką ribotus prisijungimo duomenis, todėl užtikrina aukštesnį saugos ir veikimo stabilumo standartą, palyginti su „OAuth“ programų deleguotos prieigos modeliu.

Įdiekite „Google Chat“ programą, skirtą „GitHub“ saugykloms.

Programos „GitHub“ nustatymas programoje „Chat“

1. Atidarykite „Chat“.
2. Atidarykite tiesioginį pranešimą su programa arba eikite į erdvę, prie kurios pridėta programa.
3. Jei norite atidaryti konfigūravimo langą, spustelėkite Prisijungti.
4. Spustelėkite Konfigūruoti prieigą Prisijungti prie „GitHub“.
5. Užbaikite prisijungimo procesą, tada uždarykite iššokantįjį langą.
6. Jei norite atnaujinti pokalbio dialogo langą, spustelėkite Atnaujinti.
7. Skiltyje Pridėti saugyklų įveskite „GitHub“ saugyklą, kurios pranešimus norite gauti.
8. Pažymėkite įvykių, kurių pranešimus norite gauti, laukelius.
9. Spustelėkite Išsaugoti.

Patarimas: pranešimus turite nustatyti kiekvienoje erdvėje, kurioje pridedate programą. Programa siunčia pranešimus į visas erdves, prie kurių ji pridėta.

Perėjimas nuo „OAuth“ programos (pasenusi) prie „GitHub“ programos (rekomenduojama)

Jei norite perkelti dabartinį ryšį iš senesnio „OAuth“ programos autentifikavimo metodo į rekomenduojamą „GitHub“ programos metodą, atlikite toliau nurodytus veiksmus.

1. Atidarykite „Chat“.
2. Atidarykite tiesioginį pranešimą arba erdvę naudodami „GitHub“ programą.
3. Pranešimo lauke spustelėkite „Google Workspace“ įrankiai“ .
4. Komandų sąraše pasirinkite GitHub“ pakartotinis leidimo suteikimas.
5. Kad užbaigtumėte perkėlimo ir pakartotinio įgaliojimo procesą, vadovaukitės ekrane pateiktomis instrukcijomis pokalbio lange.

„GitHub“ programos naudojimas erdvėse

Jei norite naudoti programą erdvėse, turite @minėti arba /minėti programą kiekviename pranešime ir atsakymuose į programos pranešimus.

@minėjimas arba /minėjimas patvirtina, kad pranešimą išsiuntėte programai, o ne kitiems erdvėje.

1. Atidarykite programą „Chat“ .
2. Erdvėje įveskite @github arba /github ir komandą.
   • Kai paminite @github arba /github, pranešimas siunčiamas į programą, bet ne kitiems žmonėms erdvėje.

Programos nustatymų keitimas

Erdvėse nustatymus gali pakeisti tik programą pridėjęs asmuo.

1. Atidarykite „Chat“.
2. Atidarykite tiesioginį pranešimą su programa arba eikite į erdvę, prie kurios pridėta programa.
3. Jei norite atidaryti dabartinius programos nustatymus, įveskite /github_settings.
4. Pakeiskite nustatymus, kaip reikia.
5. Spustelėkite Išsaugoti.

Pašalinus programą iš erdvės, programos nustatymai ištrinami.

Sužinokite apie programos „GitHub“ komandas programoje „Chat“

Tiesioginio pranešimo ar erdvės su programa „GitHub“ programoje „Chat“ pranešimo lauke galite naudoti toliau nurodytas komandas.

• Pasvirojo brūkšnio komandos
  • /github_settings: atidaromas nustatymų dialogo langas.
  • /github_reminders: nustatomi ir redaguojami suplanuoti priminimai, skirti atviroms asmens ar komandos gautoms užklausoms.
  • /github_subscribe: prenumeruojami „GitHub“ <repoURL> arba <owner/repo>.
  • /github_openIssue: atidaroma nauja „GitHub“ problema.
  • /github_logout: atsijungiama nuo jūsų „GitHub“ paskyros.
  • /github_help: rodomas pagalbos pranešimas.
  • /github_feedback: siunčiamas atsiliepimas apie „GitHub“ programą.
• Sparčiosios komandos: jei norite pasiekti sparčiąsias komandas, spustelėkite „Google Workspace“ įrankiai“ .
  • „GitHub Connect“: rodomas pranešimas su parinktimis „Prisijungti“ ir „Pasenęs prisijungimas“.
  • „GitHub“ pakartotinis leidimo suteikimas: leidžia pereiti prie naujo susiejimo metodo.

Jei norite gauti visą palaikomų komandų sąrašą, atlikite toliau nurodytus veiksmus.

1. Kompiuteryje atidarykite Chat.
2. Atidarykite tiesioginį pranešimą arba eikite į erdvę, kur įdiegta „GitHub“ programa.
3. Įveskite /github_help.

Su programa „GitHub“ susijusių trikčių šalinimas programoje „Chat“

Jei pateikiamas klaidos pranešimas, kai užsiprenumeruojate gauti pranešimus realiuoju laiku

„GitHub“ programa

Jei norite nustatyti pranešimus realiuoju laiku erdvėse, atlikite toliau nurodytus veiksmus.

1. Naršyklėje eikite į „GitHub“ profilio nustatymus.
2. Skiltyje „Integravimai“ spustelėkite Programos „GitHub“ programos, kurioms suteikta prieigos teisė.
   • Kai susiesite „GitHub“ programą programoje „Google Chat“, programų, kurioms suteikta prieigos teisė, sąraše bus rodoma „Google Chat“.
3. Įdiekite „Google Chat“ programą, skirtą „GitHub“ saugyklai.
   • Arba galite paprašyti, kad organizacijos ar saugyklos savininkas įdiegtų programą.
4. Palaukite, kol bus baigtas diegimas.
5. Programoje „Google Chat“ atidarykite tiesioginį pranešimą arba erdvę su „GitHub“ programa.
6. Jei norite sukurti prenumeratą, pranešimo lauke įveskite /github_subscribe [organizacija/saugykla] arba /github_settings.

„OAuth“ programa

Jei erdvėse norite nustatyti pranešimus realiuoju laiku, turite:

• būti siūlomos saugyklos organizacijos savininkas;
• suteikti „GitHub“ programai prieigos teisę organizacijoje.
  1. Naršyklėje eikite į „GitHub“ profilio nustatymus.
  2. Skiltyje „Integravimai“ spustelėkite Programos „OAuth“ programos, kurioms suteikta prieigos teisė.
     • Kai susiesite „GitHub“ programą programoje „Google Chat“, programų, kurioms suteikta prieigos teisė, sąraše bus rodoma „Google Chat“.
  3. Suteikite programai prieigą prie organizacijos, kurią norite pasiekti.

Jei gaunate per daug pranešimų iš „GitHub“ programos

1. Pranešimo lauke įveskite /github_settings.
2. Jei norite redaguoti saugyklos pranešimų nustatymus, spustelėkite Pranešimų nustatymai.
3. Jei norite filtruoti pranešimus, šalia kiekvieno pranešimo tipo spustelėkite rodyklę žemyn .
   • Bus parodytos papildomos parinktys, skirtos pranešimams filtruoti.
4. Pažymėkite norimų pranešimų laukelius.
5. Spustelėkite Išsaugoti.

Jei nesate @minimi suplanuotuose priminimuose

Jei norite būti minimi suplanuotuose priminimuose, turite būti susieję „Google Chat“ ir „GitHub“ paskyras.

1. Pranešimo lauke įveskite /github_settings.
2. Jei norite susieti paskyrą, atlikite toliau nurodytus veiksmus.
   1. Iššokančiajame lange spustelėkite Konfigūruoti prieigą Prisijungti prie „GitHub“.
   2. Prisijunkite prie „GitHub“ paskyros.
   3. Suteikite programai prieigos teisę.
3. Pranešime, kurį gausite iš „GitHub“ programos, pasirinkite Suplanuoti komandai skirtus priminimus.
4. Iššokančiajame lange atlikite toliau nurodytus veiksmus.
   1. Spustelėkite Sukurti naują priminimą.
   2. Konfigūruokite priminimų nustatymus.
   3. Spustelėkite Išsaugoti.

Jei negaunate priminimų naudodami „GitHub“ programą

Saugykloje, iš kurios norite gauti priminimus, patvirtinkite „Google Chat“ programos, skirtos „GitHub“, diegimą.

Google, Google Workspace, and related marks and logos are trademarks of Google LLC. All other company and product names are trademarks of the companies with which they are associated.