Unified Access Policies

Unified Access Policies (UAP) memungkinkan Anda memberikan dan menolak akses ke resourceGoogle Cloud . Tidak seperti kebijakan izin dan penolakan, UAP memungkinkan Anda memberikan dan menolak akses dalam kebijakan yang sama, sehingga pengelolaan kebijakan menjadi lebih sederhana. UAP juga dapat digunakan kembali, yang berarti Anda dapat menerapkan UAP yang sama ke beberapa resource.

Cara kerja Unified Access Policies

Untuk memberikan atau menolak akses di IAM, Anda perlu menentukan siapa yang harus diizinkan atau tidak diizinkan untuk melakukan apa pada resource mana.

Di UAP, Anda menentukan siapa yang harus diizinkan atau tidak diizinkan untuk melakukan apa dengan membuat aturan UAP. Setiap aturan mencantumkan kumpulan akun utama, kumpulan peran dan izin, serta efek. Efek—izinkan atau tolak—menentukan apakah akun utama yang tercantum diberi peran dan izin dalam aturan atau dicegah menggunakan izin dalam aturan. Anda dapat memiliki hingga 100 aturan dalam satu UAP.

Untuk menentukan resource mana yang aksesnya dikontrol oleh UAP, Anda menggunakan binding UAP untuk mengikat UAP ke resource. Anda dapat mengikat satu UAP ke maksimal 5 resource. Satu resource dapat memiliki hingga 5 kebijakan yang terikat padanya.

Kasus penggunaan

Di IAM, ada beberapa jenis kebijakan yang dapat Anda gunakan untuk mengizinkan dan menolak akses:

  • Untuk mengizinkan akses, Anda dapat menggunakan kebijakan izin atau aturan izin UAP.
  • Untuk menolak akses, Anda dapat menggunakan kebijakan penolakan atau aturan penolakan UAP.

Jika Anda sudah menggunakan kebijakan izinkan atau tolak untuk mengontrol akses, sebaiknya terus gunakan kebijakan tersebut. Jenis kebijakan ini juga didukung di Pemecah Masalah Kebijakan, yang memudahkan pemahaman akar masalah error akses.

Gunakan UAP dalam keadaan berikut:

  • Anda sedang menyiapkan organisasi baru dan berencana menggunakan UAP untuk mengontrol akses di seluruh organisasi.
  • Anda ingin menyiapkan kontrol akses terperinci menggunakan kondisi UAP.

Aturan Unified Access Policy

UAP terdiri dari aturan izinkan dan tolak. Aturan ini berisi komponen berikut:

  • Efek: Apakah aturan memberikan akses atau menolak akses. Aturan yang memberikan akses disebut aturan izin. Aturan yang menolak akses disebut aturan penolakan.

  • Satu set akun utama: Akun utama—misalnya, pengguna, grup, atau akun layanan—yang ingin Anda sertakan dalam aturan. Dalam aturan izin, akun utama ini diberi akses. Dalam aturan penolakan, akun utama ini ditolak aksesnya.

  • Daftar peran dan izin: Peran dan izin yang ingin Anda sertakan dalam aturan. Dalam aturan izin, izin ini diberikan. Dalam aturan penolakan, izin ini ditolak.

  • Opsional: Ekspresi kondisi: Ekspresi IAM Conditions yang menentukan kondisi yang harus benar agar aturan dapat diterapkan. Untuk mengetahui informasi selengkapnya, lihat Kondisi di UAP di halaman ini.

Akun utama dalam aturan Unified Access Policy

Untuk menentukan akun utama yang ingin Anda sertakan dalam aturan, tentukan hal berikut:

  • Akun utama yang disertakan: Akun utama yang ingin Anda sertakan dalam aturan.
  • Akun utama yang dikecualikan: Akun utama yang ingin Anda kecualikan dari aturan, meskipun jika akun utama tersebut berada dalam grup di daftar akun utama yang disertakan.

Dengan kedua daftar ini, Anda dapat menentukan secara ringkas akun utama yang ingin disertakan dalam aturan. Misalnya, bayangkan Anda membuat aturan izin untuk memberikan akses kepada pengguna di example.com. Jika Anda ingin memberikan akses kepada semua orang di grup all@example.com kecuali untuk pengguna reduced-access@example.com, maka Anda akan menambahkan all@example.com ke daftar akun utama yang disertakan dan reduced-access@example.com ke daftar akun utama yang dikecualikan.

