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
Di konsol Google Cloud , buka halaman Clusters.
Klik nama cluster tempat Anda ingin menambahkan entri ACL.
Klik tab Kontrol akses.
Klik Create ACL entry.
Di panel Create ACL entry, masukkan detail entri ACL:
Di daftar Resource type, pilih jenis resource cluster yang akan diterapkan ACL ini. Untuk mengetahui informasi selengkapnya, lihat ID ACL.
Jika jenis resource adalah
Topic,Consumer group, atauTransactional ID, pilih atau masukkan ID resource.Jika jenis resource adalah
Topic prefix,Consumer group prefix, atauTransactional ID prefix, masukkan awalan untuk ACL yang akan dicocokkan dengan.Di kolom Principal, masukkan principal untuk entri ACL.
Dalam daftar Jenis izin, pilih
ALLOWatauDENY.Dalam daftar Operation, pilih jenis operasi untuk entri ACL.
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, sepertiREADatauCREATE.PERMISSION_TYPE: Izin yang dimiliki akun utama untuk operasi. TentukanALLOWatauDENY.
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 aksesnyaALLOWatauDENY.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 adalahprojects/{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.