Di Identity and Access Management (IAM), Anda mengontrol akses untuk akun utama. Akun utama mewakili satu atau beberapa identitas yang telah diautentikasi ke Google Cloud.
Menggunakan akun utama dalam kebijakan Anda
Untuk menggunakan akun utama dalam kebijakan Anda, lakukan hal berikut:
Konfigurasikan identitas yang dapat dikenali oleh Google Cloud . Mengonfigurasi identitas adalah proses pembuatan identitas yang dapat dikenali oleh Google Cloud . Anda dapat mengonfigurasi identitas untuk pengguna dan workload.
Untuk mempelajari cara mengonfigurasi identitas, lihat referensi berikut:
- Untuk mempelajari cara mengonfigurasi identitas bagi pengguna, lihat Identitas untuk pengguna.
- Untuk mempelajari cara mengonfigurasi identitas untuk workload, lihat Identitas untuk workload.
Tentukan ID utama yang akan Anda gunakan. ID akun utama adalah cara Anda merujuk ke akun utama dalam kebijakan Anda. ID ini dapat merujuk ke satu identitas atau ke grup identitas.
Format yang Anda gunakan untuk ID utama bergantung pada hal berikut:
- Jenis akun utama
- Jenis kebijakan yang ingin Anda sertakan dalam akun utama
Untuk melihat format ID utama untuk setiap jenis akun utama di setiap jenis kebijakan, lihat ID utama.
Setelah mengetahui format ID, Anda dapat menentukan ID unik akun utama berdasarkan atribut akun utama, seperti alamat email akun utama.
Sertakan ID akun utama dalam kebijakan Anda. Tambahkan akun utama ke kebijakan Anda, dengan mengikuti format kebijakan.
Untuk mempelajari berbagai jenis kebijakan di IAM, lihat Jenis kebijakan.
Dukungan untuk jenis akun utama
Setiap jenis kebijakan IAM mendukung subset jenis akun utama yang didukung IAM. Untuk melihat jenis akun utama yang didukung untuk setiap jenis kebijakan, lihat ID akun utama.
Jenis akun utama
Tabel berikut menjelaskan secara singkat berbagai jenis akun utama yang didukung oleh IAM. Untuk mengetahui deskripsi mendetail dan contoh tampilan jenis akun utama saat digunakan dalam kebijakan, klik nama jenis akun utama dalam tabel.
| Jenis principal | Deskripsi | Satu akun utama atau set akun utama | Dikelola Google atau digabungkan | Dukungan jenis kebijakan |
|---|---|---|---|---|
| Akun layanan | Akun yang digunakan oleh workload mesin, bukan oleh pengguna. | Satu akun utama | Dikelola oleh Google |
Jenis kebijakan berikut mendukung akun layanan:
|
allAuthenticatedUsers |
ID khusus yang mewakili semua akun layanan dan pengguna manusia di internet yang telah diautentikasi dengan Akun Google. |
Set akun utama yang dapat berisi jenis akun utama berikut:
|
Dikelola oleh Google |
Jenis kebijakan berikut mendukung
Jenis kebijakan berikut tidak mendukung
|
allUsers atau principalSet://goog/public:all |
ID khusus yang mewakili siapa saja yang ada di internet—terautentikasi dan tidak terautentikasi. |
Set akun utama yang dapat berisi jenis akun utama berikut:
|
Keduanya |
Jenis kebijakan berikut mendukung
|
| Satu akun utama dalam workforce identity pool | Pengguna manusia dengan identitas yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workforce Identity Federation. | Satu akun utama | Gabungan |
Jenis kebijakan berikut mendukung akun utama tunggal dalam workforce identity pool:
|
| Satu set akun utama dalam workforce identity pool | Sekumpulan pengguna manusia dengan identitas yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workforce Identity Federation. | Set akun utama yang berisi workforce identity. | Gabungan |
Jenis kebijakan berikut mendukung sekumpulan akun utama dalam workforce identity pool:
|
| Satu akun utama dalam workload identity pool | Workload (atau pengguna mesin) dengan identitas yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workload Identity Federation. | Satu akun utama | Gabungan |
Jenis kebijakan berikut mendukung akun utama tunggal dalam workload identity pool:
|
| Satu set akun utama dalam workload identity pool | Sekumpulan workload (atau pengguna mesin) dengan identitas yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workload Identity Federation. | Set akun utama yang berisi workload identity | Gabungan |
Jenis kebijakan berikut mendukung sekumpulan akun utama dalam workload identity pool:
|
| Satu set Pod Google Kubernetes Engine | Workload (atau pengguna mesin) yang berjalan dan digabungkan melalui GKE. | Set akun utama yang dapat berisi satu atau beberapa workload identity gabungan | Gabungan |
Jenis kebijakan berikut mendukung Pod GKE:
Jenis kebijakan berikut tidak mendukung Pod GKE:
|
| Identitas agen | Identitas untuk workload agentic yang dibuktikan dengan kuat dan terikat dengan siklus proses agen. | Satu akun utama | Dikelola oleh Google |
Jenis kebijakan berikut mendukung identitas agen:
|
| Kumpulan identitas agen | Semua identitas agen dalam domain kepercayaan. | Set akun utama yang berisi identitas agen. | Dikelola oleh Google |
Jenis kebijakan berikut mendukung serangkaian identitas agen:
|
Bagian berikut menjelaskan jenis akun utama ini secara lebih mendetail.
Akun layanan
Akun layanan adalah akun untuk workload aplikasi atau komputasi, bukan untuk pengguna akhir individu. Akun layanan dapat dibagi menjadi akun layanan yang dikelola pengguna dan akun layanan yang dikelola Google, yang disebut agen layanan:
Saat menjalankan kode yang dihosting di Google Cloud, Anda menentukan akun layanan yang akan digunakan sebagai identitas untuk aplikasi Anda. Anda dapat membuat akun layanan yang dikelola pengguna sebanyak yang diperlukan untuk mewakili berbagai komponen logis aplikasi Anda.
Beberapa layanan Google Cloud memerlukan akses ke resource Anda agar layanan tersebut dapat bertindak atas nama Anda. Google membuat dan mengelola agen layanan untuk memenuhi kebutuhan ini.
Contoh berikut menunjukkan cara mengidentifikasi akun layanan dalam berbagai jenis kebijakan:
- Kebijakan izin:
serviceAccount:my-service-account@my-project. - Kebijakan penolakan:
principal://iam.googleapis.com/projects/-/serviceAccounts/my-service-account@my-project.
Untuk mempelajari lebih lanjut format ID utama, lihat ID utama.
Untuk mengetahui informasi selengkapnya tentang akun layanan, lihat halaman berikut:
allAuthenticatedUsers
Nilai allAuthenticatedUsers adalah ID khusus yang mewakili semua
akun layanan.
Jenis akun utama ini tidak mencakup identitas gabungan, yang dikelola oleh penyedia identitas (IdP) eksternal. Untuk menyertakan identitas gabungan, gunakan salah satu pilihan berikut:
- Untuk menyertakan pengguna dari semua IdP, gunakan
allUsers. - Untuk menyertakan pengguna dari IdP eksternal tertentu, gunakan ID untuk semua identitas dalam workforce identity pool atau semua identitas dalam workload identity pool.
Beberapa jenis resource tidak mendukung jenis akun utama ini.
allUsers
Nilai allUsers adalah ID khusus yang mewakili siapa saja yang ada di
internet, termasuk pengguna terautentikasi dan tidak terautentikasi.
Beberapa jenis resource tidak mendukung jenis akun utama ini.
Contoh berikut menunjukkan kemungkinan tampilan ID allUsers dalam
berbagai jenis kebijakan:
- Kebijakan izin pada jenis resource yang didukung:
allUsers - Kebijakan penolakan:
principalSet://goog/public:all
Untuk mempelajari lebih lanjut format ID utama, lihat ID utama.
Identitas gabungan dalam workforce identity pool
Workforce identity pool adalah kumpulan identitas pengguna yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workforce Identity Federation. Anda dapat mereferensikan akun utama di pool ini dengan cara berikut:
- Identitas tunggal dalam workforce identity pool
- Semua workforce identity dalam grup tertentu
- Semua workforce identity dengan nilai atribut tertentu
- Semua identitas dalam workforce identity pool
Contoh berikut menunjukkan cara mengidentifikasi workforce identity pool gabungan dalam berbagai jenis kebijakan:
- Satu identitas dalam kebijakan izin:
principal://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/subject/raha@altostrat.com - Grup identitas dalam kebijakan penolakan:
principalSet://iam.googleapis.com/locations/global/workforcePools/altostrat-contractors/group/administrators-group@altostrat.com
Untuk mempelajari lebih lanjut format ID utama, lihat ID utama.
Identitas gabungan dalam workload identity pool
Workload identity pool adalah kumpulan workload identity yang dikelola oleh IdP eksternal dan digabungkan menggunakan Workload Identity Federation. Anda dapat mereferensikan akun utama di pool ini dengan cara berikut:
- Identitas tunggal dalam workload identity pool
- Semua workload identity dalam grup tertentu
- Semua workload identity dengan nilai atribut tertentu
- Semua identitas dalam workload identity pool
Contoh berikut menunjukkan cara mengidentifikasi workload identity pool gabungan dalam berbagai jenis kebijakan:
- Satu identitas dalam kebijakan izin:
principal://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/subject/raha@altostrat.com - Grup identitas dalam kebijakan penolakan:
principalSet://iam.googleapis.com/projects/123456789012/locations/global/workloadIdentityPools/altostrat-contractors/group/administrators-group@altostrat.com
Untuk mempelajari lebih lanjut format ID utama, lihat ID utama.
Identitas agen
Identitas agen adalah identitas yang dikelola Google untuk workload agentic. Identitas agen diatestasi dan dikaitkan dengan siklus proses agen, yang memberikan cara yang lebih aman untuk mengelola akses agen ke resource Google Cloud daripada menggunakan akun layanan.
Setiap agen otomatis disediakan dengan identitas agen. Anda dapat memberikan atau menolak akses ke resource Google Cloud menggunakan kebijakan izin dan penolakan IAM. Anda juga dapat mengelola akses untuk semua identitas agen dalam project, folder, atau organisasi menggunakan kebijakan izinkan, tolak, dan Batas Akses Akun Utama.
Identitas agen juga dapat dikelompokkan ke dalam kumpulan identitas agen.
Contoh berikut menunjukkan cara mengidentifikasi identitas agen dalam berbagai jenis kebijakan:
- Satu identitas agen dalam kebijakan izin (dalam organisasi):
principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent - Satu identitas agen dalam kebijakan izin (dalam project tanpa organisasi):
principal://agents.global.proj-9876543210.system.id.goog/resources/aiplatform/projects/9876543210/locations/us-central1/reasoningEngines/my-test-agent - Semua identitas agen dalam project dalam kebijakan penolakan:
principal://agents.global.org-123456789012.system.id.goog/resources/aiplatform/projects/9876543210 - Semua identitas agen dalam project dalam kebijakan Batas Akses Akun Utama:
//agents.global.org-123456789012.system.id.goog/attribute.container/projects/9876543210
Untuk mempelajari lebih lanjut format ID utama, lihat ID utama.
Langkah berikutnya
- Pelajari jenis kebijakan yang didukung IAM.
- Memberikan peran kepada akun utama di project, folder, atau organisasi Resource Manager.