Peran dan izin dalam aturan Unified Access Policy

Untuk membuat daftar izin yang tepat yang ingin Anda sertakan dalam aturan, tentukan hal berikut:

  • Izin yang disertakan: Izin yang ingin Anda sertakan dalam aturan.
  • Izin yang dikecualikan: Izin yang tidak ingin Anda sertakan dalam aturan, meskipun izin tersebut ada dalam peran atau grup izin dalam daftar izin yang disertakan.

Untuk menambahkan izin ke daftar izin yang disertakan atau izin yang dikecualikan, Anda dapat merujuk ke salah satu hal berikut:

  • Izin: Nama izin individual dalam format nama domain yang sepenuhnya memenuhi syarat (FQDN). Contoh, cloudresourcemanager.googleapis.com/projects.get.

  • Peran (hanya aturan izin): Nama peran yang telah ditetapkan, seperti roles/logging.logsViewer. Jika Anda menyertakan nama peran dalam aturan, aturan tersebut akan menyertakan semua izin dalam peran tersebut. Untuk melihat semua izin dalam peran, lihat referensi peran dan izin.

    Dalam JSON UAP, nama-nama ini selalu diawali dengan role:—misalnya, role:roles/logging.logsViewer.

    Peran hanya diizinkan dalam aturan izin. Peran khusus tidak didukung dalam aturan apa pun.

  • Grup izin: Kumpulan izin, seperti aiplatform.googleapis.com/*.*. Grup izin adalah kumpulan izin yang cocok dengan pola yang ditentukan. Ada beberapa batasan pada grup izin yang dapat Anda referensikan dan izin yang disertakan dalam grup tersebut. Untuk mengetahui informasi selengkapnya, lihat Grup izin di halaman ini.

Grup izin

Grup izin adalah kumpulan izin yang cocok dengan pola yang ditentukan. Anda dapat menggunakan grup izin untuk memberikan atau menolak kumpulan izin terkait—misalnya, Anda dapat menolak semua izin untuk satu layanan atau memberikan semua izin yang diakhiri dengan kata kerja tertentu.

Grup izin berfungsi secara berbeda dalam aturan izinkan dan tolak. Bagian berikut menjelaskan cara menggunakan grup izin di setiap jenis aturan.

Grup izin dalam aturan izin

Untuk mengidentifikasi grup izin dalam aturan izin, ganti satu atau beberapa bagian nama izin dengan karakter pengganti (*). Izin yang disertakan dalam setiap grup bergantung pada posisi karakter pengganti:

  • SERVICE_FQDN/RESOURCE.*: Mencakup semua izin untuk resource yang ditentukan.
  • SERVICE_FQDN/*.*: Mencakup semua izin untuk layanan yang ditentukan.
  • SERVICE_FQDN/*.VERB: Mencakup semua izin untuk layanan yang diakhiri dengan kata kerja yang ditentukan.
  • */*.VERB: Mencakup semua izin yang diakhiri dengan kata kerja yang ditentukan.
  • *: Mencakup semua izin. Nilai ini hanya diizinkan saat mencantumkan izin yang disertakan, bukan izin yang dikecualikan.

Grup izin hanya menyertakan izin yang didukung dalam peran khusus. Izin lain tidak disertakan, meskipun cocok dengan format yang ditentukan.

Untuk mempelajari izin yang didukung dalam peran khusus, lihat Tingkat dukungan untuk izin dalam peran khusus.

Izin yang tercantum di halaman tersebut tidak menggunakan format yang sama dengan izin di UAP:

  • Peran khusus menggunakan format v1 untuk nama izin, yaitu SERVICE_ID.RESOURCE.VERB.
  • UAP menggunakan format nama domain yang sepenuhnya memenuhi syarat untuk nama izin, yaitu SERVICE_FQDN/RESOURCE.VERB.

