Menambahkan entri ACL ke ACL Managed Kafka

Dokumen ini menjelaskan cara membuat entri ACL dan menambahkannya ke resource ACL Kafka Terkelola. Jika resource ACL Managed Kafka tidak ada, operasi ini juga akan membuat resource ACL.

Operasi ini serupa dengan membuat satu binding ACL Apache Kafka. Tidak seperti operasi update, operasi ini tidak memerlukan ETag untuk kontrol konkurensi.

Peran dan izin yang diperlukan

Untuk mendapatkan izin yang diperlukan guna menambahkan entri ACL, minta administrator untuk memberi Anda peran IAM Managed Kafka ACL Editor (roles/managedkafka.aclEditor) di project Anda. Untuk mengetahui informasi selengkapnya tentang cara memberikan peran, lihat Mengelola akses ke project, folder, dan organisasi.

Peran bawaan ini berisi izin managedkafka.acls.updateEntries , yang diperlukan untuk menambahkan entri ACL.

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

Menambahkan entri ACL

Konsol

  1. Di konsol Google Cloud , buka halaman Clusters.

    Buka Cluster

  2. Klik nama cluster tempat Anda ingin menambahkan entri ACL.

  3. Klik tab Kontrol akses.

  4. Klik Create ACL entry.

  5. Di panel Create ACL entry, masukkan detail entri ACL:

    1. Di daftar Resource type, pilih jenis resource cluster yang akan diterapkan ACL ini. Untuk mengetahui informasi selengkapnya, lihat ID ACL.

    2. Jika jenis resource adalah Topic, Consumer group, atau Transactional ID, pilih atau masukkan ID resource.

    3. Jika jenis resource adalah Topic prefix, Consumer group prefix, atau Transactional ID prefix, masukkan awalan untuk ACL yang akan dicocokkan dengan.

    4. Di kolom Principal, masukkan principal untuk entri ACL.

    5. Dalam daftar Jenis izin, pilih ALLOW atau DENY.

    6. Dalam daftar Operation, pilih jenis operasi untuk entri ACL.

  6. Klik Create.

gcloud

Jalankan perintah gcloud managed-kafka acls add-acl-entry:

gcloud managed-kafka acls add-acl-entry ACL_ID \
  --cluster=CLUSTER_ID \
  --location=LOCATION \
  --principal=PRINCIPAL \
  --operation=OPERATION \
  --permission-type=PERMISSION_TYPE \
  --host=*

Ganti kode berikut:

  • ACL_ID. ID resource ACL Managed Kafka yang akan diperbarui. Untuk mengetahui informasi selengkapnya, lihat ID ACL. Jika ACL Kafka Terkelola dengan ID ini tidak ada, ACL akan dibuat secara otomatis.

  • CLUSTER_ID: ID cluster Kafka Anda.

  • LOCATION: Region cluster Kafka Anda.

  • PRINCIPAL: Principal untuk entri ACL baru.

  • OPERATION: Jenis operasi, seperti READ atau CREATE.

  • PERMISSION_TYPE: Izin yang dimiliki akun utama untuk operasi. Tentukan ALLOW atau DENY.

Contoh perintah

Jalankan perintah berikut untuk mengizinkan akun layanan tertentu membaca dari topik bernama test-topic di cluster test-cluster di region us-central1.

gcloud managed-kafka acls add-acl-entry topic/test-topic \
  --cluster=test-cluster \
  --location=us-central1 \
  --principal='User:service-account@test-project.iam.gserviceaccount.com' \
  --operation=READ \
  --permission-type=ALLOW \
  --host='*'

Berikut adalah contoh output:

acl:
  aclEntries:
  - host: '*'
    operation: READ
    permissionType: ALLOW
    principal: 'User:service-account@test-project.iam.gserviceaccount.com'
  etag: W/another-new-etag
  name: projects/test-project/locations/us-central1/clusters/test-cluster/acls/topic/test-topic
  patternType: LITERAL
  resourceName: test-topic
  resourceType: TOPIC
aclCreated: false

Output perintah add-acl-entry memberikan informasi tentang status ACL yang dihasilkan:

  • acl: bagian ini menjelaskan resource ACL yang diperbarui setelah entri baru ditambahkan.

    • aclEntries: ini adalah daftar yang berisi semua entri kontrol akses untuk ACL ini. Dalam contoh ini, entri yang baru ditambahkan akan disertakan. Setiap entri memiliki kolom berikut:

      • host: host untuk entri ACL.
      • operation: operasi Kafka yang berlaku untuk entri ini.
      • permissionType: apakah aksesnya ALLOW atau DENY.
      • principal: pengguna atau akun layanan yang terkait dengan entri ini.
    • etag: ini adalah tag entity untuk ACL yang diperbarui. Digunakan untuk kontrol konkurensi optimis selama update berikutnya. Nilai berubah setelah entri ditambahkan.

    • name: ID unik untuk resource ACL. Formatnya adalah projects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}.

    • patternType: jenis pola resource untuk ACL ini.

    • resourceName: nama resource Kafka yang menjadi tujuan penerapan ACL ini.

    • resourceType: jenis resource Kafka.

  • aclCreated: nilai boolean yang menunjukkan apakah resource ACL dibuat sebagai hasil dari penambahan entri ini.

Langkah berikutnya

Apache Kafka® adalah merek dagang terdaftar milik The Apache Software Foundation atau afiliasinya di Amerika Serikat dan/atau negara lainnya.