Panduan validasi pra-migrasi
Dokumen ini menguraikan pendekatan diagnostik yang sistematis dan langkah demi langkah untuk memvalidasi penyiapan autentikasi dan instance Google Security Operations sebelum migrasi SOAR. Panduan ini berfokus pada standar SAML dan OIDC yang digunakan untuk autentikasi dan otorisasi pengguna.
Validasi penyiapan Chronicle API
Untuk memeriksa apakah Chronicle API dikonfigurasi dengan benar di project Google Cloud Anda, ikuti langkah-langkah berikut:
- Login ke konsolGoogle Cloud dan pilih project Google Cloud yang benar dari daftar project di menu navigasi atas.
- Buka menu navigasi (≡) dan buka APIs & Services > Enabled APIs & services.
- Buka daftar API & Layanan yang Diaktifkan untuk menemukan
Chronicle API. Jika tercantum: API diaktifkan.
Jika TIDAK tercantum: Klik + ENABLE APIS AND SERVICES di bagian atas, telusuri
Chronicle API, lalu klik Enable.
Untuk memverifikasi apakah Akun Layanan telah dibuat, lakukan hal berikut:
- Buka Halaman IAM di konsol Google Cloud .
- Tampilkan akun tersembunyi (langkah penting): Anda harus mencentang kotak di sisi kanan panel filter yang bertuliskan Include Google-provided role grants.
- Telusuri agen: Di panel filter, ketik
chronicle. Anda mencari alamat email yang cocok dengan pola spesifik ini:service-[PROJECT_NUMBER]@gcp-sa-chronicle.iam.gserviceaccount.com - Verifikasi izin: Pastikan akun layanan memiliki peran Chronicle Service Agent. Jika peran tidak ada, klik edit Edit dan tambahkan kembali.
Validasi penyiapan Google SecOps
- Di konsol Google Cloud , pilih project Google Cloud yang benar dari daftar.
- Buka Security > Google SecOps dan tab Single Sign-On akan muncul.
- Jika Google SecOps diaktifkan, Anda akan melihat tab bernama Single Sign-On. Jika tidak, inisiasi prospek tidak lengkap. Berikan Google Cloud project ID di formulir Google yang ada di notifikasi dalam produk. Konfirmasi tanggal dan slot waktu migrasi, lalu kirimkan formulir. Jika Anda tidak menerima respons dalam waktu 72 jam setelah pengiriman, hubungi soar-migration-to-gcom@google.com.
- Jika tab ada, klik Go to SecOps. Login yang berhasil mengonfirmasi bahwa konfigurasi autentikasi sudah benar. Jika login gagal, pastikan firewall atau proxy Anda mengizinkan domain di Akses jaringan dan daftar domain yang diizinkan. Jika masalah berlanjut, gunakan bagian berikutnya untuk men-debug konfigurasi.
Alur SAML dan pemecahan masalah
Bagian ini memberikan ringkasan proses autentikasi SAML dan menguraikan pendekatan sistematis untuk mendiagnosis dan menyelesaikan masalah konfigurasi umum.
Arsitektur alur kerja autentikasi
Memahami alur permintaan sangat penting untuk mengisolasi titik kegagalan. Diagram berikut menggambarkan jalur berurutan dari login yang berhasil.

Prosedur pemecahan masalah langkah demi langkah
Untuk mendiagnosis dan melacak proses autentikasi SAML secara efektif, Anda dapat menggunakan utilitas berbasis web yang tercantum di bagian berikut.
Meskipun Google tidak mendukung produk tertentu, alat berikut diketahui dapat membantu memecahkan masalah proses:
- Validasi SAML: samltool.io
- Tujuan: Digunakan untuk mendekode dan memvalidasi permintaan dan respons SAML mentah.
- Pemeriksaan JWT: jwt.io
- Tujuan: Digunakan untuk memeriksa klaim dan konten Token Web JSON (JWT).
Fase 1: Persiapan lingkungan
Sebelum memulai, pastikan lingkungan browser Anda siap untuk merekam traffic jaringan dengan menyelesaikan langkah-langkah berikut:
- Buka tab browser baru atau gunakan jendela Samaran.
Buka Developer Tools menggunakan pintasan untuk sistem operasi Anda:
- Windows: Tekan F12
- Linux: Tekan Ctrl + Shift + I
- macOS: Tekan Cmd + Option + I
Buka tab Jaringan.
Centang kotak Preserve log untuk memastikan tidak ada data yang hilang selama pengalihan.

