GitHub-sovelluksen käyttäminen Google Chatissa

Käyttämällä GitHub-sovellusta Chatissa saat ilmoituksia GitHub-tapahtumista, kuten ongelmista, pull-pyynnöistä ja kommenteista.

Ennen aloittamista

Jos haluat käyttää GitHub-sovellusta Chatissa:

• Tarvitset luvan sovellusten asentamiseen Google Workspace ‑järjestelmänvalvojalta.
• Lisää sovellus Chatiin. Katso, miten voit etsiä sovelluksia ja lisätä ne Chatiin.
• Tarvitset GitHub-tilin.
• Sinun on asennettava GitHub-datasäilön Google Chat ‐sovellus.

GitHub-sovelluksen ja OAuth-sovelluksen todennusmekanismit

Tässä kerrotaan GitHub-sovellusten ja OAuth-sovellusten ominaisuuksista ja toimintamalleista. Ne ovat ensisijaisia mekanismeja, joiden avulla kolmannen osapuolen palvelut voivat integroitua GitHubiin ja käyttää sen resursseja. Näiden erojen ymmärtäminen on tärkeää organisaation tietoturva säilyttämiseksi optimaalisella tasolla.

1. Vertailuanalyysi: Tärkeimmät erot

Mallien perusero on pääsyoikeuksien myöntämiseen käytettävässä identiteetissä (pääkäyttäjä) ja resurssien valtuutusta säätelevässä mekanismissa.

Määrite	GitHub-sovellus (suositeltu kirjautumistapa)	OAuth-sovellus (vanha sisäänkirjautuminen)
Pääkäyttäjän identiteetti	Toimii riippumattomana sovelluksen identiteettinä, joka on erillinen käyttäjästä, tai valtuuttavan käyttäjän puolesta käyttötapauksesta riippuen.	Toimii valtuuttavan käyttäjän puolesta ja perii hänen oikeutensa.
Valtuutusmalli	Tarkat luvat (suositus): Käyttää suppeimpien oikeuksien periaatetta, mikä mahdollistaa pääsyn tiettyihin arkistoihin ja resurssityyppeihin. Esimerkki: Vain lukuoikeus metadataan.	Laajat laajuudet: Pääsy määritetään laajoilla laajuuksilla, kuten myöntämällä pääsy kaikkiin valtuuttavalle käyttäjälle näkyviin resursseihin.
Kirjautumistietojen käyttöikä	Lyhytikäiset tunnukset: Käyttötunnusten elinkaari on rajallinen (yleensä tunti), ja ne on uusittava usein. Tämä vähentää merkittävästi riskiä, jos tunnukset vaarantuvat.	Pitkäkestoiset tunnukset: Pääsyoikeustunnukset pysyvät voimassa, kunnes käyttäjä peruu ne manuaalisesti, mikä aiheuttaa pitkäaikaisen altistumisriskin.
Asennusvaatimus	Järjestelmänvalvojan tai organisaation omistajan on asennettava se, jotta tilille tai organisaatiolle luodaan virallinen linkki. Käyttäjän on valtuutettava sovellus käyttötapauksissa, joissa sovellus toimii käyttäjän puolesta.	Yksittäisen käyttäjän on valtuutettava pääsy, jolloin pääsyoikeus linkitetään suoraan kyseisen käyttäjän identiteettiin.

Lisätietoa on GitHub-sovellusten ja OAuth-sovellusten eroista.

2. Suositus

Tietoturvan parhaiden käytäntöjen mukaisesti GitHub-sovelluksen todennusmekanismia suositellaan kaikille kolmannen osapuolen ja organisaation integroinneille. Tämä malli noudattaa suppeimpien oikeuksien periaatetta ja käyttää vahvoja, rajoitetun ajan voimassa olevia valtuuksia, mikä ylläpitää korkeampaa tietoturvan ja toiminnan vakauden tasoa kuin OAuth-sovellusten valtuutettu valtuutusmalli.

Asenna GitHub-datasäilöjen Google Chat ‐sovellus.