Namun, nilai untuk SERVICE_ID dan SERVICE_FQDN biasanya serupa. Pada umumnya, nilai SERVICE_FQDN adalah nilai SERVICE_ID dari v1 API, diikuti dengan .googleapis.com. Misalnya, izin untuk menghapus peran dapat ditulis dengan cara berikut:

  • v1 format: iam.roles.delete
  • Format nama domain yang sepenuhnya memenuhi syarat: iam.googleapis.com/roles.delete

Anda dapat menggunakan kesamaan ini untuk menerjemahkan antara kedua format saat meninjau grup izin untuk aturan izin.

Ada beberapa pengecualian untuk aturan ini. Untuk melihat pengecualian ini, tinjau daftar izin yang didukung dalam kebijakan penolakan dan telusuri IAM v1 API di kolom filter.

Grup izin dalam aturan penolakan

Aturan tolak hanya mendukung grup izin tertentu. Grup izin yang didukung tercantum dalam Izin yang didukung dalam kebijakan penolakan. ID untuk grup izin yang didukung menggantikan satu atau beberapa bagian nama izin dengan karakter pengganti (*). Izin yang disertakan setiap grup bergantung pada posisi karakter pengganti:

  • SERVICE_FQDN/RESOURCE.*: Menolak semua izin untuk resource yang ditentukan.
  • SERVICE_FQDN/*.*: Menolak semua izin untuk layanan yang ditentukan.
  • SERVICE_FQDN/*.VERB: Menolak semua izin untuk layanan yang diakhiri dengan kata kerja yang ditentukan.

Grup izin mencakup semua izin saat ini dan di masa mendatang yang cocok dengan pola yang ditentukan. Misalnya, bayangkan Anda menggunakan grup izin example.googleapis.com/exampleResource.* untuk menolak semua izin pengguna untuk jenis resource exampleResource. Jika example.googleapis.com menambahkan izin baru untuk jenis resource exampleResource, seperti example.googleapis.com/exampleResource.newPermission, pengguna akan otomatis ditolak untuk izin baru tersebut.

Anda hanya dapat menggunakan karakter pengganti di grup izin yang didukung. Penggunaan karakter pengganti dalam nama izin lain di aturan tolak tidak didukung.

Membuat Unified Access Policies

Anda dapat membuat UAP dalam project, folder, atau organisasi. Resource tempat Anda membuat UAP akan menjadi induk UAP. Namun, UAP tidak akan berpengaruh sampai Anda menerapkan UAP.

Induk UAP muncul di nama UAP. Nama kebijakan memiliki format RESOURCE_TYPE/RESOURCE_ID/locations/global/accessPolicies/POLICY_ID, dengan placeholder yang mewakili hal berikut:

  • RESOURCE_TYPE: Jenis resource tempat UAP dibuat. Nilai ini adalah projects, folders, atau organizations.
  • RESOURCE_ID: ID resource tempat UAP dibuat.
  • POLICY_ID: ID alfanumerik UAP.

Misalnya, jika Anda membuat UAP example-policy di project example-project, resource induk UAP tersebut adalah example-project dan nama UAP-nya adalah projects/example-project/locations/global/accessPolicies/example-policy.

Tempat membuat Unified Access Policies

Induk UAP tidak memengaruhi resource yang dapat Anda terapkan UAP. Namun, hal ini memengaruhi siapa yang memiliki izin untuk melihat dan mengedit UAP. Untuk membantu memastikan bahwa pengguna yang sesuai memiliki izin untuk melihat dan mengedit UAP yang sesuai, sebaiknya pilih resource induk yang paling mencerminkan cakupan UAP.

Misalnya, jika Anda ingin menerapkan UAP ke organisasi, sebaiknya buat UAP di organisasi tersebut.

Menerapkan kebijakan ke resource

Untuk menerapkan UAP, Anda harus membuat binding. Setiap binding menentukan UAP dan resource untuk mengikat UAP. Setelah Anda membuat binding, aturan dalam UAP akan berlaku untuk resource tersebut, serta turunan resource tersebut.

Misalnya, bayangkan Anda memiliki UAP, compute-access-management. UAP ini memberikan peran Compute Editor (roles/compute.editor) kepada grup compute-users@example.com dan menolak izin compute.googleapis.com/instances.* untuk semua pengguna kecuali compute-users@example.com.

Tanpa binding, UAP ini tidak akan berpengaruh.

Anda ingin UAP ini berlaku untuk semua resource di organisasi example.com, jadi Anda membuat binding yang melampirkan UAP compute-access-management ke example.com. Setelah Anda membuat binding, UAP akan memiliki efek berikut:

  • Anggota compute-users@example.com dapat menggunakan izin dalam peran Compute Editor untuk mengakses resource di example.com.
  • Semua pengguna yang bukan anggota compute-users@example.com dilarang menggunakan izin terkait instance untuk mengakses resource di example.com.

Resource yang didukung

Tabel berikut mencantumkan resource yang dapat Anda ikat dengan UAP. Setiap baris berisi hal berikut:

  • Jenis resource
  • Format ID untuk resource tersebut
  • Resource Resource Manager (project, folder, atau organisasi) yang menjadi induk binding untuk jenis resource tersebut
Resource ID resource Resource induk binding
Project Resource Manager //cloudresourcemanager.googleapis.com/projects/PROJECT_ID Project dalam binding
Folder Resource Manager //cloudresourcemanager.googleapis.com/folders/FOLDER_ID Folder dalam binding
Organisasi Resource Manager //cloudresourcemanager.googleapis.com/organizations/ORG_ID Organisasi dalam binding
Aplikasi AI Agent Registry //agentregistry.googleapis.com/projects/PROJECT_ID/locations/LOCATION/aiApplications/APPLICATION_ID Project induk aplikasi
Agent Gateway Network Services API //networkservices.googleapis.com/projects/PROJECT_ID/locations/LOCATION/agentGateways/GATEWAY_ID Project induk gateway

Menonaktifkan pembuatan binding

Jika ingin menonaktifkan pembuatan binding di organisasi, Anda dapat menerapkan batasan kebijakan organisasi iam.managed.disableAccessPolicyBinding di organisasi Anda. Batasan ini mencegah akun utama di organisasi Anda membuat binding untuk UAP.

Untuk mempelajari cara mengaktifkan atau menonaktifkan batasan ini, lihat Menggunakan batasan terkelola dalam kebijakan organisasi.

Pewarisan kebijakan

Jika Anda mengikat UAP ke project, folder, atau organisasi, UAP tersebut akan diwariskan melalui hierarki resource.

Hierarki resource terdiri dari organisasi (root) di bagian atas, diikuti oleh folder (opsional) untuk pengelompokan, lalu project, yang berisi resource khusus layanan seperti virtual machine Compute Engine dan bucket Cloud Storage.

Dalam hierarki ini, project, folder, dan organisasi adalah resource induk. Dengan kata lain, resource ini adalah resource yang berisi resource lain:

  • Project berisi resource khusus layanan.
  • Folder berisi folder lain, project, dan resource project.
  • Organisasi berisi folder, project, dan resource project.

Resource yang terdapat dalam resource induk adalah turunan dari resource tersebut.

Saat Anda mengikat UAP ke resource induk, UAP tersebut berlaku untuk resource induk dan untuk semua turunan resource tersebut. Dengan kata lain, UAP diwarisi oleh turunan resource.

Pewarisan kebijakan memungkinkan Anda menerapkan kebijakan ke sekumpulan besar resource dengan satu binding. Misalnya, bayangkan Anda membuat UAP yang memberi taylor@example.com peran Compute Engine Admin (roles/compute.admin). UAP juga menolak noam@example.com izin compute.googleapis.com/instances.delete.

Anda ingin UAP ini berlaku untuk semua resource di organisasi Anda, example.com. Untuk melakukannya, ikat UAP ini ke resource organisasi Anda. Setelah Anda mengikat UAP ke organisasi, UAP akan diwarisi melalui semua resource dalam organisasi tersebut.

Mengikat UAP ke organisasi memiliki efek berikut:

  • taylor@example.com dapat menggunakan izin dalam peran Compute Engine Admin untuk mengakses resource apa pun di example.com.
  • noam@example.com tidak dapat menggunakan izin compute.googleapis.com/instances.delete pada resource apa pun di example.com, meskipun UAP pada resource turunan memberinya akses.

Jika Anda ingin UAP diterapkan ke lebih sedikit resource, Anda dapat mengikat UAP ke tingkat hierarki resource yang lebih rendah—misalnya, ke project atau resource khusus layanan yang didukung.

Binding lintas organisasi

Anda tidak dapat membuat binding lintas organisasi untuk UAP. Binding lintas organisasi adalah binding yang mengikat UAP di satu organisasi ke resource di organisasi lain.

IAM secara berkala menghapus binding lintas organisasi yang ada. Binding 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 membuat UAP di project example-project dan mengikatnya ke example-project.
  • Anda memindahkan example-project dari example.com ke cymbalgroup.com.

Dalam situasi ini, memindahkan project akan membuat binding lintas organisasi. Hal ini karena UAP di example.com terikat ke resource 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 UAP yang terikat ke resource di organisasi mereka.

Binding untuk Unified Access Policies yang dihapus

Biasanya, Anda harus menghapus binding untuk UAP sebelum menghapus UAP. Upaya untuk menghapus UAP yang memiliki binding yang ada akan menghasilkan error.

Namun, jika Anda ingin menghapus UAP tanpa menghapus binding yang ada, Anda dapat menghapus paksa UAP.

Menghapus paksa UAP akan menghapusnya dari semua resource yang terikat dengannya. Setiap binding yang merujuk ke UAP pada akhirnya akan dihapus. Namun, hingga dihapus, binding tersebut masih diperhitungkan dalam batas jumlah binding yang dapat merujuk ke satu resource.

Kondisi dalam Unified Access Policies

Dengan IAM Conditions, Anda dapat menentukan dan menerapkan kontrol akses bersyarat berbasis atribut untuk resource Google Cloud . Di UAP, Anda dapat menambahkan kondisi ke setiap aturan untuk mengontrol kapan aturan tersebut berlaku. Anda tidak dapat menambahkan kondisi ke binding UAP.

Kondisi terdiri dari judul, deskripsi, dan ekspresi boolean. Jika ekspresi bernilai true untuk permintaan, aturan akan berlaku untuk permintaan tersebut. Jika bernilai false, aturan tidak berlaku untuk permintaan.

Layanan yang berbeda menawarkan atribut dan fungsi yang berbeda yang dapat Anda gunakan untuk menulis ekspresi kondisi. Saat menambahkan kondisi ke aturan, Anda selalu mengawali kondisi dengan nama layanan yang atribut dan fungsinya Anda gunakan. Anda dapat menambahkan beberapa kondisi ke aturan, tetapi satu kondisi tidak dapat menggabungkan atribut dari layanan yang berbeda.

Misalnya, jika Anda menambahkan kondisi yang menggunakan atribut yang disediakan oleh IAM, awali kondisi dengan iam.googleapis.com:

"conditions": {
  "iam.googleapis.com": {
    "title": "CONDITION_TITLE",
    "description": "CONDITION_DESCRIPTION",
    "expression": "CONDITION_EXPRESSION"
  }
}

Untuk mempelajari cara membuat aturan UAP dengan kondisi, lihat Membuat dan menerapkan UAP.

Izin yang berlaku untuk atribut kondisi

Beberapa atribut khusus layanan hanya berlaku untuk permintaan yang melibatkan izin tertentu. Misalnya, atribut eventarc.googleapis.com message.id hanya berlaku untuk permintaan yang memerlukan izin eventarc.googleapis.com/messageBuses.publish.

Anda hanya dapat menggunakan atribut ini dalam aturan yang menyertakan izin yang berlaku. Jika Anda mencoba menggunakan atribut dalam aturan tanpa izin yang berlaku, pembuatan UAP akan gagal.

Atribut kondisi yang didukung

Atribut berikut didukung dalam aturan UAP:

Layanan Atribut Izin yang berlaku Informasi selengkapnya
iam.googleapis.com (Pratinjau) Tag resource Semua Atribut tag resource
eventarc.googleapis.com (Pratinjau) Pesan eventarc.googleapis.com/messageBuses.publish Atribut pesan Eventarc
iap.googleapis.com (GA) Tujuan iap.googleapis.com/resources.egressViaIAP Atribut tujuan Identity-Aware Proxy

Langkah berikutnya