Buka URL lingkungan Google SecOps Anda untuk memulai alur login. Anda akan menerima URL ini melalui email setelah menyelesaikan penyiapan Google SecOps di Langkah 5 tahap Migrasi 1 untuk pelanggan mandiri SOAR. Subjek emailnya adalah
Your Google SecOps instance is ready.
Tahap 2: Memvalidasi permintaan SAML ke IDP
Langkah ini memverifikasi pesan awal yang dikirim oleh Google Cloud ke Penyedia Identitas (IDP) Anda.
Temukan permintaan: Di panel filter tab Network, telusuri
saml.
Ekstrak data: Pilih permintaan dan klik tab Payload. Temukan parameter string kueri yang diberi label
SAMLRequest.
Dekode: Salin nilai permintaan dan tempelkan ke alat Validasi SAML (
samltool.io) untuk mendekodenya.
Verifikasi:
- Periksa Tujuan Permintaan.
- Pastikan URL ini cocok dengan setelan konfigurasi dalam IDP Anda.
Tahap 3: Memvalidasi respons SAML dari IDP
Langkah ini memverifikasi atribut yang ditampilkan oleh IDP ke Google Cloud setelah autentikasi.
Temukan respons: Di panel filter tab Network, telusuri
signin-callback.
Ekstrak data: Pilih permintaan dan klik tab Payload. Temukan data
SAMLResponse.
Dekode: Salin nilai respons dan tempelkan ke alat Validasi SAML.
Verifikasi:
- Tinjau klaim (atribut) yang ditampilkan seperti
groups,first name,last name, danemail. - Penting: Pastikan atribut ini cocok dengan konfigurasi di setelan Workforce pool di Google Cloud.
Konfirmasi bahwa nilai sudah benar untuk pengguna tertentu yang mencoba login.

- Tinjau klaim (atribut) yang ditampilkan seperti
Gambar berikut menunjukkan pemetaan atribut:

Pemetaan dalam gambar adalah sebagai berikut:
google.subject = assertion.subjectattribute.last_name = assertion.attributes.last_name[0]attribute.user_email = assertion.attributes.user_email[0]attribute.first_name = assertion.attributes.first_name[0]google.groups = assertion.attributes.groups
Bagian kiri selalu sama; ini adalah sintaksis Google. Sisi kanan sesuai dengan kunci Atribut klaim yang ditampilkan dalam respons SAML.
[0] sangat penting untuk atribut spesifik yang dinyatakan (last_name, user_email , first_name), dan tidak relevan untuk subject dan groups.
Tahap 4: Memvalidasi autentikasi Google SecOps
Langkah ini memverifikasi apakah Google Cloud mengautentikasi pengguna untuk login ke Google SecOps SOAR.
Temukan token di browser pengguna: Di kolom filter tab Network, telusuri endpoint
auth/siem.
Ekstrak data: Pilih permintaan dan lihat tab Payload. Temukan string
jwt.Dekode: Salin string JWT dan tempelkan ke alat JWT Inspection (jwt.io).

Verifikasi:
- Bandingkan klaim yang didekode untuk
given_name,family_name,email, danidpgroups. - Konfirmasi kecocokan: Nilai ini harus sama persis dengan atribut yang divalidasi di Fase 3 (Respons SAML).
- Jika nilainya cocok dan Anda masih tidak memiliki akses, periksa penetapan peran di IAM. Pastikan semua pengguna Anda ditetapkan ke salah satu peran Chronicle yang telah ditetapkan menggunakan format akun utama yang benar untuk penyiapan Identitas Anda (Workforce Identity Federation atau Cloud Identity untuk Akun yang Dikelola Google).
- Bandingkan klaim yang didekode untuk
Tahap 5: Memvalidasi akses izin SOAR
Langkah ini mengonfirmasi bahwa sistem menetapkan izin di SOAR dengan benar melalui halaman Pemetaan Grup platform.
Administrator mengakses SOAR secara otomatis karena halaman Group Mapping mengaktifkan akses default.
Anda dapat memvalidasi akses grup untuk pengguna dengan menambahkan beberapa pemetaan grup IDP di instance SOAR baru ini. Instance baru memiliki halaman Group Mapping kosong secara default. Untuk memvalidasi akses grup bagi pengguna lain, tambahkan pemetaan grup IDP ke instance SOAR baru, selesaikan langkah-langkah berikut:
- Salin pemetaan grup dari halaman Group Mappings di instance SOAR yang ada.
- Minta pengguna di grup IDP untuk mengakses URL Google SecOps baru.
Jika pengguna tidak dapat mengakses SOAR, gunakan langkah-langkah pemecahan masalah berikut:
a. Periksa respons: Buka permintaan
auth/siemdari Fase 4, lalu pilih tab Preview.b. Periksa izin: Temukan objek
permissionsdalam respons JSON.
Opsional: Untuk menghemat waktu, salin pemetaan ini ke instance Google SecOps yang ada di Settings > Advanced > Group mapping.
Alur OIDC dan pemecahan masalah
Bagian ini memberikan ringkasan proses autentikasi OIDC dan menguraikan pendekatan sistematis untuk mendiagnosis dan menyelesaikan masalah integrasi umum.
Arsitektur alur kerja autentikasi
Memahami alur permintaan sangat penting untuk mengisolasi titik kegagalan. Diagram berikut menggambarkan jalur berurutan dari login yang berhasil.

