Panduan validasi pra-migrasi

Didukung di:

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:

  1. Login ke konsolGoogle Cloud dan pilih project Google Cloud yang benar dari daftar project di menu navigasi atas.
  2. Buka menu navigasi (≡) dan buka APIs & Services > Enabled APIs & services.
  3. Buka daftar API & Layanan yang Diaktifkan untuk menemukan Chronicle API.
  4. 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:

  1. Buka Halaman IAM di konsol Google Cloud .
  2. Tampilkan akun tersembunyi (langkah penting): Anda harus mencentang kotak di sisi kanan panel filter yang bertuliskan Include Google-provided role grants.
  3. 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
  4. Verifikasi izin: Pastikan akun layanan memiliki peran Chronicle Service Agent. Jika peran tidak ada, klik edit Edit dan tambahkan kembali.

Validasi penyiapan Google SecOps

  1. Di konsol Google Cloud , pilih project Google Cloud yang benar dari daftar.
  2. Buka Security > Google SecOps dan tab Single Sign-On akan muncul.
  3. 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.
  4. 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.

Arsitektur alur kerja autentikasi

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:

  1. Buka tab browser baru atau gunakan jendela Samaran.
  2. Buka Developer Tools menggunakan pintasan untuk sistem operasi Anda:

    • Windows: Tekan F12
    • Linux: Tekan Ctrl + Shift + I
    • macOS: Tekan Cmd + Option + I
  3. Buka tab Jaringan.

  4. Centang kotak Preserve log untuk memastikan tidak ada data yang hilang selama pengalihan.

    Pertahankan log

  5. 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.

  1. Temukan permintaan: Di panel filter tab Network, telusuri saml.

    Menemukan Permintaan

  2. Ekstrak data: Pilih permintaan dan klik tab Payload. Temukan parameter string kueri yang diberi label SAMLRequest.

    Mengekstrak Data

  3. Dekode: Salin nilai permintaan dan tempelkan ke alat Validasi SAML (samltool.io) untuk mendekodenya.

    Decode

  4. 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.

  1. Temukan respons: Di panel filter tab Network, telusuri signin-callback.

    Menemukan Respons

  2. Ekstrak data: Pilih permintaan dan klik tab Payload. Temukan data SAMLResponse.

    Menemukan data Respons SAML

  3. Dekode: Salin nilai respons dan tempelkan ke alat Validasi SAML.

  4. Verifikasi:

    • Tinjau klaim (atribut) yang ditampilkan seperti groups, first name, last name, dan email.
    • 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.

      Setelan workforce pool

Gambar berikut menunjukkan pemetaan atribut:

attribute-mapping

Pemetaan dalam gambar adalah sebagai berikut:

  • google.subject = assertion.subject
  • attribute.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.

  1. Temukan token di browser pengguna: Di kolom filter tab Network, telusuri endpoint auth/siem.

    Menemukan Token di browser pengguna

  2. Ekstrak data: Pilih permintaan dan lihat tab Payload. Temukan string jwt.

  3. Dekode: Salin string JWT dan tempelkan ke alat JWT Inspection (jwt.io).

    Salin string JWT dan tempelkan

  4. Verifikasi:

    • Bandingkan klaim yang didekode untuk given_name, family_name, email, dan idpgroups.
    • 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).

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:

  1. Salin pemetaan grup dari halaman Group Mappings di instance SOAR yang ada.
  2. Minta pengguna di grup IDP untuk mengakses URL Google SecOps baru.
  3. Jika pengguna tidak dapat mengakses SOAR, gunakan langkah-langkah pemecahan masalah berikut:

    a. Periksa respons: Buka permintaan auth/siem dari Fase 4, lalu pilih tab Preview.

    b. Periksa izin: Temukan objek permissions dalam 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.

Arsitektur Alur Kerja Autentikasi

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:

  1. Buka tab browser kosong baru atau di jendela samaran.
  2. Buka Developer Tools menggunakan pintasan untuk sistem operasi Anda:

    • Windows: Tekan F12
    • Linux: Tekan Ctrl + Shift + I
    • macOS: Tekan Cmd + Option + I
  3. Buka tab Jaringan.

  4. Centang kotak Preserve log untuk memastikan tidak ada data yang hilang selama pengalihan.

    Pertahankan log

  5. 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.

  1. 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, dan state.

    Menemukan Permintaan

  2. Verifikasi:

    • Pastikan client_id cocok dengan yang dikonfigurasi di penyedia OIDC Anda.
    • Pastikan redirect_uri sama persis dengan https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/POOL_ID/provider/PROVIDER_ID yang menggantikan POOL_ID dan PROVIDER_ID dengan pool dan penyedia Anda dari Workforce Identity Federation.
    • Pastikan response_type ditetapkan ke kode.
    • Perhatikan parameter cakupan, yang harus menyertakan openid dan cakupan lain yang diperlukan untuk merilis klaim yang diperlukan (misalnya, email, profil).

Fase 3: Memvalidasi callback dan pertukaran token

Langkah ini memverifikasi respons IdP kembali ke Google Cloud.

  1. Temukan Callback: Di tab Network, temukan permintaan ke URL callback login: (.../signin-callback/...).

    Menemukan Callback

  2. Periksa Data: Periksa parameter URL permintaan ini. URL ini harus berisi parameter kode yang disediakan oleh IdP OIDC Anda.

  3. 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.

    Lihat Token Lengkap Memvalidasi Atribut

Tahap 4: Memvalidasi autentikasi Google SecOps

Langkah ini memverifikasi apakah Google Cloud mengautentikasi pengguna untuk login ke Google SecOps SOAR.

  1. Temukan token di browser pengguna: Di kolom filter tab Network, telusuri endpoint auth/siem.

    Menemukan Token di browser pengguna

  2. Ekstrak data: Pilih permintaan dan lihat tab Payload. Temukan string jwt.

  3. Dekode: Salin string JWT dan tempelkan ke alat JWT Inspection (jwt.io).

    Salin string JWT dan tempelkan

  4. Verifikasi:

    • Bandingkan klaim yang didekode untuk sub, given_name, family_name, email, dan idpgroups.
    • 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_name di Google Cloud harus dipetakan ke given_name di 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_groups di JWT) diberi peran yang diperlukan menggunakan format principalSet yang benar (misalnya, principalSet://iam.googleapis.com/locations/global/workforcePools/POOL_ID/group/IDP_GROUP_NAME).

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:

  1. Salin pemetaan grup dari halaman Group Mappings di instance SOAR yang ada.
  2. Minta pengguna di grup IDP untuk mengakses URL Google SecOps baru.
  3. Jika pengguna tidak dapat mengakses SOAR, gunakan langkah-langkah pemecahan masalah berikut:

    a. Periksa respons: Buka permintaan auth/siem dari Fase 4, lalu pilih tab Preview.

    b. Periksa izin: Temukan objek permissions dalam 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_uri dari 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_ID mengganti POOL_ID dan PROVIDER_ID dengan pool dan penyedia Anda dari Workforce Identity Federation. Bahkan garis miring di akhir atau ketidakcocokan http vs https akan memicu hal ini.
  • Klaim Tidak Ada di JWT:

    1. 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.

    2. 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.