Menggunakan aplikasi GitHub di Google Chat

Gunakan aplikasi GitHub di Google Chat untuk mendapatkan notifikasi terkait peristiwa GitHub, seperti masalah, permintaan pull, dan komentar.

Sebelum memulai

Agar dapat menggunakan aplikasi GitHub untuk Chat:

• Anda memerlukan izin untuk menginstal aplikasi dari administrator Google Workspace.
• Tambahkan aplikasi ke Chat. Pelajari cara menemukan aplikasi dan menambahkannya ke Chat.
• Anda memerlukan akun GitHub.
• Anda perlu menginstal aplikasi Google Chat untuk repositori GitHub Anda.

Memahami mekanisme autentikasi aplikasi GitHub & aplikasi OAuth

Bagian ini menguraikan karakteristik dan model operasional yang berbeda dari aplikasi GitHub dan aplikasi OAuth, yang berfungsi sebagai mekanisme utama bagi layanan pihak ketiga untuk berintegrasi dengan dan mengakses resource GitHub. Pemahaman komprehensif tentang perbedaan ini sangat penting untuk mempertahankan postur keamanan yang optimal dalam organisasi.

1. Analisis komparatif: Perbedaan utama

Perbedaan mendasar antara 2 model ini terletak pada identitas yang digunakan untuk akses (Entitas) dan mekanisme yang mengatur otorisasi resource.

Atribut	Aplikasi GitHub (Login yang direkomendasikan)	Aplikasi OAuth (Login lama)
Identitas entitas	Bertindak sebagai Identitas Aplikasi independen, terpisah dari pengguna mana pun, atau atas nama pengguna yang memberikan otorisasi, bergantung pada kasus penggunaan.	Bertindak atas nama pengguna yang memberikan otorisasi, mewarisi hak istimewanya.
Model otorisasi	Izin terperinci (Direkomendasikan): Memanfaatkan Prinsip Hak Istimewa Terendah, sehingga memungkinkan akses ke jenis repositori dan resource tertentu. Misalnya: Akses baca hanya untuk metadata.	Cakupan luas: Akses ditentukan oleh cakupan luas seperti memberikan akses ke semua resource yang terlihat oleh pengguna yang memberikan otorisasi.
Masa berlaku kredensial	Token jangka pendek: Token akses memiliki masa berlaku terbatas (biasanya 1 jam) dan memerlukan perpanjangan yang sering, sehingga secara signifikan mengurangi risiko jika terjadi penyusupan.	Token jangka panjang: Token akses tetap ada hingga dicabut secara manual oleh pengguna, yang menimbulkan risiko eksposur yang berkepanjangan.
Persyaratan penginstalan	Harus diinstal oleh Administrator atau pemilik Organisasi, yang membuat link formal ke akun atau organisasi dan diizinkan oleh pengguna untuk kasus penggunaan saat aplikasi bertindak atas nama pengguna.	Harus diizinkan oleh pengguna perorangan, yang menautkan akses langsung ke identitas pengguna tersebut.

Untuk dokumentasi yang lebih komprehensif, lihat Perbedaan antara Aplikasi GitHub dan aplikasi OAuth.

2. Rekomendasi

Berdasarkan praktik terbaik keamanan, mekanisme autentikasi Aplikasi GitHub direkomendasikan untuk semua integrasi pihak ketiga dan organisasi. Model ini menerapkan Prinsip Hak Istimewa Terendah dan menggunakan kredensial yang kuat serta terbatas waktunya, sehingga mempertahankan standar keamanan dan stabilitas operasional yang lebih tinggi dibandingkan dengan model otoritas yang didelegasikan dari Aplikasi OAuth.

Instal Aplikasi Google Chat untuk repositori GitHub.

Menyiapkan aplikasi GitHub di Chat

1. Buka Chat.
2. Buka pesan langsung dengan aplikasi atau buka ruang yang memiliki aplikasi.
3. Untuk membuka jendela konfigurasi, klik Login.
4. Klik Konfigurasi Akses Login ke GitHub.
5. Selesaikan proses login, lalu tutup pop-up.
6. Untuk memperbarui dialog Chat, klik Muat ulang.
7. Di bagian Tambahkan Repositori, ketik repositori GitHub yang ingin Anda dapatkan notifikasinya.
8. Centang kotak untuk peristiwa yang ingin Anda dapatkan notifikasinya.
9. Klik Simpan.

Tips: Anda harus menyiapkan notifikasi di setiap ruang tempat Anda menambahkan aplikasi. Aplikasi mengirim notifikasi ke semua ruang tempatnya menjadi anggota.

Bermigrasi dari aplikasi OAuth (Lama) ke aplikasi GitHub (Direkomendasikan)

Untuk memigrasikan koneksi Anda saat ini dari metode autentikasi aplikasi OAuth yang lebih lama ke metode aplikasi GitHub yang direkomendasikan:

1. Buka Chat.
2. Buka pesan langsung atau ruang dengan aplikasi GitHub.
3. Di kolom pesan, klik Alat Google Workspace .
4. Dalam daftar perintah, pilih GitHub Otorisasi Ulang.
5. Untuk menyelesaikan proses migrasi dan otorisasi ulang, ikuti petunjuk di layar dalam dialog Chat.

Menggunakan aplikasi GitHub di ruang

Untuk menggunakan aplikasi dalam ruang, Anda perlu @menyebut atau /menyebut aplikasi di setiap pesan dan saat membalas pesan dari aplikasi.

