Penyiapan integrasi Google Workspace

Kontribusi integrasi ini

Google Workspace dapat menyumbangkan aktivitas siklus hidup pengguna, proses masuk, MFA, administratif, dan perlindungan data yang telah dinormalisasi. Contoh yang telah ditinjau meliputi:

account.compromised — akun ditandai sebagai telah disusupi

data.sensitive.downloaded — mengunduh data sensitif

auth.login.unusual — masuk dari konteks yang tidak biasa

Yang dibutuhkan Living Security

Kredensial	Deskripsi
Kunci akun layanan	Kunci JSON untuk akun layanan Google Cloud khusus.
Administrator yang didelegasikan	Email administrator Google Workspace yang dapat ditiru (impersonate) oleh akun layanan.

Aktifkan API Admin SDK dan otorisasikan hanya cakupan (scope) yang dibaca oleh koneksi:

https://www.googleapis.com/auth/admin.reports.audit.readonly

https://www.googleapis.com/auth/admin.directory.user.readonly

https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly

Penyiapan

Buat akun layanan Google Cloud

Buat akun layanan khusus, aktifkan delegasi tingkat domain (domain-wide delegation), dan unduh kunci JSON-nya. Simpan kunci tersebut dengan aman.

Otorisasi delegasi tingkat domain

Di Google Admin Console, buka Security → Access and data control → API controls → Manage Domain Wide Delegation. Tambahkan client ID numerik milik akun layanan beserta ketiga cakupan hanya-baca di atas.

Pilih administrator yang didelegasikan

Pilih administrator Workspace aktif yang dapat membaca direktori, penetapan peran, dan laporan audit. Living Security menggunakan identitas ini hanya untuk pembacaan API yang didelegasikan.

Verifikasi dan pemecahan masalah

Pastikan koneksi dapat membaca satu pengguna direktori dan aktivitas login terbaru. Google menyebutkan bahwa pemberian delegasi tingkat domain yang baru dapat memerlukan waktu untuk menyebar.

unauthorized_client

Pastikan delegasi tingkat domain menggunakan client ID numerik milik akun layanan, bukan alamat emailnya, dan bahwa ketiga cakupan sama persis.

Direktori berfungsi tetapi penetapan peran tidak ada

Tambahkan admin.directory.rolemanagement.readonly ke entri delegasi dan pastikan administrator yang didelegasikan dapat melihat penetapan peran.

Laporan kosong

Pastikan Admin Reports API telah diaktifkan dan administrator yang didelegasikan dapat mengakses pelaporan audit untuk tenant Workspace.

Integrasi