Mengelola kebijakan akses

Anda dapat menetapkan atau mendapatkan kebijakan Identity and Access Management (IAM), atau kontrol akses, untuk satu atau beberapa Pengujian Konektivitas. Selain itu, Anda dapat melihat izin yang dimiliki pengguna atau akun layanan untuk Pengujian Konektivitas tertentu.

Dokumen ini menunjukkan contoh kontrol akses yang menggunakan Network Management API. Untuk mengikuti langkah-langkah ini di konsol Google Cloud atau dengan menggunakan perintah gcloud, lihat panduan cara menggunakan IAM.

Untuk informasi tentang binding kebijakan dan etag yang tercantum dalam perintah berikut, lihat referensi API untuk kebijakan IAM.

Untuk mengetahui informasi tentang peran dan izin IAM yang diperlukan untuk menjalankan Pengujian Koneksi, lihat Peran dan izin.

Menetapkan kebijakan kontrol akses

Prosedur ini menetapkan kebijakan kontrol akses pada resource Uji Konektivitas yang ditentukan.

API

Gunakan metode networkmanagement.connectivitytests.setIamPolicy untuk menetapkan kebijakan kontrol akses untuk USER, ROLE, dan TEST_ID.

Contoh berikut menetapkan kebijakan yang mengikat peran networkmanagement.admin ke username@yourcompany.com untuk mytest-1.

 POST https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:setIamPolicy
   {
     "version": "VERSION",
     "etag": "ETAG",
     "bindings": [{
       "role": "ROLE",
       "members": [
         "PRINCIPAL"
       ]
     }]
   }

Ganti nilai berikut:

  • TEST_ID: ID objek Uji Konektivitas (pengujian) yang Anda jalankan
  • VERSION: menentukan format kebijakan; nilai yang valid adalah 0, 1, dan 3—setiap operasi yang memengaruhi binding peran bersyarat harus menentukan versi 3
  • ETAG: digunakan untuk kontrol konkurensi optimis sebagai cara untuk membantu mencegah pembaruan kebijakan secara bersamaan agar tidak menimpa satu sama lain (contoh etag adalah BwWbrqiZFRs=)
  • ROLE: peran yang ditetapkan ke akun utama (misalnya, roles/networkmanagement.admin)
  • PRINCIPAL: menentukan identitas yang meminta akses untuk resource Google Cloud (misalnya, user:username@yourcompany.com); untuk daftar jenis akun utama atau anggota, lihat referensi API untuk kebijakan IAM

Mendapatkan kebijakan kontrol akses

Prosedur ini mendapatkan kebijakan kontrol akses untuk resource Uji Konektivitas yang ditentukan.

API

Gunakan metode networkmanagement.connectivitytests.getIamPolicy untuk menetapkan kebijakan kontrol akses untuk PRINCIPAL, ROLE, dan TEST_ID.

Contoh berikut mendapatkan kebijakan yang mengikat peran networkmanagement.admin ke username@yourcompany.com untuk mytest-1.

  GET https: //networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:getIamPolicy
    {
      "version": "VERSION",
      "etag": "ETAG",
      "bindings": [{
        "role": "ROLE",
        "members": [
          "PRINCIPAL"
        ]
      }]
    }

Ganti nilai berikut:

  • TEST_ID: ID objek Uji Konektivitas (pengujian) yang Anda jalankan
  • VERSION: menentukan format kebijakan; nilai yang valid adalah 0, 1, dan 3—setiap operasi yang memengaruhi binding peran bersyarat harus menentukan versi 3
  • ETAG: digunakan untuk kontrol konkurensi optimis sebagai cara untuk membantu mencegah pembaruan kebijakan secara bersamaan agar tidak menimpa satu sama lain (contoh etag adalah BwWbrqiZFRs=)
  • ROLE: peran yang ditetapkan ke akun utama (misalnya, roles/networkmanagement.admin)
  • PRINCIPAL: menentukan identitas yang meminta akses untuk resource Google Cloud (misalnya, user:username@yourcompany.com); untuk daftar jenis akun utama, lihat referensi API untuk kebijakan IAM

Menguji Izin IAM

Prosedur ini menampilkan izin yang dimiliki pengguna atau akun layanan untuk resource Uji Konektivitas.

API

Gunakan metode networkmanagement.connectivitytests.testIamPermissions untuk menampilkan izin yang ditetapkan ke TEST_ID.

Contoh berikut memverifikasi bahwa username@yourcompany.com memiliki izin networkmanagement.connectivitytests.get untuk mytest-1.

  POST https://networkmanagement.googleapis.com/v1/{resource=projects/*/locations/global/connectivityTests/TEST_ID}:testIamPermissions
    {
      "permissions": [
        "networkmanagement.connectivitytests.get"
      ]
    }

Ganti TEST_ID dengan ID objek (pengujian) Pengujian Konektivitas yang Anda jalankan.

Langkah selanjutnya