GitHub-sovelluksen määrittäminen Chatissa

1. Avaa Chat.
2. Avaa viesti tai siirry tilaan sovelluksella.
3. Avaa määritysikkuna valitsemalla Sign in (Kirjaudu sisään).
4. Valitse Configure Access (Määritä pääsy) Sign in to GitHub (Kirjaudu GitHubiin).
5. Viimeistele sisäänkirjautuminen ja sulje sitten ponnahdusikkuna.
6. Päivitä Chat-valintaikkuna klikkaamalla Refresh (Päivitä).
7. Lisää Add Repositories (Lisää datasäilöt) ‑kohtaan GitHub-datasäilö, josta haluat saada ilmoituksia.
8. Merkitse niiden tapahtumien valintaruudut, joista haluat saada ilmoituksia.
9. Klikkaa Tallenna.

Vinkki: Ilmoitukset on otettava käyttöön jokaisessa tilassa, johon lisäät sovelluksen. Sovellus lähettää ilmoituksia kaikkiin tiloihin, joiden jäsen se on.

Siirtyminen OAuth-sovelluksesta (vanha) GitHub-sovellukseen (suositus)

Näin voit siirtää nykyisen yhteyden vanhemmasta OAuth-sovelluksen todennusmenetelmästä suositeltuun GitHub-sovelluksen menetelmään:

1. Avaa Chat.
2. Avaa viesti tai tila, jossa on GitHub-sovellus.
3. Klikkaa viestikentästä Google Workspacen työkalut .
4. Valitse komentolistalta GitHub Reauthorize (GitHubin uudelleenvaltuutus).
5. Viimeistele siirto ja uudelleenvaltuutus seuraamalla Chat-ikkunassa olevia ohjeita.

GitHub-sovelluksen käyttö tiloissa

Jos haluat käyttää sovellusta tiloissa, sinun on @mainittava tai /mainittava sovellus jokaisessa viestissä ja sovelluksen viestien vastauksissa.

@maininta tai /maininta vahvistaa, että olet lähettänyt viestin sovellukselle etkä muille tilan jäsenille.

1. Avaa Chat-sovellus .
2. Kirjoita tilassa @github tai /github ja lisää sen jälkeen komento.
   • Kun lisäät maininnan @github tai /github, viesti lähetetään sovellukselle, ei muille tilan käyttäjille.

Sovellusasetusten muokkaaminen

Tilassa vain sovelluksen lisännyt henkilö voi muuttaa sen asetuksia.

1. Avaa Chat.
2. Avaa viesti tai siirry tilaan sovelluksella.
3. Avaa sovelluksen asetukset kirjoittamalla /github_settings.
4. Valitse haluamasi asetukset.
5. Klikkaa Tallenna.

Jos poistat sovelluksen tilasta, myös sen asetukset poistuvat.

Lisätietoja GitHub-sovelluksen komennoista Chatissa

GitHub-sovelluksen avulla voit Chatissa viestin tai tilan viestikentässä käyttää seuraavia järjestelmäkomentoja:

• Järjestelmäkomennot:
  • /github_settings: Avaa asetusikkunan.
  • /github_reminders: Avaa ajastettujen muistutusten luomisen tai muokkaamisen omille tai tiimin avoimille pull-pyynnöille.
  • /github_subscribe: Tilaa GitHub-kohteen <repoURL> tai <owner/repo>.
  • /github_openIssue: Avaa uuden GitHub-tapauksen.
  • /github_logout: Kirjaa ulos GitHub-tililtä.
  • /github_help: Näyttää ohjeviestin.
  • /github_feedback: Lähettää palautetta GitHub-sovelluksesta.
• Pikakomennot: Pääset pikakomentoihin klikkaamalla Google Workspace ‑työkaluja .
  • GitHub Connect: Näyttää viestin, jossa on "Sign in" (Kirjaudu sisään) ja "Legacy Sign in" (Vanha sisäänkirjautuminen) ‑vaihtoehdot.
  • GitHubin uudelleenvaltuutus: Voit siirtyä uuteen yhteysmenetelmään.

