Menghapus kebijakan Batas Akses Utama

Kebijakan Principal Access Boundary (PAB) memungkinkan Anda membatasi resource yang dapat diakses oleh sekumpulan akun utama. Jika Anda tidak ingin lagi menerapkan kebijakan Batas Akses Akun Utama untuk set akun utama, Anda dapat menghapus binding kebijakan yang mengikat kebijakan ke set akun utama. Jika ingin menghapus kebijakan Batasan Akses Akun Utama dari semua set akun utama yang terikat dengannya, Anda dapat menghapus kebijakan tersebut.

Menghapus kebijakan Batas Akses Akun Utama dari set akun utama memiliki salah satu efek berikut:

  • Jika akun utama dalam set akun utama tidak tunduk pada kebijakan Batas Akses Akun Utama lainnya, akun utama tersebut akan memenuhi syarat untuk mengakses semua resourceGoogle Cloud .
  • Jika akun utama dalam set akun utama tunduk pada kebijakan Batas Akses Akun Utama lainnya, akun utama tersebut hanya akan memenuhi syarat untuk mengakses resource dalam kebijakan tersebut.

Sebelum memulai

  • Menyiapkan autentikasi.

    Pilih tab untuk melihat bagaimana Anda berencana menggunakan contoh di halaman ini:

    gcloud

    Di konsol Google Cloud , aktifkan Cloud Shell.

    Aktifkan Cloud Shell

    Di bagian bawah konsol Google Cloud , sesi Cloud Shell akan dimulai dan menampilkan prompt command line. Cloud Shell adalah lingkungan shell dengan Google Cloud CLI yang sudah terinstal, dan dengan nilai yang sudah ditetapkan untuk project Anda saat ini. Diperlukan waktu beberapa detik untuk melakukan inisialisasi pada sesi.

    REST

    Untuk menggunakan contoh REST API di halaman ini dalam lingkungan pengembangan lokal, gunakan kredensial yang Anda berikan ke gcloud CLI.

      Instal Google Cloud CLI.

      Jika Anda menggunakan penyedia identitas (IdP) eksternal, Anda harus login ke gcloud CLI dengan identitas gabungan Anda terlebih dahulu.

    Untuk mengetahui informasi selengkapnya, lihat Melakukan autentikasi untuk menggunakan REST dalam dokumentasi autentikasi Google Cloud .

  • Baca ringkasan kebijakan Batas Akses Utama (PAB).

Peran yang diperlukan untuk menghapus kebijakan Principal Access Boundary

Untuk mendapatkan izin yang Anda perlukan untuk menghapus kebijakan Principal Access Boundary, minta administrator untuk memberi Anda peran IAM Principal Access Boundary Admin (roles/iam.principalAccessBoundaryAdmin) di organisasi Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin iam.principalaccessboundarypolicies.delete, yang diperlukan untuk menghapus kebijakan Batas Akses Akun Utama.

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Peran yang diperlukan untuk menghapus binding kebijakan Batas Akses Akun Utama

Izin yang Anda perlukan untuk menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama (PAB) bergantung pada set akun utama yang terikat ke kebijakan tersebut.

Untuk mendapatkan izin yang Anda perlukan guna menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama, minta administrator untuk memberi Anda peran IAM berikut:

  • Principal Access Boundary User (roles/iam.principalAccessBoundaryUser) di organisasi Anda
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke workforce identity pool: IAM Workforce Pool Admin (roles/iam.workforcePoolAdmin) di workforce identity pool target
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama yang terikat ke workload identity pool: IAM Workload Identity Pool Admin (roles/iam.workloadIdentityPoolAdmin) pada project yang memiliki workload identity pool target
  • Mendapatkan status operasi yang berjalan lama untuk menghapus binding yang merujuk ke workload identity pool: IAM Operation Viewer (roles/iam.operationViewer) pada project yang memiliki workload identity pool target
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama yang terikat ke domain Google Workspace: Workspace Pool IAM Admin (roles/iam.workspacePoolAdmin) pada organisasi
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama yang terikat ke set akun utama project: Admin IAM Project (roles/resourcemanager.projectIamAdmin) pada project
  • Mendapatkan status operasi yang berjalan lama untuk menghapus binding yang merujuk ke set akun utama project: IAM Operation Viewer (roles/iam.operationViewer) pada project
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke set akun utama folder: Folder IAM Admin (roles/resourcemanager.folderIamAdmin) di folder tersebut
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke set akun utama organisasi: Organization Administrator (roles/resourcemanager.organizationAdmin) di organisasi

