Lietotnes GitHub izmantošana lietotnē Google Chat

Izmantojiet lietotni GitHub lietotnē Chat, lai saņemtu paziņojumus par GitHub notikumiem, piemēram, izdevumiem, atgādāšanas pieprasījumiem un komentāriem.

Pirms darba sākšanas

Lai izmantotu lietotni GitHub lietotnē Chat, jums ir nepieciešams tālāk norādītais.

• Lai instalētu lietotnes, ir nepieciešama Google Workspace administratora atļauja.
• Pievienojiet lietotni pakalpojumam Chat. Uzziniet, kā atrast lietotnes un pievienot tās pakalpojumā Chat.
• Jums ir nepieciešams GitHub konts.
• Jums ir jāinstalē lietotne Google Chat savai GitHub krātuvei.

Izpratne par lietotnes GitHub un lietotnes OAuth autentifikācijas mehānismiem

Šajā rakstā ir aprakstītas GitHub lietotņu un OAuth lietotņu atšķirīgās iezīmes un darbības modeļi, kas kalpo kā galvenie mehānismi trešo pušu pakalpojumu integrēšanai un piekļuvei GitHub resursiem. Lai organizācijā uzturētu optimālu drošības līmeni, ir ļoti svarīgi vispusīgi izprast šīs atšķirības.

1. Salīdzinošā analīze: galvenās atšķirības

Galvenās atšķirības starp šiem diviem modeļiem ir piekļuvei izmantotā identitāte (Identitāte) un mehānisms, kas regulē resursu autorizāciju.

Atribūts	Lietotne GitHub (ieteicamā pierakstīšanās)	Lietotne OAuth (mantotā pierakstīšanās)
Identitāte	Atkarībā no lietošanas piemēra darbojas kā neatkarīga lietojumprogrammas identitāte, kas nav saistīta ar lietotāju, vai darbojas pilnvarotā lietotāja vārdā.	Darbojas pilnvarotā lietotāja vārdā, mantojot viņa atļaujas.
Autorizācijas modelis	Detalizētas atļaujas (ieteicams): tiek izmantots minimālo atļauju princips, kas ļauj piekļūt konkrētām krātuvēm un resursu veidiem. Piemērs: tikai lasīšanas piekļuve metadatiem.	Plašas tvēruma atļaujas: piekļuve tiek definēta ar plašām tvēruma atļaujām, piemēram, piešķirot piekļuvi visiem resursiem, kas ir redzami lietotājam, kurš piešķir atļauju.
Akreditācijas datu derīguma termiņš	Īslaicīgas pilnvaras: piekļuves pilnvarām ir ierobežots derīguma termiņš (parasti viena stunda), un tās ir bieži jāatjauno, tādējādi ievērojami samazinot risku, ja tās tiks apdraudētas.	Ilgstošas pilnvaras: piekļuves pilnvaras ir spēkā, līdz lietotājs tās manuāli atsauc, un tas rada ilgstošu drošības apdraudējuma risku.
Instalēšanas prasība	To ir jāinstalē administratoram vai organizācijas īpašniekam, izveidojot formālu saiti ar kontu vai organizāciju, un lietotājam ir jāpiešķir atļauja to izmantot lietošanas piemēros, kuros lietotne darbojas lietotāja vārdā.	Jābūt pilnvarotam atsevišķam lietotājam, saistot piekļuvi tieši ar šī lietotāja identitāti.

Plašāku dokumentāciju skatiet rakstā GitHub lietotņu un OAuth lietotņu atšķirības.

2. Ieteikums

Pamatojoties uz drošības paraugpraksi, visām trešo pušu un organizāciju integrācijām ieteicams izmantot lietotnes GitHub autentifikācijas mehānismu. Šajā modelī tiek ieviests minimālo atļauju princips un tiek izmantoti uzticami, ierobežota derīguma termiņa akreditācijas dati, tādējādi tiek uzturēts augstāks drošības un darbības stabilitātes standarts salīdzinājumā ar OAuth lietotņu deleģētās pilnvaras modeli.

Instalējiet lietotni Google Chat GitHub krātuvēm.

Lietotnes GitHub iestatīšana lietotnē Chat