@sebutan atau /sebutan mengonfirmasi bahwa Anda telah mengirim pesan ke aplikasi dan bukan ke orang lain dalam ruang.

1. Buka aplikasi Chat .
2. Dalam ruang, masukkan @github atau /github, lalu diikuti dengan perintah.
   • Saat menyebutkan @github atau /github, pesan dikirim ke aplikasi tersebut dan bukan ke orang lain dalam ruang.

Mengubah setelan aplikasi

Di ruang, hanya orang yang menambahkan aplikasi yang dapat mengubah setelan.

1. Buka Chat.
2. Buka pesan langsung dengan aplikasi atau buka ruang yang memiliki aplikasi.
3. Untuk membuka setelan aplikasi saat ini, masukkan: /github_settings.
4. Ubah setelan sesuai kebutuhan.
5. Klik Simpan.

Menghapus aplikasi dari ruang akan menghapus setelan aplikasi.

Mempelajari perintah untuk aplikasi GitHub di Chat

Di kolom pesan dalam pesan langsung atau ruang dengan aplikasi GitHub di Chat, Anda dapat menggunakan:

• Perintah garis miring:
  • /github_settings: Membuka dialog setelan.
  • /github_reminders: Membuat dan mengedit pengingat terjadwal untuk permintaan pull terbuka pribadi atau tim.
  • /github_subscribe: Berlangganan <repoURL> atau <owner/repo> GitHub.
  • /github_openIssue: Membuka masalah GitHub baru.
  • /github_logout: Logout dari akun GitHub Anda.
  • /github_help: Menampilkan pesan bantuan.
  • /github_feedback: Mengirim masukan tentang aplikasi GitHub.
• Perintah cepat: Untuk mengakses perintah cepat, klik Alat Google Workspace .
  • GitHub Hubungkan: Menampilkan pesan dengan opsi “Login” dan “Login Lama”.
  • GitHub Otorisasi Ulang: Memungkinkan Anda bermigrasi ke metode koneksi baru.

Untuk mendapatkan daftar lengkap perintah yang didukung:

1. Di komputer, buka Chat.
2. Buka pesan langsung atau buka ruang tempat aplikasi GitHub diinstal.
3. Masukkan: /github_help.

Memecahkan masalah terkait aplikasi GitHub di Chat

Jika Anda mendapatkan pesan error saat berlangganan notifikasi real-time

Aplikasi GitHub

Untuk menyiapkan notifikasi real-time di ruang:

1. Di browser, buka setelan profil GitHub.
2. Di bagian “Integrations”, klik Applications Authorized GitHub apps.
   • Setelah Anda menghubungkan aplikasi GitHub di Google Chat, daftar aplikasi yang diotorisasi akan menampilkan “Google Chat”.
3. Instal Aplikasi Google Chat untuk repositori GitHub.
   • Atau, Anda dapat meminta penginstalan dari pemilik organisasi/repositori.
4. Tunggu hingga penginstalan selesai.
5. Di Google Chat, buka pesan langsung atau ruang dengan aplikasi GitHub.
6. Di kolom pesan, untuk membuat langganan, masukkan: /github_subscribe [organisation/repo] atau /github_settings.

Aplikasi OAuth

Untuk menyiapkan notifikasi real-time di ruang, Anda harus:

• Menjadi pemilik organisasi repositori yang diajukan.
• Melakukan otorisasi aplikasi di organisasi GitHub.
  1. Di browser, buka setelan profil GitHub.
  2. Di bagian “Integrations”, klik Applications Authorized OAuth apps.
     • Setelah menghubungkan aplikasi GitHub di Google Chat, daftar aplikasi yang diotorisasi akan menampilkan "Google Chat".
  3. Izinkan akses aplikasi ke organisasi yang ingin Anda akses.

Jika Anda menerima terlalu banyak notifikasi dari aplikasi GitHub

1. Di kolom pesan, masukkan: /github_settings.
2. Untuk mengedit setelan notifikasi repositori, klik Setelan notifikasi.
3. Untuk memfilter notifikasi, klik panah bawah di samping setiap jenis notifikasi.
   • Opsi tambahan untuk memfilter notifikasi akan muncul.
4. Centang kotak notifikasi yang Anda inginkan.
5. Klik Simpan.

Jika nama Anda tidak @disebut di pengingat terjadwal

Agar nama Anda disebut di pengingat terjadwal, hubungkan terlebih dahulu akun Google Chat Anda ke akun GitHub.

1. Di kolom pesan, masukkan: /github_settings.
2. Untuk menghubungkan akun Anda:
   1. Di jendela pop-up, klik Konfigurasi akses Login ke GitHub.
   2. Login ke akun GitHub Anda.
   3. Otorisasi aplikasinya.
3. Dalam pesan yang Anda terima dari aplikasi GitHub, pilih Schedule reminders for your team.
4. Di jendela pop-up:
   1. Klik Buat pengingat baru.
   2. Konfigurasi setelan pengingat.
   3. Klik Simpan.

Jika Anda tidak mendapatkan pengingat dengan aplikasi GitHub

Di repositori tempat Anda ingin menerima pengingat, verifikasi penginstalan Aplikasi Google Chat untuk GitHub.

_{Google, Google Workspace, serta merek dan logo yang terkait adalah merek dagang Google LLC. Semua nama perusahaan dan produk lainnya adalah merek dagang masing-masing perusahaan yang terkait.}