Adicionar uma entrada de ACL a uma ACL do Kafka gerenciado

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

  1. No Google Cloud console, acesse a página Clusters.

    Acessar Clusters

  2. Clique no nome do cluster em que você quer adicionar uma entrada de ACL.

  3. Clique na guia Controle de acesso.

  4. Clique em Criar entrada de ACL.

  5. No painel Criar entrada de ACL, insira os detalhes da entrada de ACL:

    1. 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.

    2. Se o tipo de recurso for Topic, Consumer group ou Transactional ID, selecione ou insira o ID do recurso.

    3. Se o tipo de recurso for Topic prefix, Consumer group prefix ou Transactional ID prefix, insira o prefixo da ACL para corresponder a.

    4. No campo Principal, insira o principal da entrada de ACL.

    5. Na lista Tipo de permissão, selecione ALLOW ou DENY.

    6. Na lista Operação, selecione o tipo de operação para a entrada da ACL.

  6. 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, como READ ou CREATE.

  • PERMISSION_TYPE: a permissão que a principal tem para a operação. Especifique ALLOW ou DENY.

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 é ALLOW ou DENY.
      • 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 formato projects/{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.

A seguir

Apache Kafka® é uma marca registrada da The Apache Software Foundation ou afiliadas nos Estados Unidos e/ou em outros países.