1. Atveriet lietotni Chat.
2. Atveriet tiešo ziņojumu ar lietotni vai pārejiet uz telpu, kurā ir attiecīgā lietotne.
3. Lai atvērtu konfigurācijas logu, noklikšķiniet uz Pierakstīties.
4. Noklikšķiniet uz Konfigurēt piekļuvi Pierakstīties GitHub kontā.
5. Pabeidziet pierakstīšanās procesu un pēc tam aizveriet uznirstošo elementu.
6. Lai atjauninātu Chat dialoglodziņu, noklikšķiniet uz Atsvaidzināt.
7. Sadaļā Pievienot krātuves ievadiet GitHub krātuvi, par kuru vēlaties saņemt paziņojumus.
8. Atzīmējiet to notikumu izvēles rūtiņas, par kuriem vēlaties saņemt paziņojumus.
9. Noklikšķiniet uz Saglabāt.

Padoms. Paziņojumi ir jāiestata katrā telpā, kurā pievienojat lietotni. Lietotne sūta paziņojumus uz visām telpām, kurās tā ir dalībniece.

Migrēšana no lietotnes OAuth (mantotā versija) uz lietotni GitHub (ieteicams)

Lai migrētu pašreizējo savienojumu no vecākās lietotnes OAuth autentifikācijas metodes uz ieteicamo lietotnes GitHub metodi, veiciet tālāk norādītās darbības.

1. Atveriet lietotni Chat.
2. Atveriet tiešo ziņojumu vai telpu ar lietotni GitHub.
3. Ziņojuma laukā noklikšķiniet uz Google Workspace rīki .
4. Komandu sarakstā atlasiet GitHub Reauthorize.
5. Lai pabeigtu migrēšanas un atkārtotas autorizācijas procesu, izpildiet ekrānā redzamos norādījumus Chat dialoglodziņā.

Lietotnes GitHub izmantošana telpās

Lai izmantotu lietotni telpās, jums ir jāmin (@jāmin vai /jāmin) lietotne katrā ziņojumā un atbildēs uz lietotnes ziņojumiem.

Minējums (@minējums vai /minējums) apstiprina, ka sūtāt ziņojumu lietotnei, nevis citiem telpas dalībniekiem.

1. Atveriet lietotni Chat .
2. Telpā ievadiet @github vai /github un pēc tam — komandu.
   • Kad minat @github vai /github, ziņojums tiek nosūtīts lietotnei, nevis citiem telpas dalībniekiem.

Lietotņu iestatījumu mainīšana

Telpā iestatījumus var mainīt tikai lietotājs, kas pievienoja lietotni.

1. Atveriet lietotni Chat.
2. Atveriet tiešo ziņojumu ar lietotni vai pārejiet uz telpu, kurā ir attiecīgā lietotne.
3. Lai atvērtu pašreizējos lietotnes iestatījumus, ievadiet /github_settings.
4. Mainiet iestatījumus.
5. Noklikšķiniet uz Saglabāt.

Noņemot lietotni no telpas, tiek dzēsti lietotnes iestatījumi.

Lietotnes GitHub komandas lietotnē Chat

Ziņojuma laukā tiešajā ziņojumā vai telpā ar lietotni GitHub lietotnē Chat varat izmantot tālāk norādītās komandas.

• Uz priekšu vērstās slīpsvītras komandas
  • /github_settings: tiek atvērts iestatījumu dialoglodziņš.
  • /github_reminders: lai pārvaldītu personīgos vai komandas atvērtos atgādāšanas pieprasījumus, iestatiet un rediģējiet ieplānotos atgādinājumus.
  • /github_subscribe: abonē GitHub <repoURL> vai <owner/repo>.
  • /github_openIssue: atver jaunu GitHub problēmu.
  • /github_logout: veic atteikšanos jūsu GitHub kontā.
  • /github_help: parāda palīdzības ziņojumu.
  • /github_feedback: nosūtiet atsauksmi par lietotni GitHub.
• Ātrās komandas: lai piekļūtu ātrajām komandām, noklikšķiniet uz Google Workspace rīki .
  • GitHub Connect: tiek parādīts ziņojums ar opcijām “Pierakstīties” un “Pierakstīties mantotajā kontā”.
  • GitHub Reauthorize: ļauj migrēt uz jaunu savienojuma izveides metodi.

