Workload Identity Federation memungkinkan Anda memberikan akses ke workload eksternal ke resourceGoogle Cloud , baik secara langsung maupun melalui peniruan identitas akun layanan. Kemudian, Anda dapat mendownload file konfigurasi kredensial untuk menyiapkan Kredensial Default Aplikasi (ADC) bagi library klien.
Untuk petunjuk end-to-end khusus kasus penggunaan, lihat panduan konfigurasi untuk Amazon Web Services (AWS) dan Azure, Active Directory, GitHub, GitLab, dan pipeline deployment lainnya, serta Kubernetes.
Mengizinkan workload eksternal Anda mengakses resource Google Cloud
Untuk memberi workload Anda akses ke resource Google Cloud , sebaiknya berikan akses resource langsung ke akun utama. Dalam hal ini, principal-nya adalah pengguna gabungan. Beberapa produk Google Cloud memiliki batasan Google Cloud API. Jika workload Anda memanggil endpoint API yang memiliki batasan, Anda dapat menggunakan peniruan akun layanan. Dalam hal ini, akun utama adalah akun layananGoogle Cloud , yang bertindak sebagai identitas. Anda memberikan akses ke akun layanan pada resource.Akses resource langsung
Anda dapat memberikan akses ke identitas gabungan langsung pada resource menggunakan konsol Google Cloud atau gcloud CLI.
Konsol
Untuk menggunakan konsol Google Cloud guna memberikan peran IAM
langsung pada resource, Anda harus membuka halaman resource, lalu
memberikan peran. Contoh berikut menunjukkan cara membuka halaman Cloud Storage dan memberikan peran Storage Object Viewer (roles/storage.objectViewer) ke identitas gabungan langsung di bucket Cloud Storage.
- Di konsol Google Cloud , buka halaman Buckets Cloud Storage.
Dalam daftar bucket, klik nama bucket yang ingin Anda beri peran.
Pilih tab Permissions di dekat bagian atas halaman.
Klik tombol add_box Berikan akses.
Dialog Add principals akan muncul.
Di kolom Akun utama baru, masukkan satu atau beberapa identitas yang memerlukan akses ke bucket Anda.
Menurut subjek
principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECTGanti kode berikut:
PROJECT_NUMBER: nomor projectPOOL_ID: ID workload poolSUBJECT: subjek individual yang dipetakan dari IdP Anda—misalnya,administrator@example.com
Menurut grup
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUPGanti kode berikut:
PROJECT_NUMBER: nomor projectWORKLOAD_POOL_ID: ID workload poolGROUP: grup yang dipetakan dari IdP Anda—misalnya:administrator-group@example.com
Menurut atribut
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUEGanti kode berikut:
PROJECT_NUMBER: nomor projectWORKLOAD_POOL_ID: ID workload poolATTRIBUTE_NAME: salah satu atribut yang dipetakan dari IdP AndaATTRIBUTE_VALUE: nilai atribut
Pilih satu (atau beberapa) peran dari menu drop-down Select a role. Peran yang Anda pilih akan muncul di panel dengan deskripsi singkat tentang izin yang diberikan.
Klik Save.
gcloud
Untuk menggunakan gcloud CLI guna memberikan peran IAM pada resource dalam project, lakukan hal berikut:
Dapatkan nomor project dari project tempat resource ditentukan.
gcloud projects describe $(gcloud config get-value core/project) --format=value\(projectNumber\)
Memberikan akses ke resource.
Untuk menggunakan gcloud CLI guna memberikan peran Storage Object Viewer (
roles/storage.objectViewer) ke identitas eksternal yang memenuhi kriteria tertentu, jalankan perintah berikut.Menurut subjek
gcloud storage buckets add-iam-policy-binding BUCKET_ID \ --role=roles/storage.objectViewer \ --member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"Menurut grup
gcloud storage buckets add-iam-policy-binding BUCKET_ID \ --role=roles/storage.objectViewer \ --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"Menurut atribut
gcloud storage buckets add-iam-policy-binding BUCKET_ID \ --role=roles/storage.objectViewer \ --member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"Ganti kode berikut:
BUCKET_ID: bucket yang akan diberi aksesPROJECT_NUMBER: nomor project. dari project yang berisi workload identity poolPOOL_ID: ID pool dari workload identity poolSUBJECT: nilai yang diharapkan untuk atribut yang Anda petakan kegoogle.subjectGROUP: nilai yang diharapkan untuk atribut yang Anda petakan kegoogle.groupsATTRIBUTE_NAME: nama atribut khusus dalam pemetaan atribut AndaATTRIBUTE_VALUE: nilai atribut kustom dalam pemetaan atribut Anda
Anda dapat memberikan peran pada resource Google Cloud apa pun yang mendukung kebijakan izin IAM.
Peniruan akun layanan
Untuk membuat akun layanan bagi workload eksternal, lakukan hal berikut:
Aktifkan IAM, Security Token Service, dan Service Account Credentials API, jika belum diaktifkan.
Peran yang diperlukan untuk mengaktifkan API
Untuk mengaktifkan API, Anda memerlukan izin
serviceusage.services.enable. Jika Anda membuat project, kemungkinan Anda sudah memiliki izin ini melalui peran Pemilik (roles/owner). Jika tidak, Anda bisa mendapatkan izin ini melalui peran Service Usage Admin (roles/serviceusage.serviceUsageAdmin). Pelajari cara memberikan peran.Buat akun layanan yang merepresentasikan workload. Sebaiknya Anda menggunakan akun layanan khusus untuk setiap workload. Akun layanan tidak perlu berada dalam project yang sama dengan workload identity pool, tetapi Anda harus merujuk ke project yang berisi akun layanan.
Berikan akses akun layanan untuk resource yang ingin diakses oleh identitas eksternal.
Agar identitas gabungan dapat meniru akun layanan, lakukan hal berikut:
Konsol
Untuk menggunakan konsol Google Cloud guna memberikan peran IAM ke identitas gabungan dengan akun layanan, lakukan hal berikut:
Akun Layanan dalam project yang sama
Untuk memberikan akses menggunakan peniruan akun layanan untuk akun layanan dalam project yang sama, lakukan hal berikut:
Buka halaman Workload Identity Pools.
Pilih Berikan akses.
Dalam dialog Grant access to service account, pilih Grant access using Service Account impersonation.
Dalam daftar Service accounts, pilih akun layanan untuk ditiru oleh identitas eksternal, dan lakukan hal berikut:
Untuk memilih identitas dalam pool yang dapat meniru identitas akun layanan, lakukan salah satu tindakan berikut:
Untuk mengizinkan hanya identitas tertentu dari workload identity pool untuk meniru identitas akun layanan, pilih Hanya identitas yang cocok dengan filter.
Di daftar Nama atribut, pilih atribut yang ingin Anda filter.
Di kolom Attribute value, masukkan nilai atribut yang diharapkan; misalnya, jika Anda menggunakan pemetaan atribut
google.subject=assertion.sub, tetapkan nama Attribute kesubjectdan Attribute value ke nilai klaimsubdalam token yang dikeluarkan oleh penyedia identitas eksternal Anda.
Untuk menyimpan konfigurasi, klik Simpan, lalu Tutup.
Akun layanan di project yang berbeda
Untuk memberikan akses menggunakan peniruan akun layanan untuk akun layanan di project lain, lakukan hal berikut:
Buka halaman Akun Layanan.
Pilih akun layanan yang ingin Anda tiru.
Klik Kelola akses.
Klik Add principal.
Di kolom New principal, masukkan salah satu principal identifier berikut untuk identitas dalam pool Anda yang akan meniru identitas akun layanan.
Menurut subjek
principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECTGanti kode berikut:
PROJECT_NUMBER: nomor projectPOOL_ID: ID workload poolSUBJECT: subjek individual yang dipetakan dari IdP Anda—misalnya,administrator@example.com
Menurut grup
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUPGanti kode berikut:
PROJECT_NUMBER: nomor projectWORKLOAD_POOL_ID: ID workload poolGROUP: grup yang dipetakan dari IdP Anda—misalnya:administrator-group@example.com
Menurut atribut
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUEGanti kode berikut:
PROJECT_NUMBER: nomor projectWORKLOAD_POOL_ID: ID workload poolATTRIBUTE_NAME: salah satu atribut yang dipetakan dari IdP AndaATTRIBUTE_VALUE: nilai atribut
Menurut pool
principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/*Ganti kode berikut:
PROJECT_NUMBER: nomor projectWORKLOAD_POOL_ID: ID workload pool
Di Select a role, pilih peran Workload Identity User (
roles/iam.workloadIdentityUser).Untuk menyimpan konfigurasi, klik Save.
gcloud
Untuk memberikan peran Workload Identity User (roles/iam.workloadIdentityUser)
ke akun utama atau set akun utama gabungan, jalankan perintah
berikut. Untuk mempelajari lebih lanjut ID utama Workload Identity Federation, lihat Jenis akun utama.
Menurut subjek
gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
--role=roles/iam.workloadIdentityUser \
--member="principal://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/subject/SUBJECT"Menurut grup
gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
--role=roles/iam.workloadIdentityUser \
--member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/group/GROUP"Menurut atribut
gcloud iam service-accounts add-iam-policy-binding SERVICE_ACCOUNT_EMAIL \
--role=roles/iam.workloadIdentityUser \
--member="principalSet://iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/POOL_ID/attribute.ATTRIBUTE_NAME/ATTRIBUTE_VALUE"Ganti kode berikut:
SERVICE_ACCOUNT_EMAIL: alamat email akun layananPROJECT_NUMBER: nomor project. dari project yang berisi workload identity poolPOOL_ID: ID pool dari workload identity poolSUBJECT: nilai yang diharapkan untuk atribut yang Anda petakan kegoogle.subjectGROUP: nilai yang diharapkan untuk atribut yang Anda petakan kegoogle.groupsATTRIBUTE_NAME: nama atribut khusus dalam pemetaan atribut AndaATTRIBUTE_VALUE: nilai atribut kustom dalam pemetaan atribut Anda
Mendownload konfigurasi
Agar workload Anda dapat mengakses library klien, Anda harus mendownload dan mengonfigurasi kredensial default aplikasi (ADC) terlebih dahulu dengan melakukan hal berikut:
-
Di konsol Google Cloud , buka halaman Workload Identity Pools.
Buka Workload Identity Pool -
Pada tabel, pilih pool Anda untuk membuka halaman detail pool.
-
Klik Grant access.
-
Pilih Berikan akses menggunakan identitas gabungan (Direkomendasikan).
-
Untuk mendownload Kredensial Default Aplikasi (ADC) agar workload Anda dapat mengakses library klien, lakukan hal berikut:
-
Klik Download config.
-
Dalam dialog Configure your application, lakukan hal berikut:
-
Di menu drop-down Penyedia, pilih penyedia Anda.
-
Di OIDC token path atau SAML assertion path, masukkan jalur tempat token atau pernyataan berada.
Di menu drop-down Format type, pilih format.
-
-
Klik Download configuration, dan catat jalur tempat Anda menyimpan file.
-