Untuk mengetahui informasi selengkapnya tentang pemberian peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin yang diperlukan untuk menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama. Untuk melihat izin yang benar-benar diperlukan, perluas bagian Izin yang diperlukan:

Izin yang diperlukan

Izin berikut diperlukan untuk menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama:

  • iam.principalaccessboundarypolicies.unbind pada organisasi
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Akun Utama yang terikat ke workforce identity pool: iam.workforcePools.deletePolicyBinding pada workforce identity pool target
  • Hapus binding kebijakan untuk kebijakan Batas Akses Akun Utama yang terikat ke workload identity pool: iam.workloadIdentityPools.deletePolicyBinding pada project yang memiliki workload identity pool target
  • Dapatkan status operasi yang berjalan lama untuk menghapus binding yang merujuk ke workload identity pool: iam.operations.get pada project yang memiliki workload identity pool target
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke domain Google Workspace: iam.workspacePools.deletePolicyBinding di organisasi
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke set akun utama project: resourcemanager.projects.deletePolicyBinding pada project
  • Mendapatkan status operasi yang berjalan lama untuk menghapus binding yang merujuk ke set akun utama project: iam.operations.get pada project
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama (PAB) yang terikat ke set akun utama folder: resourcemanager.folders.deletePolicyBinding di folder
  • Menghapus binding kebijakan untuk kebijakan Batas Akses Utama yang terikat ke set akun utama organisasi: resourcemanager.organizations.deletePolicyBinding pada organisasi

Anda mungkin juga bisa mendapatkan izin ini dengan peran khusus atau peran bawaan lainnya.

Bersiap untuk menghapus kebijakan Principal Access Boundary

Sebelum menghapus kebijakan Batas Akses Akun Utama, tentukan sasaran mana yang ingin Anda capai:

  • Membuat akun utama dalam set akun utama memenuhi syarat untuk mengakses semua resource
  • Mengurangi jumlah resource yang dapat diakses oleh akun utama dalam set akun utama

Bagian berikut menjelaskan langkah-langkah yang harus dilakukan untuk mencapai setiap sasaran ini.

Membuat akun utama memenuhi syarat untuk mengakses semua resource

Jika Anda ingin membuat akun utama dalam set akun utama memenuhi syarat untuk mengakses semua resource, lakukan hal berikut:

  1. Identifikasi semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas.
  2. Hapus semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas dengan menghapus binding kebijakan yang relevan.

Jika akun utama tidak tunduk pada kebijakan Batas Akses Akun Utama, akun utama tersebut memenuhi syarat untuk mengakses semua resource Google Cloud .

Memenuhi syarat untuk mengakses resource tidak berarti pengguna dapat mengakses resource. Untuk mengetahui informasi selengkapnya, lihat Evaluasi kebijakan.

Mengurangi resource yang dapat diakses oleh akun utama

Jika akun utama dalam set akun utama tunduk pada beberapa kebijakan Batas Akses Akun Utama, Anda dapat mengurangi jumlah resource yang dapat diakses oleh akun utama dengan menghapus satu atau beberapa kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama tersebut. Namun, jangan pernah menghapus semua kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama—jika Anda melakukannya, akun utama akan memenuhi syarat untuk mengakses semua resource Google Cloud .