Lai iegūtu pilnu atbalstīto komandu sarakstu, veiciet tālāk norādītās darbības.

1. Datorā atveriet pakalpojumu Chat.
2. Atveriet tiešo ziņojumu vai dodieties uz telpu, kur ir instalēta lietotne GitHub.
3. Ievadiet /github_help.

Ar lietotnes GitHub izmantošanu lietotnē Chat saistīto problēmu novēršana

Ja rodas kļūda, abonējot reāllaika paziņojumus

Lietotne GitHub

Lai iestatītu reāllaika paziņojumus telpās, veiciet tālāk norādītās darbības.

1. Pārlūkprogrammā atveriet GitHub profila iestatījumus.
2. Sadaļā “Integrācijas” noklikšķiniet uz Lietotnes Autorizētās GitHub lietotnes.
   • Pēc lietotnes GitHub savienošanas ar lietotni Google Chat jūsu autorizēto lietotņu sarakstā būs redzama lietotne “Google Chat”.
3. Instalējiet lietotni Google Chat GitHub krātuvei.
   • Varat arī pieprasīt instalēšanu no organizācijas/krātuves īpašnieka.
4. Uzgaidiet, līdz instalēšana ir pabeigta.
5. Lietotnē Google Chat atveriet tiešo ziņojumu vai telpu ar lietotni GitHub.
6. Lai izveidotu abonementu, ziņojuma laukā ievadiet /github_subscribe [organizācija/repo] vai /github_settings.

Lietotne OAuth

Lai iestatītu reāllaika paziņojumus telpās:

• jums jābūt piedāvātās krātuves organizācijas īpašniekam;
• autorizējiet lietotni GitHub organizācijā.
  1. Pārlūkprogrammā atveriet GitHub profila iestatījumus.
  2. Sadaļā “Integrācijas” noklikšķiniet uz Lietotnes Autorizētās OAuth lietotnes.
     • Pēc lietotnes GitHub savienošanas ar lietotni Google Chat jūsu autorizēto lietotņu sarakstā būs redzama lietotne “Google Chat”.
  3. Piešķiriet lietotnei piekļuvi organizācijai, kurai vēlaties piekļūt.

Ja saņemat pārāk daudz paziņojumu no lietotnes GitHub

1. Ziņojuma laukā ievadiet /github_settings.
2. Lai rediģētu paziņojumu iestatījumus savai krātuvei, noklikšķiniet uz Paziņojumu iestatījumi.
3. Lai filtrētu paziņojumus, blakus katram paziņojumu veidam noklikšķiniet uz lejupvērstās bultiņas .
   • Tiks parādītas papildu iespējas paziņojumu filtrēšanai.
4. Atzīmējiet to paziņojumu izvēles rūtiņas, kurus vēlaties saņemt.
5. Noklikšķiniet uz Saglabāt.

Ja netiekat @minēts ieplānotajos atgādinājumos

Lai jūs tiktu minēts ieplānotajos atgādinājumos, jūsu Google Chat kontam jābūt savienotam ar GitHub kontu.

1. Ziņojuma laukā ievadiet /github_settings.
2. Lai savienotu savu kontu, veiciet tālāk norādītās darbības.
   1. Uznirstošajā logā noklikšķiniet uz Konfigurēt piekļuvi Pierakstīties lietotnē GitHub.
   2. Pierakstieties savā GitHub kontā.
   3. Autorizējiet lietotni.
3. Ziņojumā, ko saņemat no lietotnes GitHub, atlasiet Ieplānot atgādinājumus komandai.
4. Uznirstošajā logā:
   1. Noklikšķiniet uz Izveidot jaunu atgādinājumu.
   2. Konfigurējiet atgādinājuma iestatījumus.
   3. Noklikšķiniet uz Saglabāt.

Ja nesaņemat atgādinājumus, izmantojot lietotni GitHub

Krātuvē, no kuras vēlaties saņemt atgādinājumus, pārbaudiet, vai ir instalēta lietotne Google Chat lietotnei GitHub.

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.