Prosedur pemecahan masalah OIDC langkah demi langkah
Untuk mendiagnosis dan melacak proses autentikasi OIDC secara efektif, Anda dapat menggunakan alat developer browser dan decoder JWT online.
- Pemeriksaan JWT: jwt.io
- Tujuan: Digunakan untuk memeriksa klaim dan konten Token Web JSON (JWT).
Fase 1: Persiapan lingkungan
Sebelum memulai, pastikan lingkungan browser Anda siap untuk merekam jaringan dengan menyelesaikan langkah-langkah berikut:
- Buka tab browser kosong baru atau di jendela samaran.
Buka Developer Tools menggunakan pintasan untuk sistem operasi Anda:
- Windows: Tekan F12
- Linux: Tekan Ctrl + Shift + I
- macOS: Tekan Cmd + Option + I
Buka tab Jaringan.
Centang kotak Preserve log untuk memastikan tidak ada data yang hilang selama pengalihan.

Buka URL lingkungan Google SecOps Anda untuk memulai alur login. Anda akan menerima URL ini melalui email setelah menyelesaikan penyiapan Google SecOps di Langkah 5 tahap Migrasi 1 untuk pelanggan mandiri SOAR. Subjek emailnya adalah
YourGoogle SecOps instance is ready.
Tahap 2: Memvalidasi permintaan otorisasi ke penyedia OIDC
Langkah ini memverifikasi pengalihan awal dari Google Cloud ke Penyedia OpenID Connect (IdP) Anda.
Temukan Permintaan: Di tab Network, cari pengalihan awal ke endpoint otorisasi penyedia OIDC Anda. URL biasanya berisi parameter seperti
client_id,redirect_uri,scope,response_type, danstate.
Verifikasi:
- Pastikan
client_idcocok dengan yang dikonfigurasi di penyedia OIDC Anda. - Pastikan
redirect_urisama persis denganhttps://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_IDyang menggantikanPOOL_IDdanPROVIDER_IDdengan pool dan penyedia Anda dari Workforce Identity Federation. - Pastikan
response_typeditetapkan ke kode. - Perhatikan parameter cakupan, yang harus menyertakan openid dan cakupan lain yang diperlukan untuk merilis klaim yang diperlukan (misalnya, email, profil).
- Pastikan
Fase 3: Memvalidasi callback dan pertukaran token
Langkah ini memverifikasi respons IdP kembali ke Google Cloud.
Temukan Callback: Di tab Network, temukan permintaan ke URL callback login: (
.../signin-callback/...).
Periksa Data: Periksa parameter URL permintaan ini. URL ini harus berisi parameter kode yang disediakan oleh IdP OIDC Anda.
Di Balik Layar: Workforce Identity Federation menukar kode ini dengan token (Token ID, Token Akses) dari endpoint token penyedia OIDC. Error pada tahap ini sering kali terlihat di Cloud Logging untuk Workforce Identity Federation.
- Verifikasi propagasi atribut dan token lengkap: Untuk memverifikasi bahwa pemetaan atribut Anda di Workforce Identity Federation memberikan hasil yang diharapkan:
- Tambahkan URI Pengalihan, yang disediakan dalam konfigurasi penyedia Workforce Identity Federation, ke URI pengalihan penyedia Anda (misalnya, https://auth.cloud.google/signin-callback/locations/global/workforcePools/POOL_ID/providers/PROVIDER_ID).
- Buka penyedia Workforce Identity Federation Anda untuk men-debug token IdP. Anda juga dapat memeriksa token lengkap. Untuk mengetahui informasi selengkapnya, lihat Memverifikasi konfigurasi produk.

- Verifikasi propagasi atribut dan token lengkap: Untuk memverifikasi bahwa pemetaan atribut Anda di Workforce Identity Federation memberikan hasil yang diharapkan:
Tahap 4: Memvalidasi autentikasi Google SecOps
Langkah ini memverifikasi apakah Google Cloud mengautentikasi pengguna untuk login ke Google SecOps SOAR.
Temukan token di browser pengguna: Di kolom filter tab Network, telusuri endpoint
auth/siem.
Ekstrak data: Pilih permintaan dan lihat tab Payload. Temukan string
jwt.Dekode: Salin string JWT dan tempelkan ke alat JWT Inspection (jwt.io).

Verifikasi:
- Bandingkan klaim yang didekode untuk
sub,given_name,family_name,email, danidpgroups. - Konfirmasi kecocokan: Nilai ini harus sesuai dengan atribut yang dirilis oleh penyedia OIDC Anda dan cara pemetaannya di Pemetaan Atribut Workforce Identity Federation. Misalnya,
attribute.first_namedi Google Cloud harus dipetakan kegiven_namedi JWT. - Peran IAM: Jika klaim sudah benar, tetapi akses ditolak dengan pesan seperti
Cannot Authenticate user, because user does not have access to the GCP project...,, periksa penetapan peran IAM. Pastikan grup pengguna (idp_groupsdi JWT) diberi peran yang diperlukan menggunakan formatprincipalSetyang benar (misalnya,principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/IDP_GROUP_NAME).
- Bandingkan klaim yang didekode untuk
Tahap 5: Memvalidasi akses izin SOAR
Langkah ini mengonfirmasi bahwa sistem menetapkan izin di SOAR dengan benar melalui halaman Pemetaan Grup platform.
Administrator mengakses SOAR secara otomatis karena halaman Group Mapping mengaktifkan akses default.
Anda dapat memvalidasi akses grup untuk pengguna dengan menambahkan beberapa pemetaan grup IDP di instance SOAR baru ini. Instance baru memiliki halaman Group Mapping kosong secara default. Untuk memvalidasi akses grup bagi pengguna lain, tambahkan pemetaan grup IDP ke instance SOAR baru, selesaikan langkah-langkah berikut:
- Salin pemetaan grup dari halaman Group Mappings di instance SOAR yang ada.
- Minta pengguna di grup IDP untuk mengakses URL Google SecOps baru.
Jika pengguna tidak dapat mengakses SOAR, gunakan langkah-langkah pemecahan masalah berikut:
a. Periksa respons: Buka permintaan
auth/siemdari Fase 4, lalu pilih tab Preview.b. Periksa izin: Temukan objek
permissionsdalam respons JSON.
Opsional: Untuk menghemat waktu, salin pemetaan ini ke instance Google SecOps yang ada di Settings > Advanced > Group mapping.
Error OIDC Umum:
invalid_redirect_uridari IdP: Pastikan URI Pengalihan yang dikonfigurasi di IdP Anda sama persis dengan:https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_IDmenggantiPOOL_IDdanPROVIDER_IDdengan pool dan penyedia Anda dari Workforce Identity Federation. Bahkan garis miring di akhir atau ketidakcocokanhttpvshttpsakan memicu hal ini.Klaim Tidak Ada di JWT:
Sisi IdP: Pastikan klien OIDC dikonfigurasi untuk merilis klaim yang diperlukan (yang dipetakan di WIF seperti
sub,groups,email,given_name,family_name) dalam token ID.Sisi WIF: Pastikan klaim yang masuk ini dipetakan dengan benar di bagian Pemetaan Atribut WIF (misalnya, google.groups=assertion.groups). Jika klaim ada dalam token, tetapi tidak dipetakan di WIF, platform SOAR mungkin gagal mengizinkan pengguna. Untuk memverifikasi bahwa pemetaan atribut Anda menghasilkan hasil yang diharapkan, lihat Memverifikasi konfigurasi penyedia Anda.
Pemetaan grup setelah migrasi
Pemetaan grup tetap penting di Google SecOps setelah migrasi selesai
Setelah migrasi, instance yang dimigrasikan akan mempertahankan pemetaan grup. Grup ini berfungsi sebagai dasar untuk menentukan akses pengguna ke SOAR. Anda harus memastikan bahwa setiap pengguna dipetakan di halaman ini agar dapat mengakses Google SecOps. Lihat Mengakses instance untuk mengetahui informasi selengkapnya.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.