Untuk menghapus kebijakan Batas Akses Akun Utama sekaligus memastikan bahwa akun utama dalam set akun utama selalu tunduk pada setidaknya satu kebijakan Batas Akses Akun Utama, ikuti langkah-langkah berikut:

  1. Identifikasi semua kebijakan Batas Akses Utama (PAB) yang terikat ke set entitas.
  2. Identifikasi kebijakan Batas Akses Utama (PAB) yang hanya berisi resource yang ingin Anda izinkan untuk diakses oleh entitas dalam set entitas. Ini adalah kebijakan yang tidak akan Anda hapus dari set akun utama.

    Jika Anda tidak memiliki kebijakan tersebut, buat kebijakan Batasan Akses Akun Utama baru yang hanya berisi resource yang ingin Anda izinkan untuk diakses oleh akun utama. Kemudian, lampirkan kebijakan ke set akun utama.

  3. Identifikasi kebijakan Batas Akses Utama (PAB) yang berisi resource yang tidak ingin entitas dalam set entitas diizinkan untuk mengakses. Kemudian, hapus kebijakan Batas Akses Utama (PAB) tersebut dengan menghapus binding kebijakan yang relevan.

    Jika Anda ingin mengurangi akses untuk akun utama tertentu, tambahkan kondisi ke binding kebijakan, bukan menghapusnya.

Jika Anda ingin mengurangi jumlah resource yang dapat diakses oleh akun utama, tetapi tidak ingin menghapus kebijakan Batas Akses Akun Utama, Anda dapat mengubah kebijakan Batas Akses Akun Utama yang berlaku untuk akun utama tersebut. Untuk mempelajari cara mengubah kebijakan Batas Akses Utama, lihat Mengedit kebijakan Batas Akses Utama.

Menguji penghapusan kebijakan atau binding Batas Akses Akun Utama

Sebelum Anda berkomitmen untuk menghapus kebijakan atau binding Batas Akses Akun Utama, sebaiknya uji bagaimana perubahan tersebut dapat memengaruhi akses akun utama Anda. Anda dapat menggunakan Policy Simulator untuk menyimulasikan penghapusan dan membantu Anda memahami potensi dampaknya.

Untuk menguji penghapusan, lihat prosedur berikut dalam dokumentasi Policy Intelligence:

Untuk mempelajari lebih lanjut cara menguji kebijakan Batas Akses Utama dengan Policy Simulator, lihat Policy Simulator untuk kebijakan Batas Akses Utama.

Menghapus kebijakan Principal Access Boundary dari set akun utama

Sebelum menghapus kebijakan Batas Akses Akun Utama dari set akun utama, bersiaplah untuk menghapus kebijakan tersebut terlebih dahulu. Kemudian, hapus kebijakan dengan menghapus binding kebijakan yang mengikat kebijakan ke set akun utama.

Anda dapat menghapus binding kebijakan menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Principal Access Boundary policies.

    Buka kebijakan Batas Akses Utama

  2. Pilih organisasi yang memiliki kebijakan Batasan Akses Akun Utama yang binding-nya ingin Anda hapus.

  3. Klik ID kebijakan dari kebijakan Principal Access Boundary yang binding-nya ingin Anda hapus.

  4. Klik tab Bindings.

  5. Temukan ID binding yang ingin Anda hapus. Di baris binding tersebut, klik Actions, lalu klik Delete binding.

  6. Pada dialog konfirmasi, klik Delete.

gcloud

Perintah gcloud iam policy-bindings delete menghapus binding kebijakan.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • BINDING_ID: ID binding kebijakan yang ingin Anda hapus—misalnya, example-binding.
  • RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilai project, folder, atau organization.

    Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.

  • RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam policy-bindings delete BINDING_ID \
    --RESOURCE_TYPE=RESOURCE_ID --location=global

Windows (PowerShell)

