Mengonfigurasi identitas pihak ketiga
Panduan ini ditujukan untuk administrator Google Security Operations yang ingin mengautentikasi tenaga kerja mereka (pengguna dan grup) di Google SecOps menggunakan penyedia identitas (IdP) pihak ketiga. Proses ini dapat dilakukan dengan memanfaatkan Google Cloud Workforce Identity Federation.
Workforce Identity Federation mendukung IdP apa pun yang menggunakan Security Assertion Markup Language (SAML 2.0) atau OpenID Connect (OIDC), seperti Okta, Microsoft Entra ID, dan Microsoft Active Directory Federation Services (AD FS).
Dokumen ini menjelaskan langkah-langkah tingkat tinggi untuk menyiapkan autentikasi melalui IdP berbasis SAML atau OIDC menggunakan Workforce Identity Federation:
- Rencanakan resource yang diperlukan. Tentukan detail workforce identity pool dan penyedia Anda, serta identifikasi atribut dan grup pengguna yang diperlukan untuk mengonfigurasi akses ke fitur di Google SecOps.
- Konfigurasi aplikasi IdP pihak ketiga. Buat aplikasi SAML atau OIDC IdP untuk diintegrasikan dengan Workforce Identity Federation dan Google SecOps.
- Mengonfigurasi Workforce Identity Federation. Konfigurasikan pool dan penyedia workforce identity Anda, serta berikan peran Google Cloud Identity and Access Management (IAM) ke grup dan pengguna IdP.
- Konfigurasikan single sign-on (SSO) menggunakan penyedia yang baru dibuat.
Setelah menyelesaikan langkah-langkah ini, Anda dapat login ke Google SecOps dengan penyedia identitas Anda dan mengelola akses pengguna melalui kontrol akses berbasis peran (RBAC) fitur menggunakan IAM.
Kasus penggunaan umum
Google SecOps memerlukan penggunaan Workforce Identity Federation sebagai broker SSO untuk berbagai kasus penggunaan.
Mematuhi standar keamanan yang ketat
- Tujuan: Memenuhi standar peraturan yang ketat untuk akses sistem dan cloud.
- Nilai: Membantu memenuhi persyaratan kepatuhan FedRAMP High (atau lebih tinggi) dengan menjadi perantara SSO yang aman.
Mengelola kontrol akses perusahaan
- Tujuan: Mengontrol akses fitur dan data secara terpusat di seluruh organisasi.
- Nilai: Mengaktifkan RBAC tingkat perusahaan di Google SecOps menggunakan IAM.
Terminologi utama
- Kumpulan tenaga kerja: Resource Google Cloud unik secara global yang ditentukan di tingkat organisasi yang memberi tenaga kerja Anda akses ke Google SecOps.
- Penyedia tenaga kerja: Sub-resource workforce identity pool yang menyimpan detail konfigurasi untuk satu IdP eksternal.
- Pemetaan atribut: Proses menerjemahkan atribut pernyataan yang disediakan oleh IdP Anda menjadi atribut Google Cloud menggunakan Common Expression Language (CEL).
- URL Assertion Consumer Service (ACS): URL tertentu (terkadang disebut sebagai URL single sign-on, bergantung pada penyedianya) yang digunakan untuk mengonfigurasi aplikasi SAML agar berkomunikasi dengan Google SecOps.
- ID Entitas: URL ID unik global yang mengidentifikasi aplikasi atau layanan tertentu, seperti Google SecOps, dan mengonfigurasi aplikasi SAML dalam IdP Anda.
Ringkasan proses
Google SecOps mendukung SSO SAML atau OIDC yang Dimulai Penyedia Layanan (dimulai SP). Dengan kemampuan ini, Anda dapat langsung membuka Google SecOps. Google SecOps mengeluarkan permintaan melalui Workforce Identity Federation IAM ke IdP pihak ketiga.
Setelah IdP mengautentikasi identitas pengguna, pengguna akan dikembalikan ke Google SecOps dengan pernyataan autentikasi SAML atau token ID OIDC. Google Cloud Workforce Identity Federation bertindak sebagai perantara dalam alur autentikasi.
Komunikasi antara Google SecOps, Workforce Identity Federation IAM, dan IdP
Pada tingkat tinggi, komunikasinya adalah sebagai berikut:
- Pengguna membuka Google SecOps.
- Google SecOps mencari informasi IdP di Google Cloud workforce identity pool.
- Permintaan dikirim ke IdP.
- Pernyataan SAML atau token ID OIDC dikirim ke Google Cloud workforce identity pool.
- Jika autentikasi berhasil, Google SecOps hanya akan menerima atribut SAML atau klaim OIDC yang ditentukan saat Anda mengonfigurasi penyedia tenaga kerja di workforce identity pool.
Sebagai administrator Google SecOps, Anda membuat grup di penyedia identitas, mengonfigurasi aplikasi SAML atau OIDC untuk meneruskan informasi keanggotaan grup dalam pernyataan atau token ID, dan mengaitkan pengguna dan grup dengan peran bawaan di IAM atau peran khusus yang Anda buat di Google SecOps.
Sebelum memulai
- Pahami Cloud Shell,
perintah
gcloud, dan konsol Google Cloud . - Konfigurasikan project Google Cloud untuk Google SecOps guna menyiapkan project yang terikat ke Google SecOps.
- Tinjau Google Cloud Workforce Identity Federation.
- Pastikan Anda memiliki izin untuk melakukan langkah-langkah dalam dokumen ini. Untuk mengetahui informasi tentang izin yang diperlukan untuk setiap fase proses orientasi, lihat Peran yang diperlukan.
- Pastikan daftar yang diizinkan firewall atau proxy Anda menyertakan domain Google SecOps, Workforce Identity Federation, dan IdP pihak ketiga yang diperlukan di port TCP
443. Untuk mengetahui informasi selengkapnya, lihat Akses jaringan dan daftar domain yang diizinkan.
Merencanakan implementasi
Bagian ini menjelaskan keputusan yang harus Anda buat dan informasi yang Anda tentukan sebelum melakukan langkah-langkah dalam dokumen ini.
Menentukan workforce identity pool dan penyedia workforce
Untuk menyiapkan autentikasi melalui IdP, Anda perlu mengonfigurasi Workforce Identity Federation sebagai perantara dalam alur autentikasi. Sebelum mengonfigurasi Workforce Identity Federation, tentukan resource Google Cloud berikut:
- Kumpulan tenaga kerja: Kumpulan identitas tenaga kerja memberi tenaga kerja Anda (seperti karyawan) akses ke Google SecOps.
- Penyedia tenaga kerja: Sub-resource workforce identity pool yang menyimpan detail tentang satu IdP.
Hubungan antara workforce identity pool, penyedia tenaga kerja, dan instance Google SecOps, yang diidentifikasi oleh satu subdomain pelanggan, adalah sebagai berikut:
- Workforce identity pool ditentukan di level organisasi.
- Setiap instance Google SecOps memiliki workforce identity pool yang dikonfigurasi dan dikaitkan dengannya.
- Workforce identity pool dapat memiliki beberapa penyedia tenaga kerja.
Setiap penyedia tenaga kerja mengintegrasikan IdP pihak ketiga dengan workforce identity pool.
Workforce identity pool harus dikhususkan untuk Google SecOps. Anda tidak dapat membagikan pool yang dibuat untuk Google SecOps untuk tujuan lain.
Anda harus memiliki workforce identity pool di organisasi Google Cloud yang sama yang berisi project yang terikat ke Google SecOps.
Berikut adalah panduan untuk menentukan nilai ID kunci workforce pool dan penyedia workforce:
- ID workforce pool (
WORKFORCE_POOL_ID): tentukan nilai yang menunjukkan cakupan atau tujuan workforce identity pool. Nilai harus memenuhi persyaratan berikut:- Harus unik secara global.
- Hanya boleh menggunakan karakter huruf kecil [a-z], angka [0-9], dan tanda hubung [-].
- Harus diawali dengan karakter huruf kecil [a-z].
- Harus diakhiri dengan karakter huruf kecil [a-z] atau digit [0-9].
- Dapat berisi antara 4 hingga 61 karakter.
- Nama tampilan workforce pool (
WORKFORCE_POOL_DISPLAY_NAME): tentukan nama yang mudah digunakan untuk workforce identity pool. - Workforce pool description (
WORKFORCE_POOL_DESCRIPTION): tentukan deskripsi mendetail tentang workforce identity pool. - ID penyedia tenaga kerja (
WORKFORCE_PROVIDER_ID): tentukan nilai yang menunjukkan IdP yang diwakilinya. Nilai harus memenuhi persyaratan berikut:- Hanya boleh menggunakan karakter huruf kecil [a-z], angka [0-9], dan tanda hubung [-].
- Dapat berisi antara 4 hingga 32 karakter.
- Nama tampilan penyedia tenaga kerja (
WORKFORCE_PROVIDER_DISPLAY_NAME): tentukan nama yang mudah digunakan untuk penyedia tenaga kerja. Panjangnya harus kurang dari 32 karakter. - Deskripsi penyedia workforce (
WORKFORCE_PROVIDER_DESCRIPTION): tentukan deskripsi mendetail tentang penyedia workforce.
Menentukan atribut dan grup pengguna di IdP
Sebelum membuat aplikasi SAML atau OIDC di IdP, identifikasi atribut pengguna atau klaim dan grup OIDC yang diperlukan untuk mengonfigurasi akses ke fitur di Google SecOps. Atribut pengguna standar mencakup hal berikut:
- Subjek
- Nama depan
- Nama belakang
- Nama tampilan
Anda memerlukan informasi tentang grup pengguna dan atribut atau klaim OIDC selama fase proses berikut:
Saat mengonfigurasi aplikasi SAML atau OIDC, Anda membuat grup yang ditentukan selama perencanaan. Anda mengonfigurasi aplikasi IdP untuk meneruskan keanggotaan grup dalam pernyataan SAML atau token ID OIDC.
Saat membuat penyedia workforce, Anda memetakan atribut pernyataan SAML atau klaim dan grup OIDC ke atributGoogle Cloud . Informasi ini dikirim dalam pernyataan atau token ID sebagai bagian dari identitas pengguna.
Mengonfigurasi aplikasi IdP
Bagian ini hanya menjelaskan konfigurasi spesifik yang diperlukan dalam aplikasi IdP SAML atau OIDC untuk diintegrasikan dengan Google Cloud Workforce Identity Federation dan Google SecOps. Lihat dokumentasi IdP Anda untuk mengetahui langkah-langkah mendetail.
Mengonfigurasi aplikasi SAML di IdP Anda
Buat grup di IdP Anda, jika belum dibuat.
Sebagai praktik terbaik, gunakan grup, bukan akun pengguna perorangan, untuk mengelola akses ke instance Google SecOps Anda. Google merekomendasikan pembuatan grup di IdP Anda yang sesuai langsung dengan peran Google SecOps default.
Lihat contoh berikut:
Peran Google SecOps Grup IdP (Disarankan) Chronicle API Admin chronicle_secops_admins Chronicle API Editor chronicle_secops_editor Chronicle API Viewer chronicle_secops_viewer Buat aplikasi SAML baru di IdP Anda.
Konfigurasikan aplikasi dengan setelan berikut:
Tentukan URL Assertion Consumer Service (ACS), yang juga disebut sebagai URL single sign-on, bergantung pada penyedia layanan.
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDGanti kode berikut:
WORKFORCE_POOL_ID: ID yang Anda tentukan untuk workforce identity pool.WORKFORCE_PROVIDER_ID: ID yang Anda tentukan untuk penyedia workforce.
Untuk mengetahui deskripsi nilai, lihat Menentukan workforce identity pool dan penyedia workforce.
Tentukan ID Entitas berikut (juga disebut, ID Entitas SP).
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDKonfigurasikan ID nama di IdP Anda untuk memastikan bahwa kolom
NameIDditampilkan dalam respons SAML.Anda dapat menetapkan nilai ini ke nilai yang mendukung kebijakan organisasi Anda, seperti alamat email atau nama pengguna. Lihat dokumentasi IdP Anda untuk mengetahui informasi tentang cara mengonfigurasi nilai ini. Untuk mengetahui informasi selengkapnya tentang persyaratan ini, lihat Memecahkan masalah workforce identity federation.
Tambahkan pernyataan atribut yang memungkinkan Anda meneruskan informasi pengguna dari IdP ke integrasi aplikasi Anda. Anda menentukan atribut saat merencanakan penerapan IdP.
Misalnya, gunakan tabel berikut untuk memetakan atribut di IdP yang umum digunakan, seperti Okta, Microsoft AD FS, atau Entra ID:
Nama atribut Nilai Okta AD FS/Entra ID (Atribut sumber) subjectuser.emailuser.mailatauuser.userprincipalnameemailaddressuser.emailuser.mailfirst_nameuser.firstNameuser.givennamelast_nameuser.lastNameuser.surnamedisplay_nameuser.displayNameuser.displaynamegroupsDikonfigurasi menggunakan filter grup di IdP, seperti Cocok dengan ekspresi reguler dengan .*Diambil dari pemetaan grup di IdP Jika Anda mengonfigurasi aplikasi IdP Okta, pastikan Anda memilih Unspecified sebagai format saat menambahkan atribut. Kosongkan namespace saat menggunakan Microsoft AD FS atau Entra ID sebagai IdP Anda.
Tetapkan grup dan pengguna yang sesuai ke aplikasi dalam IdP Anda.
Grup dan pengguna ini akan diberi otorisasi untuk mengakses Google SecOps.
Download file XML metadata aplikasi.
Di bagian berikutnya, Anda akan menggunakan file metadata ini saat mengonfigurasi penyedia identitas workforce. Jika menggunakan Google Cloud CLI, Anda harus mengupload file ini dari sistem lokal ke direktori utama Google Cloud menggunakan Cloud Shell.
Mengonfigurasi aplikasi OIDC di IdP Anda
Untuk mengonfigurasi aplikasi OIDC di IdP Anda agar terintegrasi dengan Workforce Identity Federation dan Google SecOps, selesaikan langkah-langkah berikut:
Jika Anda belum membuat grup, buat grup di IdP Anda. Sebagai praktik terbaik, gunakan grup, bukan akun pengguna perorangan, untuk mengelola akses ke instance Google SecOps Anda.
Buat aplikasi OIDC baru di IdP Anda dan ikuti langkah-langkah persiapan IdP di Membuat penyedia workforce pool OIDC.
Konfigurasikan aplikasi dengan kedua URI pengalihan berikut, yang disebut oleh beberapa IdP sebagai URL callback atau URI pengalihan login:
Untuk login ke Google SecOps:
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_IDUntuk validasi pemetaan atribut dan token Workforce Identity Federation:
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID
Ganti kode berikut:
WORKFORCE_POOL_ID: ID yang Anda tentukan untuk workforce identity pool.WORKFORCE_PROVIDER_ID: ID yang Anda tentukan untuk penyedia workforce.
Untuk mengetahui deskripsi nilai, lihat Menentukan workforce identity pool dan penyedia workforce.
Pilih jenis pemberian di aplikasi IdP Anda: alur kode otorisasi yang direkomendasikan atau alur implisit. Jika Anda menggunakan alur implisit, pastikan aplikasi dikonfigurasi untuk menampilkan token ID.
Konfigurasi aplikasi IdP Anda untuk menampilkan klaim
subserta klaim pengguna dan grup yang Anda identifikasi saat merencanakan penerapan IdP.Misalnya, gunakan tabel berikut untuk memetakan klaim di IdP yang umum digunakan, seperti Okta, Microsoft AD FS, atau Entra ID:
Nama klaim Nilai Okta AD FS/Entra ID (Atribut sumber) subuser.emailuser.mailatauuser.userprincipalnameemailuser.emailuser.mailgiven_nameuser.firstNameuser.givennamefamily_nameuser.lastNameuser.surnamenameuser.displayNameuser.displaynamegroupsDikonfigurasi menggunakan filter grup di IdP, seperti Cocok dengan ekspresi reguler dengan .*Diambil dari pemetaan grup di IdP Jika Anda mengonfigurasi aplikasi IdP Okta atau Entra ID, pastikan cakupan standar (seperti
openid,profile, danemail) diberikan untuk meneruskan klaim ini. Jika menggunakan Microsoft AD FS atau Entra ID, konfigurasikan pemetaan klaim dengan sesuai.Jika aplikasi OIDC Okta Anda menggunakan server otorisasi organisasi, Anda juga harus meneruskan
groupssebagai cakupan tambahan saat membuat penyedia Workforce Identity Federation agar Okta menampilkan klaimgroups. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi Workforce Identity Federation dengan Okta.Tetapkan grup dan pengguna yang sesuai ke aplikasi OIDC di IdP Anda.
Catat kredensial berikut dari aplikasi IdP Anda untuk digunakan saat Anda membuat penyedia workforce identity pool OIDC:
- Alur kode otorisasi: client ID, URI penerbit, dan rahasia klien.
- Alur implisit: client ID dan URI penerbit.
Mengonfigurasi Workforce Identity Federation
Bagian ini hanya menjelaskan langkah-langkah spesifik yang diperlukan untuk mengonfigurasi Workforce Identity Federation dengan aplikasi SAML atau OIDC IdP yang Anda buat di bagian sebelumnya. Untuk mengetahui informasi selengkapnya tentang cara mengelola workforce identity pool, lihat Mengelola penyedia workforce identity pool.
Menetapkan project penagihan dan kuota
Buka konsol Google Cloud sebagai pengguna dengan izin yang diperlukan di project yang terikat dengan Google SecOps. Anda telah mengidentifikasi atau membuat pengguna ini sebelumnya. Lihat bagian Sebelum memulai.
Luncurkan sesi Cloud Shell.
Tetapkan project Google Cloud yang ditagih dan dikenai kuota untuk operasi yang dilakukan menggunakan gcloud CLI. Gunakan perintah
gcloudberikut sebagai contoh:gcloud config set billing/quota_project PROJECT_IDGanti
PROJECT_IDdengan project ID dari project yang terikat dengan Google SecOps yang Anda buat di bagian Mengonfigurasi project Google Cloud untuk Google SecOps. Untuk deskripsi kolom yang mengidentifikasi project, lihat Membuat dan mengelola project.Untuk mengetahui informasi tentang kuota, lihat dokumen berikut:
Jika Anda mengalami error, lihat Memecahkan masalah error kuota.
Membuat dan mengonfigurasi workforce identity pool
Anda dapat mengonfigurasi workforce identity pool untuk diintegrasikan dengan penyedia identitas (IdP) eksternal atau dengan Google Workspace atau Cloud Identity.
Konsol
Untuk membuat workforce identity pool, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Workforce Identity Pools:
Pilih organisasi untuk workforce identity pool Anda. Kumpulan identitas tenaga kerja tersedia di semua project dan folder dalam organisasi.
Klik Buat pool dan lakukan tindakan berikut:
Di kolom Name, masukkan nama tampilan pool. ID pool otomatis diambil dari nama saat Anda mengetik, dan ditampilkan di bawah kolom Name. Anda dapat memperbarui ID pool dengan mengklik Edit di samping ID pool.
Opsional: Di Deskripsi, masukkan deskripsi pool.
Klik Berikutnya.
Durasi sesi workforce identity pool ditetapkan secara default ke satu jam. Durasi ini menentukan validitas token akses Google Cloud , Google Cloud konsol Workforce Identity Federation, dan sesi login gcloud CLI. Anda dapat memperbarui pool untuk menetapkan durasi sesi kustom antara 15 menit dan 12 jam.
gcloud
Membuat workforce identity pool.
Gunakan perintah
gcloudberikut sebagai contoh:gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization=ORGANIZATION_ID \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATIONGanti kode berikut:
WORKFORCE_POOL_ID: nilai yang Anda tentukan untuk ID workforce identity pool.ORGANIZATION_ID: ID organisasi numerik.WORKFORCE_POOL_DESCRIPTION: deskripsi opsional tentang workforce identity pool.WORKFORCE_POOL_DISPLAY_NAME: nama yang mudah digunakan dan opsional untuk workforce identity pool.SESSION_DURATION: nilai opsional untuk durasi sesi, yang dinyatakan sebagai angka yang ditambahkan dengans—misalnya,3600s. Durasi ini menentukan validitas token akses Google Cloud, Google Cloud konsol Workforce Identity Federation, dan sesi login gcloud CLI. Anda dapat memperbarui pool untuk menetapkan durasi sesi kustom antara 15 menit dan 12 jam.
Untuk menggunakan Google Workspace atau Cloud Identity untuk login ke Google SecOps, tambahkan flag
--allowed-services domain=backstory.chronicle.securitydan--disable-programmatic-signinke perintah.gcloud iam workforce-pools create WORKFORCE_POOL_ID\ --location="global" \ --organization="ORGANIZATION_ID" \ --description="WORKFORCE_POOL_DESCRIPTION" \ --display-name="WORKFORCE_POOL_DISPLAY_NAME" \ --session-duration=SESSION_DURATION \ --allowed-services domain=backstory.chronicle.security \ --disable-programmatic-signinPerintah ini membuat workforce identity pool yang tidak mendukung login ke Google Cloud. Untuk mengaktifkan fungsi login, Anda harus menggunakan flag yang sesuai untuk setiap skenario.
Jika diminta untuk mengaktifkan Chronicle API, masukkan
Yes.
Membuat penyedia workforce identity pool
Penyedia kumpulan identitas tenaga kerja menjelaskan hubungan antara organisasi Google Cloud dan IdP Anda. Pilih bagian yang sesuai dengan protokol autentikasi Anda:
Membuat penyedia workforce identity pool SAML
Konsol
Untuk mengonfigurasi penyedia workforce identity pool, lakukan hal berikut:
Di konsol Google Cloud , buka halaman Workforce Identity Pools:
Di tabel Workforce Identity Pool, pilih pool yang ingin Anda buatkan penyedia.
Di bagian Providers, klik Add Provider.
Di Pilih vendor Penyedia, pilih IdP Anda.
Jika penyedia identitas Anda tidak tercantum, pilih Generic Identity Provider.
Pada bagian Pilih protokol autentikasi, pilih SAML.
Di bagian Create a provider, lakukan hal berikut:
Di bagian Nama, masukkan nama penyedia.
Opsional: Di bagian Deskripsi, masukkan deskripsi penyedia.
Di file metadata IDP (XML), pilih file XML metadata yang Anda buat sebelumnya dalam panduan ini.
Pastikan Aktifkan penyedia sudah aktif.
Klik Lanjutkan.
Di bagian Bagikan informasi penyedia Anda, salin URL:
- Konfigurasikan URL pertama (
https://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) sebagai ID Entitas di IdP Anda. - URL kedua (
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) digunakan untuk token Workforce Identity Federation dan validasi pemetaan (menggunakan fitur Debug IdP Token). Pastikan IdP Anda menyertakan URL ini dan URL login ACS Google SecOps (https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) yang Anda konfigurasi di Mengonfigurasi aplikasi SAML di IdP Anda.
- Konfigurasikan URL pertama (
Klik Lanjutkan.
Di bagian Configure provider, lakukan hal berikut:
Di Pemetaan atribut, masukkan pemetaan di kotak masing-masing. Contoh:
Google X (dengan X adalah angka) SAML X (dengan X adalah angka) google.subjectassertion.subjectgoogle.groupsassertion.attributes.groupsgoogle.display_nameassertion.attributes.display_name[0]attribute.first_nameassertion.attributes.first_name[0]attribute.last_nameassertion.attributes.last_name[0]attribute.user_emailassertion.attributes.emailaddress[0]Jika Anda melakukan konfigurasi ini untuk Google Security Operations, yang mencakup Google Security Operations SIEM dan Google SecOps SOAR, petakan atribut berikut yang diperlukan oleh Google SecOps SOAR:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Opsional: Jika Anda memilih Microsoft Entra ID sebagai IdP, Anda dapat meningkatkan jumlah grup dengan melakukan tindakan berikut:
- Pilih Gunakan Atribut Tambahan.
- Di kolom Extra Attributes Issuer URI, masukkan URL penerbit.
- Di kolom Extra Attributes Client ID, masukkan client ID.
- Di kolom Extra Attributes Client Secret, masukkan rahasia klien.
- Dalam daftar Extra Attributes Type, pilih jenis atribut untuk atribut tambahan.
- Di kolom Extra Attributes Filter, masukkan ekspresi filter yang digunakan saat mengkueri Microsoft Graph API untuk grup.
Opsional: Untuk menambahkan kondisi atribut, klik Tambahkan kondisi, lalu masukkan ekspresi CEL yang mewakili kondisi atribut. Misalnya, untuk membatasi atribut
ipaddrke rentang IP tertentu, Anda dapat menetapkan kondisiassertion.attributes.ipaddr.startsWith('98.11.12.'). Contoh kondisi ini memastikan bahwa hanya pengguna dengan alamat IP yang diawali dengan98.11.12.yang dapat login menggunakan penyedia workforce ini.Untuk mengaktifkan logging audit mendetail, di Detailed logging, klik tombol Enable attribute value audit logging.
Untuk membuat penyedia, klik Kirim.
gcloud
Untuk mengonfigurasi penyedia workforce identity pool:
Upload file metadata aplikasi SAML ke direktori utama Cloud Shell dengan mengklik More >. File hanya dapat diupload ke direktori utama Anda. Untuk opsi lainnya dalam mentransfer file antara Cloud Shell dan workstation lokal Anda, lihat Mengupload dan mendownload file dan folder dari Cloud Shell.
Catat jalur direktori tempat Anda mengupload file XML metadata aplikasi SAML di Cloud Shell. Anda akan memerlukan jalur ini di langkah berikutnya.
Buat penyedia workforce identity pool dan tentukan detail IdP.
Gunakan perintah
gcloudberikut sebagai contoh:gcloud iam workforce-pools providers create-saml WORKFORCE_PROVIDER_ID \ --workforce-pool="WORKFORCE_POOL_ID" \ --location="global" \ --display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \ --description="WORKFORCE_PROVIDER_DESCRIPTION" \ --idp-metadata-path=PATH_TO_METADATA_XML \ --attribute-mapping="ATTRIBUTE_MAPPINGS"Lihat Merencanakan implementasi untuk mengetahui deskripsi nilai.
Ganti kode berikut:
WORKFORCE_PROVIDER_ID: nilai yang Anda tentukan untuk ID penyedia workforce.WORKFORCE_POOL_ID: nilai yang Anda tentukan untuk ID workforce identity pool.WORKFORCE_PROVIDER_DISPLAY_NAME: nama yang mudah digunakan dan opsional untuk penyedia workforce. Panjangnya harus kurang dari 32 karakter.WORKFORCE_PROVIDER_DESCRIPTION: deskripsi opsional untuk penyedia workforce.PATH_TO_METADATA_XML: lokasi direktori Cloud Shell dari file XML metadata aplikasi yang Anda upload menggunakan Cloud Shell, misalnya:/path/to/sso_metadata.xml.ATTRIBUTE_MAPPINGS: definisi cara memetakan atribut pernyataan ke atributGoogle Cloud . Common Expression Language digunakan untuk menafsirkan pemetaan ini. Contoh:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.groupsContoh sebelumnya memetakan atribut berikut:
assertion.subjectkegoogle.subject. Ini adalah persyaratan minimum.assertion.attributes.name[0]kegoogle.display_name.assertion.attributes.groupske atributgoogle.groups.
Jika Anda melakukan konfigurasi ini untuk Google Security Operations, yang mencakup Google Security Operations SIEM dan Google SecOps SOAR, petakan atribut berikut yang diperlukan oleh Google SecOps SOAR:
attribute.first_nameattribute.last_nameattribute.user_emailgoogle.groupsgoogle.display_name
Jadi, pemetaan lengkapnya adalah sebagai berikut:
google.subject=assertion.subject,google.groups=assertion.attributes.groups,attribute.first_name=assertion.attributes.first_name[0],attribute.last_name=assertion.attributes.last_name[0],attribute.user_email=assertion.attributes.emailaddress[0],google.display_name=assertion.attributes.display_name[0]Untuk mengetahui informasi selengkapnya, lihat Menyediakan dan memetakan pengguna untuk Google SecOps SOAR.
Saat mengonfigurasi aplikasi SAML untuk meneruskan informasi keanggotaan grup, nama atribut grup umum mencakup
groups,idpGroup, danmemberOf. Dalam pemetaan atribut Workforce Identity Federation, pastikan nama atribut diassertion.attributes.ATTRIBUTE_NAMEsama persis dengan nama peka huruf besar/kecil yang dikonfigurasi di IdP Anda.Contoh berikut memetakan beberapa grup ke atribut
google.groups:google.groups="(has(assertion.attributes.idpGroup) ? assertion.attributes.idpGroup : []) + (has(assertion.attributes.groups) ? assertion.attributes.groups : []) + (has(assertion.attributes.memberOf) ? assertion.attributes.memberOf : [])"Contoh berikut memetakan grup
http://schemas.xmlsoap.org/ws/2005/05/identity/claims/groupyang berisi karakter khusus kegoogle.groups:google.groups="assertion.attributes['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"Untuk mengetahui informasi selengkapnya tentang pemetaan atribut, lihat Pemetaan Atribut.
Membuat penyedia workforce identity pool OIDC
Untuk membuat penyedia workforce identity pool OIDC menggunakan Google Cloud konsol atau gcloud CLI, selesaikan langkah-langkah berikut:
Ikuti petunjuk di bagian Membuat penyedia workforce pool OIDC untuk membuat penyedia di workforce identity pool Anda.
Saat Anda mengonfigurasi penyedia OIDC, terapkan setelan Google SecOps berikut:
URI pengalihan: Pastikan aplikasi IdP OIDC Anda menyertakan kedua URI pengalihan berikut, seperti yang dijelaskan dalam Mengonfigurasi aplikasi OIDC di IdP Anda:
- URI pengalihan login Google SecOps
(
https://auth.backstory.chronicle.security/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID) - URI pengalihan validasi Workforce Identity Federation
(
https://auth.cloud.google/signin-callback/locations/global/workforcePools/WORKFORCE_POOL_ID/providers/WORKFORCE_PROVIDER_ID)
- URI pengalihan login Google SecOps
(
Pemetaan atribut: Petakan klaim OIDC Anda ke atributGoogle Cloud menggunakan Common Expression Language (CEL). Setidaknya, petakan
google.subjectkeassertion.subdangoogle.groupskeassertion.groupsagar RBAC Google SecOps berfungsi seperti yang diharapkan:google.subject=assertion.sub,google.groups=assertion.groupsJika Anda mengonfigurasi Google Security Operations, yang mencakup Google Security Operations SIEM dan Google SecOps SOAR, petakan juga atribut yang diperlukan oleh Google SecOps SOAR. Contoh:
google.subject=assertion.sub,google.groups=assertion.groups,attribute.first_name=assertion.given_name,attribute.last_name=assertion.family_name,attribute.user_email=assertion.email,google.display_name=assertion.nameContoh pemetaan grup lanjutan
Saat mengonfigurasi aplikasi OIDC untuk meneruskan informasi keanggotaan grup, nama klaim grup umum mencakup
groups,idpGroup, danmemberOf. Dalam pemetaan atribut Workforce Identity Federation, pastikan nama klaim diassertion.CLAIM_NAMEsama persis dengan nama peka huruf besar/kecil yang dikonfigurasi di IdP Anda.Contoh berikut memetakan beberapa grup ke atribut
google.groups:google.groups="(has(assertion.idpGroup) ? assertion.idpGroup : []) + (has(assertion.groups) ? assertion.groups : []) + (has(assertion.memberOf) ? assertion.memberOf : [])"Contoh berikut memetakan klaim grup yang berisi karakter khusus (seperti skema URI) ke
google.groups:google.groups="assertion['http://schemas.xmlsoap.org/ws/2005/05/identity/claims/group']"
Opsional: Buat kondisi atribut. Jika IdP multi-tenant Anda memiliki satu URI penerbit, Anda harus menggunakan kondisi atribut untuk memastikan bahwa akses dibatasi untuk tenant yang benar. Misalnya, Anda dapat membatasi login untuk pengguna dengan peran atau domain email tertentu. Untuk mengetahui informasi selengkapnya, lihat Menggunakan kondisi atribut saat melakukan penggabungan dengan penyedia identitas multi-tenant.
Setelah Anda membuat penyedia workforce OIDC, sebaiknya validasi pemetaan token dan atribut Anda menggunakan Debug token IdP Anda, lalu lanjutkan dengan Memberikan peran untuk mengaktifkan login ke Google SecOps untuk menyelesaikan bagian yang tersisa dalam dokumen ini.
Memberikan peran untuk mengaktifkan login ke Google SecOps
Langkah-langkah berikut menjelaskan cara memberikan peran tertentu menggunakan IAM sehingga grup dan pengguna di workforce identity pool Anda dapat login ke Google SecOps. Lakukan konfigurasi menggunakan project Google Cloud yang terikat dengan Google SecOps yang Anda buat sebelumnya.
Konsol
Di konsol Google Cloud , buka halaman IAM.
Pilih project Google Cloud yang terikat dengan Google SecOps.
Di tab View by principals, klik Grant Access.
Di bagian Add principals, masukkan ID akun utama di kolom New principals.
Contoh:
Untuk menambahkan semua identitas yang dikelola menggunakan workforce identity pool dan penyedia tenaga kerja yang Anda buat sebelumnya, masukkan perintah berikut:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_IDUntuk menambahkan grup tertentu sebagai akun utama, masukkan perintah berikut:
principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID
Ganti kode berikut:
WORKFORCE_POOL_ID: nilai yang Anda tentukan untuk ID workforce identity pool.GROUP_ID: grup dalam klaimgoogle.groupsyang dipetakan. Anda harus membuat grup ini di IdP Anda.
Di bagian Assign roles, pilih atau telusuri peran Chronicle API yang berlaku, seperti Chronicle API Viewer (
roles/chronicle.viewer).Klik Simpan.
Ulangi langkah 3 hingga 5 untuk setiap akun utama yang ingin Anda beri peran.
gcloud
Berikan peran Chronicle API Viewer (
roles/chronicle.viewer) kepada pengguna atau grup yang seharusnya memiliki akses ke aplikasi Google SecOps.- Contoh berikut memberikan peran Chronicle API Viewer ke identitas yang dikelola menggunakan workforce identity pool dan penyedia workforce yang Anda buat sebelumnya.
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/*"Ganti kode berikut:
PROJECT_ID: dengan project ID dari project yang terikat dengan Google SecOps yang Anda konfigurasi di Mengonfigurasi project Google Cloud untuk Google SecOps. Untuk deskripsi kolom yang mengidentifikasi project, lihat Membuat dan mengelola project.WORKFORCE_POOL_ID: nilai yang Anda tentukan untuk ID workforce identity pool.Untuk memberikan peran Chronicle API Viewer ke grup tertentu, jalankan perintah berikut:
gcloud projects add-iam-policy-binding PROJECT_ID \ --role roles/chronicle.viewer \ --member "principalSet://iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID/group/GROUP_ID"Ganti
GROUP_ID: grup dalam klaimgoogle.groupsyang dipetakan. Anda harus membuat grup ini di IdP Anda.Konfigurasikan kebijakan IAM tambahan untuk memenuhi persyaratan organisasi Anda.
Wajib: Untuk menyelesaikan autentikasi dan mengaktifkan akses pengguna ke platform Google SecOps, Anda perlu mengonfigurasi akses pengguna dari sisi SOAR Google SecOps. Untuk mengetahui informasi selengkapnya, lihat Memetakan pengguna di platform Google SecOps.
Ulangi langkah sebelumnya untuk memberikan peran lain.
Mengonfigurasi SSO ke instance Google SecOps Anda
Tugas terakhir dalam mengintegrasikan IdP pihak ketiga dengan Google SecOps adalah mengonfigurasi SSO. Setelah menyelesaikan langkah ini, pengguna akan dapat login ke Google SecOps menggunakan kredensial IdP mereka.
Berikut adalah langkah-langkah untuk mengonfigurasi SSO:
- Di konsol Google Cloud , buka halaman Security > Google SecOps.
- Klik tab Single Sign-On, lalu pilih Workforce Identity Federation.
- Dari daftar penyedia yang tersedia, pilih penyedia Workforce Identity Federation yang Anda buat di Membuat penyedia workforce identity pool.
- Opsional: Untuk menguji konfigurasi SSO Anda, klik Test SSO Setup. Jika konfigurasi berhasil, Anda akan dialihkan ke layar login IdP.
- Klik Simpan.
Mengelola konfigurasi Workforce Identity Federation
Bagian ini menjelaskan cara memperbarui setelan penyedia dan memverifikasi bahwa tingkat akses pengguna dikonfigurasi dengan benar.
Memverifikasi atau mengonfigurasi kontrol akses fitur Google SecOps
Jika Anda mengonfigurasi Workforce Identity Federation dengan atribut atau grup yang dipetakan
ke atribut google.groups, informasi ini akan diteruskan ke Google SecOps
sehingga Anda dapat mengonfigurasi RBAC ke fitur Google SecOps.
Jika instance Google SecOps memiliki konfigurasi RBAC yang ada, pastikan konfigurasi asli berfungsi seperti yang diharapkan.
Jika Anda belum mengonfigurasi kontrol akses, lihat Mengonfigurasi kontrol akses fitur menggunakan IAM untuk mengetahui informasi tentang cara mengontrol akses ke fitur.
Mengubah konfigurasi Workforce Identity Federation
Jika Anda perlu memperbarui workforce identity pool atau penyedia tenaga kerja, lihat Mengelola penyedia workforce identity pool untuk mengetahui informasi tentang cara memperbarui konfigurasi.
Bagian Pengelolaan kunci di Membuat penyedia workforce pool SAML menjelaskan cara mengupdate kunci penandatanganan IdP, lalu mengupdate konfigurasi penyedia workforce dengan file XML metadata aplikasi terbaru. Untuk penyedia OIDC, lihat Memperbarui penyedia dan Mengelola JWK OIDC.
Konsol
Untuk memperbarui workforce pool tertentu:
Buka halaman Workforce Identity Pools:
Pada tabel, pilih pool.
Perbarui parameter pool.
Klik Simpan Pool.
Untuk memperbarui penyedia:
Buka halaman Workforce Identity Pools:
Di tabel, pilih pool tempat Anda ingin memperbarui penyedia.
Di tabel Penyedia, klik Edit.
Perbarui detail penyedia.
Untuk menyimpan detail penyedia yang diperbarui, klik Simpan.
gcloud
Berikut adalah contoh perintah gcloud yang memperbarui konfigurasi penyedia tenaga kerja:
gcloud iam workforce-pools providers update-saml WORKFORCE_PROVIDER_ID \
--workforce-pool=WORKFORCE_POOL_ID \
--location="global" \
--display-name="WORKFORCE_PROVIDER_DISPLAY_NAME" \
--description="WORKFORCE_PROVIDER_DESCRIPTION" \
--idp-metadata-path=PATH_TO_METADATA_XML \
--attribute-mapping="ATTRIBUTE_MAPPINGS"
Ganti kode berikut:
WORKFORCE_PROVIDER_ID: nilai yang Anda tentukan untuk ID penyedia workforce.WORKFORCE_POOL_ID: nilai yang Anda tentukan untuk ID workforce identity pool.WORKFORCE_PROVIDER_DISPLAY_NAME: nama yang mudah digunakan untuk penyedia workforce. Nilai harus kurang dari 32 karakter.WORKFORCE_PROVIDER_DESCRIPTION: deskripsi penyedia workforce.PATH_TO_METADATA_XML: lokasi file XML metadata aplikasi yang diperbarui, misalnya:/path/to/sso_metadata_updated.xml.ATTRIBUTE_MAPPINGS: atribut pernyataan yang dipetakan ke atributGoogle Cloud . Contoh:
google.subject=assertion.subject,google.display_name=assertion.attributes.name[0],google.groups=assertion.attributes.memberOf
Memecahkan masalah konfigurasi
Jika Anda mengalami error selama proses ini, tinjau
Memecahkan masalah workforce identity federation
untuk menyelesaikan masalah umum. Jika organisasi Anda menggunakan firewall atau proxy web,
pastikan daftar yang diizinkan jaringan Anda menyertakan domain autentikasi dan
Workforce Identity Federation yang diperlukan, seperti
auth.backstory.chronicle.security, iam.googleapis.com,
accounts.google.com, dan domain
accounts.google.ccTLD regional. Untuk mengetahui informasi selengkapnya, lihat
Akses jaringan dan daftar domain yang diizinkan.
Bagian berikut memberikan informasi tentang masalah umum yang dihadapi saat melakukan langkah-langkah dalam dokumen ini.
Jika Anda masih mengalami masalah, hubungi perwakilan Google SecOps Anda dan berikan File Log Jaringan Chrome Anda.
Perintah tidak ditemukan
Saat membuat penyedia workforce identity pool dan menentukan detail IdP, Anda akan mendapatkan error berikut:
Error: bash: --attribute-mapping=google.subject=assertion.subject, google.display_name=assertion.attributes.name[0], google.groups=assertion.attributes.groups: command not found
Pastikan PATH_TO_METADATA_XML adalah lokasi tempat Anda mengupload file XML metadata aplikasi SAML ke direktori utama Cloud Shell.
Pemanggil tidak memiliki izin
Saat menjalankan perintah
gcloud projects add-iam-policy-bindinguntuk memberikan peran kepada pengguna atau grup, Anda akan mendapatkan error berikut:ERROR: (gcloud.organizations.add-iam-policy-binding) User [ ] does not have permission to access organizations instance [538073083963:getIamPolicy] (or it may not exist): The caller does not have permission
Periksa apakah Anda memiliki izin yang diperlukan. Untuk informasi selengkapnya, lihat Peran yang diperlukan.
Kegagalan verifikasi: ID sesi tidak ada dalam permintaan
Saat mencoba melakukan autentikasi, Anda akan mendapatkan error berikut di browser:
Verification failure: missing session ID in request
Periksa apakah URL dasar ACS dan ID Entitas sudah benar. Untuk mengetahui informasi selengkapnya, lihat Mengonfigurasi aplikasi IdP.
Men-debug token IdP Anda
Anda dapat menggunakan fitur Debug IdP Token di Workforce Identity Federation untuk memverifikasi bahwa penyedia identitas Anda meneruskan atribut dan klaim yang benar. Hal ini sangat direkomendasikan sebelum pengguna mencoba login ke Google SecOps, karena dapat membantu mencegah error login dan pemetaan atribut.
Untuk men-debug token Anda:
- Di konsol Google Cloud , buka Workforce Identity Federation.
- Pilih pool Anda, lalu pilih penyedia Anda.
- Klik Debug IdP Token.
Untuk panduan mendetail tentang cara menggunakan fitur ini untuk memvalidasi penyiapan Anda, lihat Panduan validasi pra-migrasi.
JWT debug yang lebih besar dari 4 KB
Jika Anda mengalami masalah saat login ke Google SecOps, pastikan Token Web JSON (JWT) Anda tidak melebihi batas 4 KB untuk Google SecOps. Jika pengguna menerima error yang menyatakan "Authentication JWT larger than 4KB. Kurangi data keanggotaan grup yang dikirim dari IdP untuk mengatasi error ini.", ikuti langkah-langkah pemecahan masalah berikut:
- Debug token Anda: Anda dapat men-debug token di halaman detail penyedia di dalam Workforce Identity Federation (dengan membuka Workforce Identity Federation > Workforce Pools > POOL_NAME > PROVIDER_NAME dan mengklik Debug IdP Token). Untuk menggunakan fitur ini, Anda harus menambahkan URL Google Cloud ke URL pengalihan penyedia identitas Anda terlebih dahulu. Hal ini berlaku untuk protokol SAML dan OIDC. Untuk mengetahui informasi selengkapnya, lihat Memecahkan Masalah Workforce Identity Federation.
Memfilter klaim grup: Jika penyedia identitas Anda mengirimkan banyak grup yang tidak terkait dengan Google SecOps, filter klaim grup di tingkat penyedia. Mengonfigurasi penyedia eksternal Anda untuk hanya mengirim kumpulan grup minimal yang diperlukan untuk Google SecOps akan mengurangi ukuran JWT dan menghindari error autentikasi.
- Contoh (Microsoft Entra ID): Anda dapat menggunakan Pemfilteran Grup Microsoft Entra untuk hanya mengirim kumpulan minimal grup yang relevan. Di Entra Enterprise Application Anda di bagian Single sign-on, edit klaim Groups untuk menerapkan filter (misalnya, menggunakan Prefix match) sehingga hanya grup yang diperlukan yang dikirim ke Google SecOps. Untuk mengetahui informasi selengkapnya, lihat Pemfilteran Grup Microsoft Entra.
Langkah berikutnya
Setelah menyelesaikan langkah-langkah dalam dokumen ini, lakukan hal berikut:
Lakukan langkah-langkah untuk Menautkan instance Google SecOps ke layanan Google Cloud .
Jika Anda belum menyiapkan logging audit, lanjutkan dengan mengaktifkan logging audit Google SecOps.
Jika Anda mengonfigurasi Google Security Operations, lakukan langkah-langkah tambahan di Menyediakan, mengautentikasi, dan memetakan pengguna di Google Security Operations.
Untuk mengonfigurasi akses ke fitur, lakukan langkah-langkah tambahan di Mengonfigurasi kontrol akses fitur menggunakan IAM dan Izin Google SecOps di IAM.
Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.