O documento descreve como criar uma entrada de ACL e adicioná-la a um recurso de ACL do Kafka gerenciado. Se o recurso de ACL do Kafka gerenciado não existir, essa operação também vai criar o recurso de ACL.
Essa operação é análoga à criação de uma única vinculação de ACL do Apache Kafka. Ao contrário da operação de atualização, ela não exige uma ETag para controle de simultaneidade.
Papéis e permissões necessárias
Para receber a permissão necessária
para adicionar uma entrada de ACL,
peça ao administrador para conceder a você o
papel do IAM de Editor de ACLs gerenciadas do Kafka (roles/managedkafka.aclEditor) no projeto.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Esse papel predefinido contém a
permissão managedkafka.acls.updateEntries, que é
necessária para
adicionar uma entrada de ACL.
Também é possível receber essa permissão com papéis personalizados ou outros papéis predefinidos.
Adicionar uma entrada de ACL
Console
No Google Cloud console, acesse a página Clusters.
Clique no nome do cluster em que você quer adicionar uma entrada de ACL.
Clique na guia Controle de acesso.
Clique em Criar entrada de ACL.
No painel Criar entrada de ACL, insira os detalhes da entrada de ACL:
Na lista Tipo de recurso, selecione o tipo de recurso de cluster a que esta ACL se aplica. Para mais informações, consulte ID da ACL.
Se o tipo de recurso for
Topic,Consumer groupouTransactional ID, selecione ou insira o ID do recurso.Se o tipo de recurso for
Topic prefix,Consumer group prefixouTransactional ID prefix, insira o prefixo da ACL para corresponder a.No campo Principal, insira o principal da entrada de ACL.
Na lista Tipo de permissão, selecione
ALLOWouDENY.Na lista Operação, selecione o tipo de operação para a entrada da ACL.
Clique em Criar.
gcloud
Execute o comando 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=*
Substitua:
ACL_ID. O ID do recurso de ACL do Kafka gerenciado a ser atualizado. Para mais informações, consulte ID da ACL. Se uma ACL gerenciada do Kafka com esse ID não existir, uma será criada automaticamente.CLUSTER_ID: o ID do cluster do Kafka.LOCATION: a região do cluster do Kafka.PRINCIPAL: o principal da nova entrada de ACL.OPERATION: o tipo de operação, comoREADouCREATE.PERMISSION_TYPE: a permissão que a principal tem para a operação. EspecifiqueALLOWouDENY.
Comando de amostra
Execute o comando a seguir para permitir que uma conta de serviço específica leia um
tópico chamado test-topic no cluster test-cluster na região 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='*'
Confira um exemplo de saída:
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
A saída do comando add-acl-entry fornece informações sobre o estado da ACL resultante:
acl: esta seção descreve o recurso de ACL atualizado depois que a nova entrada foi adicionada.aclEntries: é uma lista que contém todas as entradas de controle de acesso para essa ACL. Neste exemplo, ele incluiria a entrada recém-adicionada. Cada entrada tem os seguintes campos:host: o host da entrada de ACL.operation: a operação do Kafka a que esta entrada se aplica.permissionType: se o acesso éALLOWouDENY.principal: o usuário ou a conta de serviço a que esta entrada se refere.
etag: a tag de entidade da ACL atualizada. Ele é usado para controle de simultaneidade otimista durante atualizações subsequentes. O valor muda depois que uma entrada é adicionada.name: o identificador exclusivo do recurso ACL. Ele segue o formatoprojects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}.patternType: o tipo de padrão de recurso para esta ACL.resourceName: o nome do recurso do Kafka a que esta ACL se aplica.resourceType: o tipo de recurso do Kafka.
aclCreated: um valor booleano que indica se o recurso de ACL foi criado como resultado da adição desta entrada.