gcloud iam policy-bindings delete BINDING_ID `
    --RESOURCE_TYPE=RESOURCE_ID --location=global

Windows (cmd.exe)

gcloud iam policy-bindings delete BINDING_ID ^
    --RESOURCE_TYPE=RESOURCE_ID --location=global

Respons berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

Delete request issued for: [example-binding]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374724030-6181fcd1520c5-d21b0a12-b704e1ce] to complete...done.
Deleted policyBinding [example-binding].

REST

Metode policyBindings.delete menghapus binding kebijakan.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • RESOURCE_TYPE: Jenis resource Resource Manager (project, folder, atau organisasi) yang merupakan induk dari binding kebijakan. Gunakan nilai projects, folders, atau organizations.

    Jenis resource bergantung pada akun utama yang ditetapkan dalam binding kebijakan. Untuk melihat jenis resource yang akan digunakan, lihat Jenis akun utama yang didukung.

  • RESOURCE_ID: ID project, folder, atau organisasi yang merupakan induk dari binding kebijakan. Project ID adalah string alfanumerik, seperti my-project. ID folder dan ID organisasi berupa numerik, seperti 123456789012.
  • BINDING_ID: ID binding kebijakan yang ingin Anda hapus—misalnya, example-binding.

Metode HTTP dan URL:

DELETE https://iam.googleapis.com/v3/RESOURCE_TYPE/RESOURCE_ID/locations/global/policyBindings/BINDING_ID

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-binding",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Menghapus kebijakan Principal Access Boundary

Sebelum menghapus kebijakan Principal Access Boundary, sebaiknya Anda mengidentifikasi dan menghapus semua binding kebijakan Principal Access Boundary yang merujuk ke kebijakan Principal Access Boundary.

Jika Anda menghapus kebijakan Principal Access Boundary dengan binding kebijakan yang ada, binding tersebut pada akhirnya akan dihapus. Namun, hingga dihapus, binding kebijakan masih diperhitungkan dalam batas 10 binding yang dapat merujuk ke satu set akun utama.

Anda dapat menghapus kebijakan Batas Akses Akun Utama menggunakan konsol Google Cloud , gcloud CLI, atau IAM REST API.

Konsol

  1. Di konsol Google Cloud , buka halaman Principal Access Boundary policies.

    Buka kebijakan Batas Akses Utama

  2. Pilih organisasi yang memiliki kebijakan Batasan Akses Akun Utama yang ingin Anda hapus.

  3. Temukan ID kebijakan yang ingin Anda hapus. Di baris kebijakan tersebut, klik Actions, lalu klik Delete policy.

  4. Pada dialog konfirmasi, konfirmasi bahwa Anda ingin menghapus kebijakan:

    • Untuk menghapus kebijakan hanya jika kebijakan tersebut tidak memiliki binding yang terkait, klik Delete.
    • Untuk menghapus kebijakan dan semua binding terkait, centang kotak Forcefully delete policy, lalu klik Delete.

gcloud

Perintah gcloud iam gcloud iam principal-access-boundary-policies delete menghapus kebijakan Batas Akses Akun Utama dan semua binding terkait.

Sebelum menggunakan salah satu data perintah di bawah, lakukan penggantian berikut:

  • PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda hapus—misalnya, example-policy.
  • ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti 123456789012.
  • FORCE_FLAG: Opsional. Untuk memaksa perintah menghapus kebijakan, meskipun kebijakan tersebut direferensikan dalam binding kebijakan yang ada, gunakan flag --force. Jika flag ini tidak ditetapkan dan kebijakan direferensikan dalam binding kebijakan yang ada, perintah akan gagal.

Jalankan perintah berikut:

Linux, macOS, atau Cloud Shell

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID \
    --organization=ORG_ID --location=global FORCE_FLAG

Windows (PowerShell)

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID `
    --organization=ORG_ID --location=global FORCE_FLAG

Windows (cmd.exe)

