Crea un ACL Kafka gestito

Le liste di controllo dell'accesso (ACL) di Managed Kafka forniscono un'autorizzazione granulare per le operazioni all'interno del cluster Managed Service per Apache Kafka. La creazione di una risorsa ACL Kafka gestita definisce un insieme di regole di autorizzazione per un pattern di risorse Kafka specifico. Per i concetti di base, consulta Controllo degli accessi con IAM e ACL Kafka.

Prima di iniziare

Assicurati di avere un cluster Managed Service per Apache Kafka esistente.

Ruoli e autorizzazioni richiesti

Per ottenere l'autorizzazione necessaria per creare un ACL Managed Kafka, chiedi all'amministratore di concederti il ruolo IAM Managed Kafka ACL Editor (roles/managedkafka.aclEditor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene l'autorizzazione managedkafka.acls.create, necessaria per creare un ACL di Managed Kafka.

Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.

Proprietà di un ACL Kafka gestito

Quando crei una risorsa ACL Kafka gestito, devi definire le seguenti proprietà:

ID ACL

L'ID ACL è un identificatore univoco della risorsa ACL Kafka gestito all'interno del cluster. L'ID ACL definisce anche le risorse del cluster a cui si applica l'ACL. Utilizza il seguente pattern di denominazione per gli ID ACL:

  • ACL che si applica al cluster: cluster

  • ACL che si applicano a una risorsa specifica nel cluster:

    • Argomento: topic/RESOURCE_NAME
    • Gruppo di consumer: consumerGroup/RESOURCE_NAME
    • ID transazione: transactionalId/RESOURCE_NAME

    Sostituisci RESOURCE_NAME con il nome della risorsa.

    Ad esempio, per concedere le autorizzazioni per un argomento denominato my-topic, l'ID ACL è topic/my-topic.

  • ACL che si applicano alle risorse corrispondenti a un prefisso:

    • Argomenti: topicPrefixed/PREFIX
    • Gruppi di consumer: consumerGroupPrefixed/PREFIX
    • ID transazione: transactionalIdPrefixed/PREFIX

    Sostituisci PREFIX con il prefisso da trovare.

    Ad esempio, per concedere le autorizzazioni per tutti gli argomenti che iniziano con test-, l'ID ACL è topicPrefixed/test-.

  • ACL che si applicano a tutte le risorse di un determinato tipo:

    • Tutti gli argomenti: allTopics
    • Tutti i gruppi di consumer: allConsumerGroups
    • Tutti gli ID transazione: allTransactionalIds

Dopo aver creato un ACL di Managed Kafka, non puoi modificare l'ID ACL.

Voci ACL

Una voce ACL definisce un'autorizzazione specifica di un'entità per le risorse del cluster che corrispondono all'ACL. Quando crei un ACL Kafka gestito, devi specificare almeno una voce ACL. Puoi aggiungere o rimuovere voci ACL in un ACL esistente.

Il numero massimo di voci ACL per risorsa ACL Kafka gestita è 1000. Se hai bisogno di più regole per un singolo pattern di risorse, devi gestire gli ACL direttamente utilizzando gli strumenti Apache Kafka standard.

Ogni voce ACL contiene i seguenti campi:

Entità
L'utente o il account di servizio a cui si applica l'autorizzazione. Utilizza il seguente formato: User:PRINCIPAL_EMAIL. Sostituisci PRINCIPAL_EMAIL con l'indirizzo email dell'entità. Puoi anche impostare questo campo su User:*, che corrisponde a ogni entità.
Tipo di operazione
L'operazione Kafka a cui si applica l'autorizzazione, ad esempio ALL, READ, WRITE, CREATE, DELETE, ALTER, DESCRIBE, CLUSTER_ACTION, DESCRIBE_CONFIGS, ALTER_CONFIGS o IDEMPOTENT_WRITE. Il valore non fa distinzione tra maiuscole e minuscole. Per le combinazioni valide di operazioni e tipi di risorse, consulta Operazioni e risorse sui protocolli nella documentazione di Apache Kafka.
Tipo di autorizzazione
Il tipo di autorizzazione. I valori supportati sono ALLOW e DENY (senza distinzione tra maiuscole e minuscole).
Host
Questo campo deve essere impostato sul carattere jolly (*) per Managed Service per Apache Kafka.

Proprietà ACL di solo output

Quando crei un ACL Kafka gestito, il servizio imposta le seguenti proprietà:

  • Tipo di risorsa: il tipo di risorsa ACL. Uno dei valori tra CLUSTER, TOPIC, GROUP o TRANSACTIONAL_ID.

  • Nome della risorsa: il nome della risorsa ACL o il prefisso corrispondente. Per il tipo di risorsa CLUSTER, il valore è sempre "kafka-cluster". Può essere il valore letterale jolly "*".

  • Tipo di pattern ACL: LITERAL o PREFIXED.

Questi campi sono di solo output. Puoi utilizzarli per mappare le risorse ACL di Managed Kafka alle associazioni ACL di Kafka.

ETag

Quando crei, visualizzi o aggiorni un ACL Kafka gestito, la risposta include un ETag. L'ETag viene utilizzato per controllo della contemporaneità ottimistico. Le operazioni di aggiornamento su un ACL Kafka gestito devono includere l'ETag per garantire che le modifiche vengano applicate alla stessa versione esistente nel cluster Kafka. Per saperne di più, consulta Sostituisci le voci ACL in un ACL Managed Kafka.

Se l'ETag contiene un carattere 'T' finale, significa che le voci ACL sono troncate. Nel cluster Kafka sono presenti altre voci per l'ACL, ma non possono essere restituite nella descrizione dell'ACL a causa dei limiti sui campi ripetuti.

Crea un'ACL

Quando crei un ACL Kafka gestito, puoi specificare le voci ACL direttamente nella riga di comando o creando un file che contiene le voci ACL.

Specifica le voci ACL nella riga di comando

gcloud

Esegui il comando gcloud managed-kafka acls create:

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

Sostituisci quanto segue:

  • ACL_ID: l'ID della nuova risorsa ACL. L'ID definisce le risorse del cluster a cui si applica l'ACL. Per saperne di più, consulta ID ACL.

  • CLUSTER_ID: l'ID del tuo cluster Kafka.

  • LOCATION La regione del cluster Kafka.

Per ogni voce ACL, specifica un flag --acl-entry separato e sostituisci quanto segue:

  • PRINCIPAL: l'entità per la voce ACL.

  • OPERATION: il tipo di operazione, ad esempio READ o CREATE.

  • PERMISSION_TYPE: l'autorizzazione di cui dispone l'entità per l'operazione. Specifica ALLOW o DENY.

Specifica le voci ACL in un file

gcloud

  1. Crea un file locale che definisca le voci ACL in formato YAML:

    ---
    aclEntries:
    - principal: PRINCIPAL
      operation: OPERATION
      permissionType: PERMISSION_TYPE
      host: "*"
    - principal: ...
      operation: ...
      permissionType: ...
      host: "*"
    

    Per ogni voce ACL nell'elenco aclEntries, sostituisci quanto segue:

    • PRINCIPAL: l'entità per la voce ACL.

    • OPERATION: il tipo di operazione, ad esempio READ o CREATE.

    • PERMISSION_TYPE: l'autorizzazione di cui dispone l'entità per l'operazione. Specifica ALLOW o DENY.

  2. Esegui il comando gcloud managed-kafka acls create:

    gcloud managed-kafka acls create ACL_ID \
      --cluster=CLUSTER_ID \
      --location=LOCATION \
      --acl-entries-from-file=FILE_PATH
    

    Sostituisci quanto segue:

    • ACL_ID: l'ID della nuova risorsa ACL. L'ID definisce le risorse del cluster a cui si applica l'ACL. Per saperne di più, consulta ID ACL.

    • CLUSTER_ID: l'ID del tuo cluster Kafka.

    • LOCATION La regione del cluster Kafka.

    • FILE_PATH: il percorso del file locale contenente l'elenco delle voci ACL.

Passaggi successivi

Apache Kafka® è un marchio registrato di Apache Software Foundation o delle sue società affiliate negli Stati Uniti e/o in altri paesi.