Kebijakan Principal Access Boundary (PAB) memungkinkan Anda menentukan resource yang dapat diakses oleh akun utama.
Kebijakan terkait akses lainnya, seperti kebijakan izinkan dan tolak, dilampirkan ke resource. Kebijakan ini menentukan siapa yang diizinkan untuk mengakses resource yang dilampirkan. Sebaliknya, kebijakan Batas Akses Utama (PAB) dilampirkan ke set entitas dan mengontrol tindakan yang diizinkan untuk dilakukan oleh entitas dalam set entitas.
Misalnya, Anda dapat menggunakan kebijakan Batas Akses Akun Utama untuk mencegah akun utama Anda mengakses resource di organisasi lain, yang dapat membantu mencegah serangan phishing atau pemindahan data yang tidak sah.
Cara kerja kebijakan Batas Akses Utama (PAB)
Secara default, akun utama memenuhi syarat untuk mengakses resource Google Cloud apa pun. Artinya, jika kebijakan izin memberikan akses ke resource kepada akun utama dan tidak ada kebijakan penolakan yang memblokir akses tersebut, akun utama dapat mengakses resource.
Dengan kebijakan Principal Access Boundary, Anda dapat menentukan resource yang dapat diakses oleh akun utama. Jika akun utama tidak memenuhi syarat untuk mengakses resource, aksesnya ke resource tersebut akan dibatasi, terlepas dari peran yang telah diberikan kepadanya. Untuk mengetahui informasi selengkapnya tentang cara menggunakan kebijakan Batas Akses Akun Utama untuk menentukan resource yang dapat diakses oleh akun utama, lihat Menentukan resource yang memenuhi syarat.
Kebijakan Batas Akses Akun Utama hanya memblokir upaya akses yang melibatkan izin yang didukung. Jika kebijakan Batas Akses Akun Utama tidak dapat memblokir izin, akun utama memenuhi syarat untuk menggunakan izin tersebut guna mengakses resource apa pun, terlepas dari kebijakan yang berlaku untuk mereka. Untuk mengetahui informasi selengkapnya, lihat Izin yang dapat diblokir oleh kebijakan Batas Akses Akun Utama.
Kasus penggunaan
kebijakan Batas Akses Utama (PAB) berguna dalam situasi seperti berikut:
- Mencegah akun utama mengakses resource yang bukan milik Anda
- Membatasi jenis akun utama tertentu, seperti akun layanan, hanya untuk project tertentu
Untuk mengetahui contoh mendetail tentang cara menggunakan kebijakan Batas Akses Utama (PAB) dalam situasi seperti ini, lihat Contoh kasus penggunaan untuk kebijakan Batas Akses Utama (PAB).
Komponen kebijakan Principal Access Boundary
Kebijakan Batas Akses Akun Utama (PAB) terdiri dari aturan individual. Setiap aturan menentukan sekumpulan resource yang dapat diakses oleh akun utama. Setiap kebijakan dapat memiliki hingga 500 aturan.
Kebijakan juga berisi informasi lain, termasuk metadata dan detail konfigurasi. Untuk mengetahui informasi selengkapnya, lihat Struktur kebijakan Batas Akses Akun Utama.
Setelah membuat kebijakan Batas Akses Akun Utama, Anda menerapkan kebijakan tersebut ke kumpulan akun utama dengan membuat binding kebijakan. Semua akun utama dalam set akun utama tersebut kemudian tunduk pada kebijakan Batas Akses Akun Utama tersebut, yang berarti mereka memenuhi syarat untuk mengakses resource yang tercantum dalam kebijakan. Anda dapat mengikat kebijakan Batas Akses Akun Utama ke sejumlah set akun utama.
Anda dapat membuat hingga 1.000 kebijakan batas akses akun utama di organisasi Anda.
Izin yang diblokir oleh kebijakan Batas Akses Utama (PAB)
Kebijakan Batas Akses Akun Utama dapat memblokir semua izin yang disertakan dalam versi penerapan kebijakan. Jika kebijakan Batas Akses Akun Utama dapat memblokir izin, kebijakan tersebut dapat mencegah akun utama yang tidak memenuhi syarat menggunakan izin tersebut untuk mengakses resource.
Anda menentukan versi penerapan kebijakan saat membuat kebijakan. Memperbarui versi penegakan akan memperbarui izin yang dapat diblokir oleh kebijakan. Untuk mengetahui daftar lengkap izin yang diblokir oleh setiap versi penerapan, lihat referensi versi penerapan.
Jika kebijakan Batas Akses Akun Utama tidak dapat memblokir izin, kebijakan tersebut tidak akan memengaruhi apakah akun utama dapat menggunakan izin tersebut atau tidak. Dengan kata lain, IAM tidak dapat menerapkan kebijakan untuk upaya akses yang melibatkan izin tersebut.
Misalnya, bayangkan akun utama, Lee (lee@example.com), diberi peran Developer Dataflow (roles/dataflow.developer). Peran ini mencakup izin dataflow.googleapis.com/jobs.snapshot, yang memungkinkan Lee mengambil snapshot tugas Dataflow. Lee juga tunduk pada kebijakan Batas Akses Akun Utama
yang membuatnya tidak memenuhi syarat untuk mengakses resource di luar example.com.
Namun, jika kebijakan Batas Akses Akun Utama tersebut tidak dapat memblokir
izin dataflow.jobs.snapshot, Lee masih dapat mengambil snapshot
tugas Dataflow di organisasi di luar example.com.
Mengelola versi penegakan
Secara berkala, IAM menambahkan versi penerapan baru yang dapat memblokir izin tambahan. Setiap versi baru juga dapat memblokir semua izin di versi sebelumnya.
Untuk memblokir izin dalam versi penerapan baru, Anda harus memperbarui kebijakan Batas Akses Utama (PAB) untuk menggunakan versi baru.
Jika Anda ingin versi penerapan kebijakan diupdate secara otomatis saat versi baru dirilis, Anda dapat menggunakan nilai latest saat membuat kebijakan.
Namun, sebaiknya jangan gunakan nilai ini, karena dapat menyebabkan akun utama
kehilangan akses ke resource secara tidak terduga.
Kebijakan yang menggunakan latest untuk nomor versi akan menggunakan versi penerapan default. Versi penegakan default biasanya adalah versi terbaru.
Namun, perlu waktu hingga 4 minggu agar versi baru
menjadi versi penerapan default. Untuk mempelajari versi penerapan yang merupakan default, lihat referensi versi penerapan.
Versi penerapan default juga digunakan untuk kebijakan Batas Akses Utama (PAB) baru yang tidak menentukan nomor versi.
Menentukan resource yang memenuhi syarat
Akun utama dapat terpengaruh oleh, atau tunduk pada, sejumlah kebijakan Batas Akses Akun Utama. Bersama-sama, kebijakan ini menentukan resource yang memenuhi syarat untuk diakses oleh akun utama.
Kebijakan Batas Akses Utama (PAB) bersifat kumulatif. Artinya, resource yang dapat diakses oleh akun utama adalah gabungan dari semua resource dalam semua kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama tersebut. Dengan kata lain, jika satu kebijakan Batas Akses Akun Utama membuat akun utama memenuhi syarat untuk mengakses resource, akun utama tersebut memenuhi syarat untuk mengakses resource, terlepas dari kebijakan Batas Akses Akun Utama lainnya yang berlaku untuknya.
Jika akun utama tidak tunduk pada kebijakan Batas Akses Akun Utama, akun utama tersebut memenuhi syarat untuk mengakses resource Google Cloud apa pun.
Bagian berikut menjelaskan cara menyesuaikan kumpulan resource yang dapat diakses oleh akun utama.
Menambahkan referensi yang memenuhi syarat
Ada beberapa cara untuk membuat akun utama memenuhi syarat untuk mengakses resource yang tidak memenuhi syarat untuk diakses:
- Tambahkan resource ke kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama.
- Buat kebijakan Batas Akses Akun Utama baru dengan resource tambahan dan ikat kebijakan ke set akun utama yang menyertakan akun utama.
- Hapus atau hapus semua kebijakan Batas Akses Utama (PAB) yang berlaku untuk entitas. Tindakan ini membuat akun utama memenuhi syarat untuk mengakses semua resource Google Cloud .
Menghapus resource yang memenuhi syarat
Ada beberapa cara untuk membuat akun utama tidak memenuhi syarat untuk mengakses resource yang memenuhi syarat untuk diakses.
Pertama, temukan semua kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama yang menyertakan resource. Berdasarkan kebijakan yang Anda temukan, Anda dapat melakukan salah satu hal berikut:
Jika akun utama tidak tunduk pada kebijakan Principal Access Boundary, buat kebijakan Principal Access Boundary baru yang hanya menyertakan resource yang ingin Anda izinkan untuk diakses oleh akun utama. Kemudian, ikat kebijakan tersebut ke set akun utama yang berisi akun utama.
Setelah Anda menerapkan kebijakan, akun utama akan beralih dari memenuhi syarat untuk mengakses semua resource menjadi hanya memenuhi syarat untuk mengakses resource yang tercantum dalam kebijakan.
Jika akun utama sudah tunduk pada satu atau beberapa kebijakan Batas Akses Akun Utama, Anda harus memastikan bahwa tidak ada kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama tersebut yang menyertakan resource. Untuk mengetahui petunjuk langkah demi langkah, lihat Mengurangi resource yang dapat diakses akun utama.
Selama proses ini, Anda harus memastikan bahwa akun utama selalu tunduk pada setidaknya satu kebijakan Batas Akses Akun Utama. Jika tidak, akun utama mungkin memenuhi syarat untuk mengakses semua resource.
kebijakan Batas Akses Utama (PAB) dan resource yang di-cache
Layanan Google Cloud tertentu meng-cache resource yang terlihat secara publik. Misalnya, Cloud Storage meng-cache objek yang dapat dibaca secara publik.
Apakah kebijakan Batas Akses Akun Utama dapat mencegah akun utama yang tidak memenuhi syarat untuk melihat resource yang terlihat secara publik bergantung pada apakah resource tersebut di-cache:
- Jika resource di-cache, kebijakan Batas Akses Akun Utama tidak dapat mencegah akun utama melihat resource
- Jika resource tidak di-cache, Principal Access Boundary akan mencegah akun utama yang tidak memenuhi syarat untuk melihat resource
Dalam semua kasus, kebijakan Batas Akses Akun Utama tetap mencegah akun utama yang tidak memenuhi syarat untuk mengubah atau menghapus resource yang terlihat secara publik.
Referensi milik Google
Untuk memungkinkan developer menggunakan layanan Google Cloud , seperti
BigQuery dan Cloud Workstations, Google Cloud menyediakan
resource publik milik Google. Misalnya, BigQuery menyediakan
set data publik yang dapat Anda integrasikan ke dalam
aplikasi Anda. Resource publik ini dihosting di organisasiGoogle Cloud milik Google dengan ID 433637338589. Organisasi ini juga digunakan untuk mengelola project tenant untuk layanan seperti Cloud Workstations.
Akun utama yang tunduk pada kebijakan Batas Akses Akun Utama akan kehilangan akses ke resource publik ini, kecuali jika Anda membuat mereka memenuhi syarat untuk mengakses resource di organisasi milik Google.
Agar akun utama memenuhi syarat untuk mengakses resource di organisasi milik Google, tambahkan aturan berikut ke kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama:
{
"description": "Make principals eligible to access Google-owned public resources",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/433637338589"
],
"effect": "ALLOW"
}
Atau, Anda dapat membuat kebijakan Batas Akses Akun Utama baru dengan aturan ini dan mengikatnya ke set akun utama yang relevan.
Evaluasi kebijakan Principal Access Boundary
Saat akun utama mencoba mengakses resource, IAM akan mengevaluasi kebijakan Principal Access Boundary yang relevan untuk menentukan apakah akan memblokir upaya akses tersebut. Kebijakan relevan jika akun utama yang melakukan upaya akses tunduk pada kebijakan tersebut.
Kebijakan Principal Access Boundary hanya dapat memblokir atau tidak memblokir akses—kebijakan ini tidak dapat memberikan akses. Hanya kebijakan izin yang dapat memberikan akses ke resource kepada akun utama. Untuk mempelajari pengaruh berbagai jenis kebijakan terhadap akses akun utama ke resource, lihat Jenis kebijakan.
IAM tidak memblokir akses jika salah satu hal berikut benar:
- Akun utama tidak tunduk pada kebijakan Principal Access Boundary apa pun
- Kebijakan Batas Akses Akun Utama yang relevan tidak dapat memblokir izin dalam permintaan
- Kebijakan Batas Akses Akun Utama membuat akun utama memenuhi syarat untuk mengakses resource
IAM akan memblokir akses jika akun utama tunduk pada setidaknya satu kebijakan Batas Akses Akun Utama, tetapi tidak ada kebijakan yang relevan yang membuat akun utama memenuhi syarat untuk mengakses resource.
Evaluasi fail-closed
Kebijakan Principal Access Boundary (PAB) gagal ditutup. Artinya, jika IAM mengalami error saat mengevaluasi kebijakan Batas Akses Akun Utama, IAM akan mencegah akun utama mengakses resource.
Alasan paling umum IAM mengalami error saat mengevaluasi kebijakan Batas Akses Akun Utama adalah karena detail akun utama masih disebarkan melalui sistem. Hal ini kemungkinan besar terjadi pada pengguna yang baru dibuat. Untuk mengatasi masalah ini, minta akun utama baru menunggu dan mencoba mengakses resource lagi nanti.
Menerapkan kebijakan Batas Akses Utama ke set akun utama
Untuk menerapkan kebijakan Batas Akses Akun Utama ke set akun utama, Anda harus membuat binding kebijakan yang menentukan kebijakan Batas Akses Akun Utama yang ingin diterapkan dan set akun utama yang ingin Anda terapkan. Binding kebijakan ini mengikat kebijakan ke set akun utama.
Setelah Anda mengikat kebijakan ke set akun utama, akun utama dalam set akun utama tersebut hanya dapat mengakses resource yang tercantum dalam kebijakan Batas Akses Akun Utama yang berlaku untuk mereka.
Anda dapat mengikat kebijakan Batas Akses Akun Utama ke sejumlah set akun utama. Setiap set akun utama dapat memiliki hingga 10 kebijakan Batas Akses Akun Utama yang terikat padanya.
Anda hanya dapat membuat binding untuk kebijakan Batas Akses Akun Utama yang ada. Upaya membuat binding untuk kebijakan Batas Akses Utama yang dihapus akan gagal. Jika Anda baru saja menghapus kebijakan Batasan Akses Akun Utama, terkadang Anda dapat berhasil membuat binding, tetapi binding tersebut tidak akan berpengaruh. IAM membersihkan binding ini secara otomatis.
Untuk mempelajari cara mengelola kebijakan Batas Akses Utama (PAB), lihat Membuat dan menerapkan kebijakan Batas Akses Utama (PAB).
Set akun utama yang didukung
Tabel berikut mencantumkan jenis set akun utama yang dapat Anda ikat dengan kebijakan Batas Akses Akun Utama. Setiap baris berisi hal berikut:
- Jenis set akun utama
- Akun utama dalam jenis set akun utama tersebut
- Format ID untuk jenis set akun utama tersebut
- Resource Resource Manager (project, folder, atau organisasi) yang menjadi induk binding kebijakan untuk jenis set akun utama tersebut
| Set akun utama | Detail | Resource induk binding kebijakan |
|---|---|---|
| Kumpulan identitas tenaga kerja |
Berisi semua identitas dalam workforce identity pool yang ditentukan.
Format: |
Organisasi yang berisi workforce identity pool |
| Workload identity pool |
Berisi semua identitas dalam workload identity pool yang ditentukan.
Format: |
Project yang berisi workload identity pool |
| Domain Google Workspace |
Berisi semua identitas di domain Google Workspace yang ditentukan.
Format: Anda dapat menemukan ID pelanggan menggunakan metode berikut:
|
Organisasi yang dikaitkan dengan domain Google Workspace |
| Set akun utama project |
Berisi semua akun layanan, workload identity pool, dan identitas agen dalam project yang ditentukan.
Format: |
Project |
| Set utama folder |
Berisi semua akun layanan, semua workload identity pool, dan semua identitas agen di project mana pun dalam folder yang ditentukan.
Format: |
Folder |
| Set akun utama organisasi |
Berisi identitas berikut:
Format: |
Organisasi |
| Identitas agen |
Semua identitas agen di domain kepercayaan project yang ditentukan. Secara default, domain kepercayaan project berisi semua identitas agen dalam project. Format:
|
Project |
Pewarisan kebijakan dan set akun utama
Kebijakan Batas Akses Utama (PAB) dilampirkan ke set akun utama, bukan resource. Oleh karena itu, tag tidak diwariskan melalui hierarki resource dengan cara yang sama seperti kebijakan izin dan penolakan.
Namun, set akun utama untuk folder dan organisasi selalu menyertakan semua akun utama dalam set akun utama turunannya. Jadi, misalnya, jika akun utama disertakan dalam set akun utama project, akun utama tersebut juga disertakan dalam set akun utama folder atau organisasi induk mana pun.
Misalnya, pertimbangkan organisasi, example.com. Organisasi ini
terkait dengan domain example.com, dan memiliki resource berikut:
- Organisasi,
example.com - Project,
project-1, yang merupakan turunan dari organisasi - Folder,
folder-a, yang merupakan turunan dari organisasi - Dua project,
project-2danproject-3, yang merupakan turunan darifolder-a
Set akun utama resource ini berisi identitas berikut:
| Set akun utama | Identitas Google Workspace di domain example.com |
Kumpulan workforce identity federation di example.com |
Akun layanan, workload identity pool, dan identitas agen di project-1 |
Akun layanan, workload identity pool, dan identitas agen di project-2 |
Akun layanan, workload identity pool, dan identitas agen di project-3 |
|---|---|---|---|---|---|
Set akun utama untuk example.com |
|||||
Set akun utama untuk folder-a |
|||||
Set akun utama untuk project-1 |
|||||
Set akun utama untuk project-2 |
|||||
Set akun utama untuk project-3 |
Akibatnya, entitas berikut terpengaruh oleh kebijakan Batas Akses Utama (PAB) berikut:
Identitas Google Workspace di domain
example.comberada dalam set akun utama untukexample.comdan akan terpengaruh oleh kebijakan Batas Akses Akun Utama yang terikat ke set akun utama tersebut.Akun layanan di
project-1berada dalam set akun utama untukproject-1danexample.com, serta akan terpengaruh oleh kebijakan Batas Akses Akun Utama yang terikat ke salah satu set akun utama tersebut.Identitas agen di
project-3berada dalam set entitas utama untukproject-3,folder-a, danexample.com, serta akan terpengaruh oleh kebijakan Batas Akses Utama (PAB) yang terikat ke salah satu set entitas utama tersebut.
Binding kebijakan bersyarat untuk kebijakan Batas Akses Utama (PAB)
Anda dapat menggunakan ekspresi kondisi dalam binding kebijakan untuk kebijakan Batas Akses Akun Utama guna lebih mempersempit akun utama yang akan dikenai kebijakan.
Ekspresi kondisi untuk binding kebijakan terdiri dari satu atau beberapa pernyataan
yang digabungkan dengan maksimal 10 operator
logis (&&, ||, atau !). Setiap pernyataan menyatakan aturan kontrol berbasis
atribut yang berlaku pada binding kebijakan, dan pada akhirnya menentukan
apakah kebijakan berlaku.
Anda dapat menggunakan atribut principal.type dan principal.subject dalam kondisi untuk binding kebijakan. Tidak ada atribut lain yang didukung.
Atribut
principal.typemengacu pada jenis akun utama yang membuat permintaan—misalnya, akun layanan atau identitas agen. Anda dapat menggunakan kondisi dengan atribut ini untuk mengontrol jenis akun utama yang berlaku untuk kebijakan Batas Akses Akun Utama.Misalnya, jika Anda menambahkan ekspresi kondisi berikut ke binding untuk kebijakan Batas Akses Akun Utama, kebijakan tersebut hanya berlaku untuk akun layanan:
principal.type == 'iam.googleapis.com/ServiceAccount'Atribut
principal.subjectmengacu pada identitas akun utama yang membuat permintaan—misalnya,cruz@example.com. Anda dapat menggunakan kondisi dengan atribut ini untuk mengontrol dengan tepat akun utama mana yang tunduk pada kebijakan Batas Akses Akun Utama.Misalnya, jika Anda menambahkan ekspresi kondisi berikut ke binding untuk kebijakan Batas Akses Akun Utama, kebijakan tersebut tidak akan berlaku untuk pengguna
special-admin@example.com:principal.subject != 'special-admin@example.com'
Untuk mempelajari lebih lanjut nilai yang dapat Anda gunakan untuk kondisi ini, lihat referensi atribut kondisi.
Untuk mengetahui contoh cara menggunakan kondisi ini dalam kebijakan Batas Akses Akun Utama, lihat Membuat akun layanan memenuhi syarat untuk mengakses resource dalam satu project.
Binding kebijakan lintas organisasi
Anda tidak dapat membuat binding kebijakan lintas organisasi untuk kebijakan Batas Akses Akun Utama. Binding kebijakan lintas organisasi adalah binding kebijakan yang mengikat kebijakan di satu organisasi ke set akun utama di organisasi lain.
IAM secara berkala menghapus binding kebijakan lintas organisasi yang ada. Binding kebijakan lintas organisasi dapat terjadi saat Anda memindahkan project dari satu organisasi ke organisasi lain. Misalnya, pertimbangkan situasi berikut:
- Anda memiliki project,
example-project, di organisasiexample.com. - Anda ingin akun utama di
example-projectmemenuhi syarat untuk mengakses resource diexample.com. Untuk melakukannya, Anda membuat kebijakan Batas Akses Akun Utama diexample.comyang membuat akun utama memenuhi syarat untuk mengakses resource diexample.comdan mengikat kebijakan tersebut ke set akun utama untukexample-project. - Anda memindahkan
example-projectdariexample.comkecymbalgroup.com.
Dalam situasi ini, memindahkan project akan membuat binding kebijakan lintas organisasi. Hal ini karena kebijakan Batas Akses Akun Utama di example.com terikat ke set akun utama di cymbalgroup.com. Jika Anda tidak menghapus binding
secara manual, IAM pada akhirnya akan menghapusnya secara otomatis. Menghapus binding ini membantu memastikan bahwa administrator cymbalgroup.com memiliki akses ke semua kebijakan Batas Akses Utama (PAB) yang terikat ke entitas mereka.
Struktur kebijakan Principal Access Boundary
Kebijakan Principal Access Boundary adalah kumpulan metadata dan detail kebijakan Principal Access Boundary. Metadata memberikan informasi seperti nama kebijakan dan waktu pembuatan kebijakan. Detail kebijakan menentukan fungsi kebijakan—misalnya, resource yang dapat diakses oleh akun utama yang terpengaruh.
Misalnya, kebijakan Batas Akses Akun Utama berikut membuat akun utama yang
tunduk pada kebijakan tersebut memenuhi syarat untuk mengakses resource dalam organisasi
dengan ID 0123456789012.
{
"name": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"uid": "puid_0123456789012345678",
"etag": "W/\"Gh/PcTdJD/AWHUhPW45kdw==\"",
"displayName": "Example policy",
"annotations": {
"example-key": "example-value"
},
"createTime": "2024-01-02T15:01:23Z",
"updateTime": "2024-01-02T15:01:23Z",
"details": {
"rules": [
{
"description": "Example principal access boundary policy rule",
"resources": [
"//cloudresourcemanager.googleapis.com/organizations/0123456789012"
],
"effect": "ALLOW"
}
],
"enforcementVersion": "4"
}
}
Bagian berikut menjelaskan kolom dalam metadata dan detail kebijakan Batas Akses Utama (PAB).
Metadata
kebijakan Batas Akses Utama (PAB) berisi metadata berikut:
name: Nama kebijakan Batas Akses Akun Utama. Nama ini memiliki formatorganizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, denganORGANIZATION_IDadalah ID numerik organisasi tempat kebijakan Batas Akses Akun Utama dibuat danPAB_POLICY_IDadalah ID alfanumerik kebijakan Batas Akses Akun Utama.uid: ID unik yang ditetapkan untuk kebijakan Principal Access Boundary.etag: ID untuk status kebijakan saat ini. Nilai ini berubah saat Anda memperbarui kebijakan. Untuk mencegah update yang bertentangan, nilaietagharus cocok dengan nilai yang disimpan di IAM. Jika nilaietagtidak cocok, permintaan akan gagal.displayName: Nama yang dapat dibaca manusia untuk kebijakan Batas Akses Akun Utama.annotations: Opsional. Daftar key-value pair yang ditentukan pengguna. Anda dapat menggunakan anotasi ini untuk menambahkan metadata tambahan ke kebijakan—misalnya, siapa yang membuat kebijakan, atau apakah kebijakan di-deploy oleh pipeline otomatis. Untuk mengetahui informasi selengkapnya tentang anotasi, lihat Anotasi.createTime: Waktu saat kebijakan Batas Akses Utama dibuat.updateTime: Waktu saat kebijakan Principal Access Boundary terakhir diperbarui.
Detail
Setiap kebijakan Principal Access Boundary berisi kolom details. Kolom ini berisi aturan Principal Access Boundary dan versi penegakan:
rules: Daftar aturan Principal Access Boundary, yang menentukan resource yang dapat diakses oleh akun utama yang terpengaruh. Setiap aturan berisi kolom berikut:description: Deskripsi yang dapat dibaca manusia untuk aturan.resources: Daftar resource Resource Manager (project, folder, dan organisasi) yang aksesnya ingin Anda berikan kepada akun utama. Setiap akun utama yang tunduk pada kebijakan ini memenuhi syarat untuk mengakses resource ini.Setiap kebijakan Batas Akses Akun Utama dapat merujuk ke maksimum 500 resource di semua aturan dalam kebijakan.
effect: Hubungan yang dimiliki akun utama dengan resource yang tercantum dalam kolomresources. Satu-satunya efek yang dapat Anda tentukan dalam aturan Principal Access Boundary adalah"ALLOW". Hubungan ini membuat akun utama memenuhi syarat untuk mengakses resource yang tercantum dalam aturan.
enforcementVersion: Versi penerapan yang digunakan IAM saat menerapkan kebijakan. Versi kebijakan Batas Akses Akun Utama menentukan izin mana yang dapat diblokir oleh kebijakan Batas Akses Akun Utama.Untuk mengetahui informasi selengkapnya tentang cara menetapkan dan mengelola versi penerapan, lihat Mengelola versi penerapan di halaman ini.
Struktur binding kebijakan
Binding kebijakan untuk kebijakan Batas Akses Akun Utama berisi nama kebijakan, nama set akun utama yang akan mengikat kebijakan, dan metadata yang menjelaskan binding kebijakan. Kebijakan ini juga dapat berisi kondisi yang mengubah akun utama yang tepat yang menjadi sasaran kebijakan.
Misalnya, binding kebijakan berikut mengikat kebijakan example-policy ke
semua akun utama di organisasi example.com, yang memiliki ID
0123456789012. Binding kebijakan juga berisi kondisi yang mencegah
kebijakan diterapkan untuk akun utama super-admin@example.com.
{
"name": "organizations/0123456789012/locations/global/policyBindings/example-policy-binding",
"uid": "buid_01234567890123456789",
"etag": "W/\"cRMdDXbT82aLuZlvoL9Gqg==\"",
"displayName": "Example policy binding",
"annotations": {
"example-key": "example-value"
},
"target": {
"principalSet": "//cloudresourcemanager.googleapis.com/organizations/0123456789012"
},
"policyKind": "PRINCIPAL_ACCESS_BOUNDARY",
"policy": "organizations/0123456789012/locations/global/principalAccessBoundaryPolicies/example-policy",
"policyUid": "puid_0123456789012345678",
"condition": {
"title": "Exempt principal",
"description": "Don't enforce the policy for super-admin@example.com",
"expression": "principal.subject != 'super-admin@example.com'"
},
"createTime": "2024-01-02T17:00:16Z",
"updateTime": "2024-01-02T17:00:16Z"
}
Setiap binding kebijakan berisi kolom berikut:
name: Nama binding kebijakan. Nama ini memiliki formatRESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, denganRESOURCE_TYPE/RESOURCE_IDadalah jenis dan ID resource induk binding kebijakan danBINDING_IDadalah ID alfanumerik binding kebijakan.uid: ID unik yang ditetapkan untuk binding kebijakan.etag: ID untuk status kebijakan saat ini. Nilai ini berubah saat Anda memperbarui kebijakan. Untuk mencegah update yang bertentangan, nilaietagharus cocok dengan nilai yang disimpan di IAM. Jika nilaietagtidak cocok, permintaan akan gagal.displayName: Nama yang dapat dibaca manusia untuk binding kebijakan.annotations: Opsional. Daftar key-value pair yang ditentukan pengguna. Anda dapat menggunakan anotasi ini untuk menambahkan metadata tambahan ke binding kebijakan—misalnya, siapa yang membuat binding kebijakan, atau apakah binding kebijakan di-deploy oleh pipeline otomatis. Untuk mengetahui informasi selengkapnya tentang anotasi, lihat Anotasi.target: Set akun utama yang akan diikat dengan kebijakan. Nilai ini memiliki format{"principalSet": PRINCIPAL_SET}, denganPRINCIPAL_SETadalah ID set akun utama yang ingin Anda ikatkan ke kebijakan.Setiap target dapat memiliki hingga 10 kebijakan yang terikat padanya.
policyKind: Jenis kebijakan yang dirujuk oleh binding kebijakan. Untuk binding kebijakan untuk kebijakan Batas Akses Utama, nilai ini selaluPRINCIPAL_ACCESS_BOUNDARY.policy: Kebijakan Principal Access Boundary yang akan diikat ke set akun utama target.policyUid: ID unik yang ditetapkan untuk kebijakan Batas Akses Akun Utama yang dirujuk di kolompolicy.condition: Opsional. Ekspresi logika yang memengaruhi akun utama mana yang akan menerapkan kebijakan IAM. Jika kondisi bernilai benar atau tidak dapat dievaluasi, Identity and Access Management akan menerapkan kebijakan untuk akun utama yang membuat permintaan. Jika kondisi bernilai salah (false), Identity and Access Management tidak akan menerapkan kebijakan untuk akun utama. Untuk mengetahui informasi selengkapnya, lihat Principal Access Boundary dan kondisi di halaman ini.createTime: Waktu saat binding kebijakan dibuat.updateTime: Waktu saat binding kebijakan terakhir diperbarui.
Langkah berikutnya
- Pelajari lebih lanjut kasus penggunaan untuk kebijakan Batas Akses Akun Utama.
- Pelajari cara membuat dan menerapkan kebijakan Batas Akses Akun Utama.
- Tinjau izin yang diblokir oleh setiap versi penerapan kebijakan Principal Access Boundary.