gcloud iam principal-access-boundary-policies delete PAB_POLICY_ID ^
    --organization=ORG_ID --location=global FORCE_FLAG

Respons berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

Delete request issued for: [example-policy]
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...
Waiting for operation [organizations/123456789012/locations/global/operations/operation-1715374811191-6181fd2471ab4-f0947406-85778c43] to complete...done.
Deleted principalAccessBoundaryPolicy [example-policy].

REST

Metode principalAccessBoundaryPolicies.delete menghapus kebijakan Principal Access Boundary dan semua binding terkait.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • ORG_ID: ID organisasi yang memiliki kebijakan Batas Akses Akun Utama. ID organisasi berupa angka, seperti 123456789012.
  • PAB_POLICY_ID: ID kebijakan Batas Akses Akun Utama yang ingin Anda hapus—misalnya, example-policy.
  • FORCE_DELETE: Opsional. Untuk memaksa permintaan menghapus kebijakan, meskipun kebijakan tersebut direferensikan dalam binding kebijakan yang ada, tambahkan parameter kueri force=true. Jika parameter kueri ini tidak ditetapkan dan kebijakan direferensikan dalam binding kebijakan yang ada, permintaan akan gagal.

Metode HTTP dan URL:

DELETE https://iam.googleapis.com/v3/organizations/ORG_ID/locations/global/principalAccessBoundaryPolicies/PAB_POLICY_ID?FORCE_DELETE

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Respons berisi operasi yang berjalan lama yang mewakili permintaan Anda. Untuk mempelajari cara mendapatkan status operasi yang berjalan lama, lihat Memeriksa status operasi yang berjalan lama di halaman ini.

{
  "name": "organizations/123456789012/locations/global/operations/operation-1715373190994-6181f71b4daad-6d8168c1-13cc6600",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-05-10T20:33:11.165728913Z",
    "target": "organizations/123456789012/locations/global/policyBindings/example-policy",
    "verb": "delete",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": false
}

Memeriksa status operasi yang berjalan lama

Saat Anda menggunakan REST API atau library klien, metode apa pun yang mengubah kebijakan atau binding akan menampilkan operasi yang berjalan lama (LRO). Operasi yang berjalan lama akan melacak status permintaan dan menunjukkan apakah perubahan pada kebijakan atau binding sudah selesai.

REST

Metode operations.get menampilkan status operasi yang berjalan lama.

Sebelum menggunakan salah satu data permintaan, lakukan penggantian berikut:

  • OPERATION_NAME: Nama lengkap operasi. Anda menerima nama ini sebagai respons atas permintaan asli Anda.

    Nama operasi memiliki format berikut:

    RESOURCE_TYPE/RESOURCE_ID/locations/global/operations/OPERATION_ID
        

Metode HTTP dan URL:

GET https://iam.googleapis.com/v3/OPERATION_NAME

Untuk mengirim permintaan Anda, perluas salah satu opsi berikut:

Anda akan melihat respons JSON seperti berikut:

{
  "name": "organizations/314340013352/locations/global/operations/operation-1732752311821-627edd607a3df-9a62cdea-2a7d9f07",
  "metadata": {
    "@type": "type.googleapis.com/google.iam.v3.OperationMetadata",
    "createTime": "2024-11-28T00:05:12.006289686Z",
    "endTime": "2024-11-28T00:05:12.192141801Z",
    "target": "organizations/314340013352/locations/global/POLICY_TYPE/POLICY_ID",
    "verb": "create",
    "requestedCancellation": false,
    "apiVersion": "v3"
  },
  "done": true,
  "response": {
    POLICY
  }
}

Jika kolom done operasi tidak ada, terus pantau statusnya dengan mendapatkan operasi tersebut berulang kali. Gunakan backoff eksponensial terpotong untuk menambahkan penundaan di antara setiap permintaan. Saat kolom done ditetapkan ke true, operasi akan selesai, dan Anda dapat berhenti mendapatkan operasi tersebut.

Langkah berikutnya