Mengelola kebijakan akses

Halaman ini menjelaskan cara mengelola kebijakan akses yang ada. Anda dapat melakukan hal berikut:

Mendapatkan nama dan etag kebijakan akses

Konsol

Untuk mendapatkan nama numerik kebijakan akses di konsol Google Cloud , lakukan hal berikut:

  1. Di menu navigasi konsol Google Cloud , klik Security, lalu klik Kontrol Layanan VPC.

    Buka Kontrol Layanan VPC

  2. Jika diminta, pilih organisasi, folder, atau project Anda.

  3. Di halaman Kontrol Layanan VPC, klik Kelola kebijakan.

  4. Di halaman Manage VPC Service Control policies, klik judul kebijakan akses yang ingin Anda periksa.

  5. Di halaman Edit access policy, temukan ID numerik kebijakan di bagian Access policy name.

gcloud

Untuk mendapatkan nama kebijakan akses Anda, gunakan perintah list. Nama kebijakan akses diperlukan untuk semua perintah tingkat akses untuk alat command line gcloud.

gcloud access-context-manager policies list \
    --organization ORGANIZATION_ID

Dengan:

  • ORGANIZATION_ID adalah ID numerik organisasi Anda.

Anda akan melihat output yang mirip dengan:

NAME           ORGANIZATION  TITLE        ETAG
1034095178592  511928527926  Corp Policy  10bc3c76ca809ab2

API

Untuk mendapatkan nama kebijakan akses Anda, panggil accessPolicies.list.

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan terlihat mirip dengan:

{
  "accessPolicies": [
    {
      object(AccessPolicy)
    }
  ],
  "nextPageToken": string
}

Dengan:

Menetapkan kebijakan akses default untuk alat command line gcloud

Saat menggunakan alat command line gcloud, Anda dapat menetapkan kebijakan akses default. Saat menetapkan kebijakan default, Anda tidak perlu lagi menentukan kebijakan setiap kali menggunakan perintah Access Context Manager.

Untuk menetapkan kebijakan akses default, gunakan perintah config.

gcloud config set access_context_manager/policy POLICY_NUMBER

Dengan:

Mendelegasikan kebijakan akses

Konsol

Untuk mendelegasikan administrasi kebijakan akses tercakup di konsolGoogle Cloud , lakukan hal berikut:

  1. Di menu navigasi konsol Google Cloud , klik Security, lalu klik Kontrol Layanan VPC.

    Buka Kontrol Layanan VPC

  2. Jika diminta, pilih organisasi, folder, atau project Anda.

  3. Di halaman Kontrol Layanan VPC, klik Kelola kebijakan.

  4. Di halaman Kelola kebijakan Kontrol Layanan VPC, di baris untuk kebijakan akses tercakup yang ingin Anda delegasikan, klik tombol , lalu klik Edit.

  5. Di halaman Edit access policy, di bagian Manage principals, klik Add principals.

  6. Di panel Add principals, pilih akun utama, seperti akun pengguna atau akun layanan.

  7. Pilih peran yang ingin Anda kaitkan dengan akun utama, seperti Access Context Manager admin, Access Context Manager editor, atau Access Context Manager reader, lalu klik Save.

  8. Di halaman Edit access policy, klik Save.

gcloud

Untuk mendelegasikan administrasi dengan mengikat principal dan peran dengan kebijakan akses yang tercakup, gunakan perintah add-iam-policy-binding.

gcloud access-context-manager policies add-iam-policy-binding \
[POLICY] --member=PRINCIPAL --role=ROLE

Dengan:

  • POLICY adalah ID kebijakan atau ID yang sepenuhnya memenuhi syarat untuk kebijakan.

  • PRINCIPAL adalah akun utama yang akan ditambahkan binding-nya. Tentukan dalam format berikut: user|group|serviceAccount:email atau domain:domain.

  • ROLE adalah nama peran yang akan ditetapkan ke principal. Nama peran adalah jalur lengkap peran bawaan, seperti roles/accesscontextmanager.policyEditor, atau ID peran untuk peran khusus, seperti organizations/{ORGANIZATION_ID}/roles/accesscontextmanager.policyEditor.

API

Untuk mendelegasikan administrasi kebijakan akses tercakup, lakukan hal berikut:

  1. Buat isi permintaan.

    {
"policy": "IAM_POLICY",
}

    Dengan:

    • IAM_POLICY adalah kumpulan binding. Binding mengikat satu atau beberapa anggota, atau principal, ke satu peran. Principal dapat berupa akun pengguna, akun layanan, grup Google, dan domain. Peran adalah daftar izin yang diberi nama; setiap peran dapat berupa peran bawaan IAM atau peran khusus yang dibuat pengguna.

  2. Delegasikan kebijakan akses dengan memanggil accessPolicies.setIamPolicy.

    POST https://accesscontextmanager.googleapis.com/v1/accessPolicies

Isi respons

