Kebijakan batas akses utama

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:

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: //iam.googleapis.com/locations/global/workforcePools/WORKFORCE_POOL_ID

Organisasi yang berisi workforce identity pool
Workload identity pool

Berisi semua identitas dalam workload identity pool yang ditentukan.

Format: //iam.googleapis.com/projects/PROJECT_NUMBER/locations/global/workloadIdentityPools/WORKLOAD_POOL_ID

Project yang berisi workload identity pool
Domain Google Workspace

Berisi semua identitas di domain Google Workspace yang ditentukan.

Format: //iam.googleapis.com/locations/global/workspace/CUSTOMER_ID

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: //cloudresourcemanager.googleapis.com/projects/PROJECT_ID

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: //cloudresourcemanager.googleapis.com/folders/FOLDER_ID

Folder
Set akun utama organisasi

Berisi identitas berikut:

  • Semua identitas di semua domain yang terkait dengan ID pelanggan Google Workspace Anda
  • Semua workforce identity pool di organisasi Anda
  • Semua akun layanan, workload identity pool, dan identitas agen di project mana pun dalam organisasi

Format: //cloudresourcemanager.googleapis.com/organizations/ORGANIZATION_ID

Organisasi
Identitas agen

Semua identitas agen di domain kepercayaan project yang ditentukan. Secara default, domain kepercayaan project berisi semua identitas agen dalam project.

Format:

  • //agents.global.org-ORGANIZATION_ID.system.id.goog/attribute.container/projects/PROJECT_NUMBER
  • //agents.global.proj-PROJECT_NUMBER.system.id.goog/attribute.container/projects/PROJECT_NUMBER
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:

Hierarki resource untuk example.com

Hierarki resource untuk example.com

  • Organisasi, example.com
  • Project, project-1, yang merupakan turunan dari organisasi
  • Folder, folder-a, yang merupakan turunan dari organisasi
  • Dua project, project-2 dan project-3, yang merupakan turunan dari folder-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.com berada dalam set akun utama untuk example.com dan akan terpengaruh oleh kebijakan Batas Akses Akun Utama yang terikat ke set akun utama tersebut.

  • Akun layanan di project-1 berada dalam set akun utama untuk project-1 dan example.com, serta akan terpengaruh oleh kebijakan Batas Akses Akun Utama yang terikat ke salah satu set akun utama tersebut.

  • Identitas agen di project-3 berada dalam set entitas utama untuk project-3, folder-a, dan example.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.type mengacu 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.subject mengacu 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 organisasi example.com.
  • Anda ingin akun utama di example-project memenuhi syarat untuk mengakses resource di example.com. Untuk melakukannya, Anda membuat kebijakan Batas Akses Akun Utama di example.com yang membuat akun utama memenuhi syarat untuk mengakses resource di example.com dan mengikat kebijakan tersebut ke set akun utama untuk example-project.
  • Anda memindahkan example-project dari example.com ke cymbalgroup.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 format organizations/ORGANIZATION_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID, dengan ORGANIZATION_ID adalah ID numerik organisasi tempat kebijakan Batas Akses Akun Utama dibuat dan PAB_POLICY_ID adalah 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, nilai etag harus cocok dengan nilai yang disimpan di IAM. Jika nilai etag tidak 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 kolom resources. 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 format RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID, dengan RESOURCE_TYPE/RESOURCE_ID adalah jenis dan ID resource induk binding kebijakan dan BINDING_ID adalah 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, nilai etag harus cocok dengan nilai yang disimpan di IAM. Jika nilai etag tidak 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}, dengan PRINCIPAL_SET adalah 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 selalu PRINCIPAL_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 kolom policy.

  • 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