
Apache Kafka AclCreate
CertifiedCreate a Kafka ACL
Apache Kafka AclCreate
Create a Kafka ACL
Grants (or denies) an operation on a resource to a principal using the Kafka AdminClient.
Use patternType: PREFIXED to authorize an entire per-tenant namespace (for example all topics starting with tenant_acme_) with a single ACL.
type: io.kestra.plugin.kafka.AclCreateExamples
Authorize a tenant service account to produce to its own topic namespace
id: kafka_acl_create
namespace: company.team
tasks:
- id: create_acl
type: io.kestra.plugin.kafka.AclCreate
properties:
bootstrap.servers: localhost:9092
resourceType: TOPIC
resourceName: tenant_acme_
patternType: PREFIXED
principal: "User:tenant-acme-svc"
host: "*"
operation: WRITE
permissionType: ALLOW
Properties
operation *Requiredstring
ALLREADWRITECREATEDELETEALTERDESCRIBECLUSTER_ACTIONDESCRIBE_CONFIGSALTER_CONFIGSIDEMPOTENT_WRITEOperation
For example READ, WRITE, CREATE, DELETE, ALTER, DESCRIBE, ALL.
permissionType *Requiredstring
ALLOWDENYPermission type
ALLOW or DENY.
principal *Requiredstring
Principal
For example User: alice.
properties *Requiredobject
Kafka AdminClient properties
Must include bootstrap.servers; accepts any Kafka AdminClient config. Provide base64-encoded content for ssl.keystore.location and ssl.truststore.location when using SSL.
resourceName *Requiredstring
Resource name
Exact name for LITERAL, or the namespace prefix for PREFIXED.
resourceType *Requiredstring
TOPICGROUPCLUSTERTRANSACTIONAL_IDDELEGATION_TOKENUSERResource type
For example TOPIC, GROUP, CLUSTER, TRANSACTIONAL_ID, DELEGATION_TOKEN, USER.
host string
*Host
Defaults to * (any host).
patternType string
LITERALLITERALPREFIXEDMATCHResource pattern type
LITERAL matches the resource name exactly (default). PREFIXED matches every resource whose name starts with resourceName — the standard way to authorize a whole per-tenant namespace with one ACL. MATCH matches wildcard and prefixed patterns as well as literal ones.
pluginDefaultsRef Non-dynamicstring
Reference (ref) of the pluginDefaults to apply to this task.
timeout string
PT30SAdminClient call timeout
Maximum duration to wait for each AdminClient operation to complete before failing the task. Defaults to PT30S (30 seconds).
Outputs
host string
Host
operation string
ALLREADWRITECREATEDELETEALTERDESCRIBECLUSTER_ACTIONDESCRIBE_CONFIGSALTER_CONFIGSIDEMPOTENT_WRITEOperation
patternType string
LITERALPREFIXEDMATCHResource pattern type
permissionType string
ALLOWDENYPermission type
principal string
Principal
resourceName string
Resource name
resourceType string
TOPICGROUPCLUSTERTRANSACTIONAL_IDDELEGATION_TOKENUSERResource type