Jika berhasil, isi respons akan memuat instance policy.

Menjelaskan kebijakan akses

Konsol

Untuk melihat detail kebijakan akses di konsol Google Cloud , lakukan hal berikut:

  1. Di menu navigasi konsol Google Cloud , klik Security, lalu klik Kontrol Layanan VPC.

    Buka Kontrol Layanan VPC

  2. Jika diminta, pilih organisasi, folder, atau project Anda.

  3. Di halaman Kontrol Layanan VPC, klik Kelola kebijakan.

  4. Di halaman Manage VPC Service Control policies, klik judul kebijakan akses yang ingin Anda lihat.

    Halaman Edit access policy menampilkan judul kebijakan, Access policy name numerik, cakupan, dan akun utama yang didelegasikan.

gcloud

Untuk mendeskripsikan kebijakan akses Anda, gunakan perintah describe.

gcloud access-context-manager policies describe POLICY_NUMBER

Dengan:

  • POLICY_NUMBER adalah nama numerik kebijakan Anda.

Output berikut akan muncul:

name: accessPolicies/1034095178592
parent: organizations/511928527926
title: Corp Policy

API

Untuk mendeskripsikan kebijakan akses Anda, panggil accessPolicies.get

GET https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

Dengan:

  • POLICY_NUMBER adalah nama numerik kebijakan Anda.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons akan berisi objek AccessPolicy.

Memperbarui kebijakan akses

Konsol

Di konsol Google Cloud , Anda tidak dapat mengubah judul atau cakupan kebijakan akses yang ada. Untuk mengubah judul kebijakan akses, gunakan alat command line gcloud atau API.

Untuk memperbarui akun utama yang didelegasikan dan binding peran untuk kebijakan akses tercakup di konsol Google Cloud , lihat Mendelegasikan kebijakan akses.

gcloud

Untuk memperbarui kebijakan akses, gunakan perintah update. Saat ini, Anda hanya dapat mengubah judul kebijakan.

gcloud access-context-manager policies update POLICY_NUMBER \
    --title=POLICY_TITLE

Dengan:

  • POLICY_NUMBER adalah nama numerik kebijakan Anda.

  • POLICY_TITLE adalah judul kebijakan yang dapat dibaca manusia.

Output berikut akan muncul:

Waiting for PATCH operation [accessPolicies/POLICY_NUMBER/update/1542234231134882]...done.

API

Saat ini, Anda hanya dapat mengubah judul kebijakan akses.

Untuk memperbarui kebijakan Anda:

  1. Buat isi permintaan.

    {
 "parent": "ORGANIZATION_ID",
 "title": "POLICY_TITLE"
}

    Dengan:

    • ORGANIZATION_ID adalah ID numerik organisasi Anda.

    • POLICY_TITLE adalah judul kebijakan yang dapat dibaca manusia.

  2. Panggil accessPolicies.patch.

    PATCH https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER/UPDATE_MASK

    Dengan:

    • POLICY_NUMBER adalah nama numerik kebijakan Anda.

    • UPDATE_MASK adalah string yang mewakili nilai yang ingin Anda perbarui. Contoh, title.

    Isi respons

    Jika berhasil, isi respons untuk panggilan berisi resource Operation yang memberikan detail tentang operasi PATCH.

Menghapus kebijakan akses

Konsol

Untuk menghapus kebijakan akses di konsol Google Cloud , lakukan hal berikut:

  1. Di menu navigasi konsol Google Cloud , klik Security, lalu klik Kontrol Layanan VPC.

    Buka Kontrol Layanan VPC

  2. Jika diminta, pilih organisasi, folder, atau project Anda.

  3. Di halaman Kontrol Layanan VPC, klik Kelola kebijakan.

  4. Di halaman Kelola Kontrol Layanan VPC, di baris untuk kebijakan akses yang ingin Anda hapus, klik tombol , lalu klik Hapus.

  5. Pada dialog konfirmasi, klik Delete.

gcloud

Untuk menghapus kebijakan akses:

  1. Gunakan perintah delete.

    gcloud access-context-manager policies delete POLICY_NUMBER

    Dengan:

    • POLICY_NUMBER adalah nama numerik kebijakan Anda.

  2. Konfirmasi bahwa Anda ingin menghapus kebijakan akses.

    Contoh:

    You are about to delete policy [POLICY_NUMBER]

Do you want to continue (Y/n)?

    Output berikut akan muncul:

    Deleted policy [1034095178592].

API

Untuk menghapus kebijakan akses Anda, panggil accessPolicies.delete.

DELETE https://accesscontextmanager.googleapis.com/v1/accessPolicies/POLICY_NUMBER

Dengan:

  • POLICY_NUMBER adalah nama numerik kebijakan Anda.

Isi permintaan

Isi permintaan harus kosong.

Isi respons

Jika berhasil, isi respons untuk panggilan berisi resource Operation yang memberikan detail tentang operasi DELETE.

Langkah berikutnya