Näet kaikki tuetut komennot seuraavasti:

1. Avaa Chat tietokoneella.
2. Avaa viesti tai siirry tilaan, johon on asennettu GitHub-sovellus.
3. Kirjoita /github_help.

Ohjeita GitHub-sovelluksen ongelmatilanteisiin Chatissa

Jos saat virheen reaaliaikaisten ilmoitusten tilaamisen yhteydessä

GitHub-sovellus

Näin otat reaaliaikaiset ilmoitukset käyttöön tiloissa:

1. Siirry selaimella GitHub-profiiliasetuksiin.
2. Mene kohtaan "Integrations" (Integraatiot) ja klikkaa Applications (Sovellukset) Authorized GitHub apps (Valtuutetut GitHub-sovellukset).
   • Kun olet yhdistänyt GitHub-sovelluksen Google Chatiin, valtuutettujen sovellusten listassa näkyy "Google Chat".
3. Asenna GitHub-datasäilön Google Chat ‐sovellus.
   • Voit myös pyytää asennusta organisaation tai säilön omistajalta.
4. Odota, kunnes asennus on valmis.
5. Avaa Google Chatissa viesti tai tila, jossa on GitHub-sovellus.
6. Luo tilaus kirjoittamalla viestikenttään /github_subscribe [organisaatio/repo] tai /github_settings.

OAuth-sovellus

Jos haluat määrittää reaaliaikaisia ilmoituksia tiloissa, sinun pitää

• olla ehdotetun datasäilön organisaation omistaja
• valtuuttaa sovellus GitHub-organisaatiossa.
  1. Siirry selaimella GitHub-profiiliasetuksiin.
  2. Mene kohtaan "Integrations" (Integraatiot) ja klikkaa Applications (Sovellukset) Authorized OAuth apps (Valtuutetut OAuth-sovellukset).
     • Kun olet yhdistänyt GitHub-sovelluksen Google Chatiin, valtuutettujen sovellusten listassa näkyy "Google Chat".
  3. Myönnä sovellukselle pääsy valitsemaasi organisaatioon.

Jos saat liian paljon ilmoituksia GitHub-sovelluksesta

1. Kirjoita viestikenttään /github_settings.
2. Avaa datasäilön ilmoitusasetusten muokkausikkuna klikkaamalla Ilmoitusasetukset.
3. Voit suodattaa ilmoituksia klikkaamalla kunkin ilmoitustyypin vierestä alanuolta .
   • Nyt näet lisäasetuksia ilmoitusten suodattamiseksi.
4. Merkitse haluamiesi ilmoitusten ruudut valituiksi.
5. Klikkaa Tallenna.

Jos sinua ei @mainita ajastetuissa muistutuksissa

Sinun on yhdistettävä Google Chat- ja GitHub-tilisi toisiinsa, jotta sinut voidaan mainita ajastetuissa muistutuksissa.

1. Kirjoita viestikenttään /github_settings.
2. Näin yhdistät tilit:
   1. Klikkaa avautuvasta ikkunasta Configure access (Määritä pääsy) Sign in to GitHub (Kirjaudu GitHubiin).
   2. Kirjaudu GitHub-tilillesi.
   3. Valtuuta sovellus.
3. Valitse GitHub-sovellukselta saamastasi viestistä Ajasta muistutukset tiimille.
4. Tee ponnahdusikkunassa näin:
   1. Klikkaa Luo uusi muistutus.
   2. Valitse muistutusasetukset.
   3. Klikkaa Tallenna.

Jos et saa muistutuksia GitHub-sovelluksella

Varmista, että GitHubin Google Chat ‑sovellus on asennettu datasäilöön, josta haluat saada muistutuksia.

_{Google, Google Workspace ja niihin liittyvät merkit ja logot ovat Google LLC:n tavaramerkkejä. Muut yritysten ja tuotteiden nimet voivat olla niihin liittyvien yritysten tavaramerkkejä.}