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:
clusterACL 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_NAMEcon il nome della risorsa.Ad esempio, per concedere le autorizzazioni per un argomento denominato
my-topic, l'ID ACL ètopic/my-topic.- Argomento:
ACL che si applicano alle risorse corrispondenti a un prefisso:
- Argomenti:
topicPrefixed/PREFIX - Gruppi di consumer:
consumerGroupPrefixed/PREFIX - ID transazione:
transactionalIdPrefixed/PREFIX
Sostituisci
PREFIXcon il prefisso da trovare.Ad esempio, per concedere le autorizzazioni per tutti gli argomenti che iniziano con
test-, l'ID ACL ètopicPrefixed/test-.- Argomenti:
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
- Tutti gli argomenti:
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 suUser:*, 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_CONFIGSoIDEMPOTENT_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
ALLOWeDENY(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,GROUPoTRANSACTIONAL_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:
LITERALoPREFIXED.
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.LOCATIONLa 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 esempioREADoCREATE.PERMISSION_TYPE: l'autorizzazione di cui dispone l'entità per l'operazione. SpecificaALLOWoDENY.
Specifica le voci ACL in un file
gcloud
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 esempioREADoCREATE.PERMISSION_TYPE: l'autorizzazione di cui dispone l'entità per l'operazione. SpecificaALLOWoDENY.
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_PATHSostituisci 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.LOCATIONLa regione del cluster Kafka.FILE_PATH: il percorso del file locale contenente l'elenco delle voci ACL.