Operazioni, risorse e chiavi di condizione per le API di Apache Kafka per i cluster di Amazon MSK

Le API di Apache Kafka per i cluster di Amazon MSK (prefisso del servizio: kafka-cluster) forniscono le seguenti risorse, operazioni e chiavi di contesto della condizione specifiche del servizio per l'utilizzo nelle policy delle autorizzazioni IAM.

Riferimenti:

• Scopri come configurare questo servizio.

• Visualizza un elenco delle operazioni API disponibili per questo servizio.

• Scopri come proteggere questo servizio e le sue risorse utilizzando le policy delle autorizzazioni di IAM.

Operazioni definite dalle API di Apache Kafka per i cluster di Amazon MSK

Puoi specificare le seguenti operazioni nell'elemento Action di un'istruzione di policy IAM. Utilizza le policy per concedere le autorizzazioni per eseguire un'operazione in AWS. Quando utilizzi un'operazione in una policy, in genere consenti o rifiuti l'accesso all'operazione API o al comando CLI con lo stesso nome. Tuttavia, in alcuni casi, una singola operazione controlla l'accesso a più di una operazione. In alternativa, alcune operazioni richiedono operazioni differenti.

La colonna Tipi di risorsa della tabella Operazioni indica se ogni operazione supporta le autorizzazioni a livello di risorsa. Se non vi è nessun valore in corrispondenza di questa colonna, è necessario specificare tutte le risorse ("*") alle quali si applica la policy nell'elemento Resource dell'istruzione di policy. Se la colonna include un tipo di risorsa, puoi specificare un ARN di quel tipo in una istruzione con tale operazione. Se l'operazione ha una o più risorse richieste, il chiamante deve disporre dell'autorizzazione per utilizzare l'operazione con tali risorse. Le risorse richieste sono indicate nella tabella con un asterisco (*). Se si limita l'accesso alle risorse con l'elemento Resource in una policy IAM, è necessario includere un ARN o un modello per ogni tipo di risorsa richiesta. Alcune operazioni supportano più tipi di risorse. Se il tipo di risorsa è facoltativo (non indicato come obbligatorio), puoi scegliere di utilizzare uno tra i tipi di risorsa facoltativi.

La colonna Chiavi di condizione della tabella Operazioni contiene le chiavi che è possibile specificare nell'elemento Condition di un'istruzione di policy. Per ulteriori informazioni sulle chiavi di condizione associate alle risorse per il servizio guarda la colonna Chiavi di condizione della tabella Tipi di risorsa.

Nota

Le chiavi relative alle condizioni delle risorse sono elencate nella tabella Tipi di risorse. Nella colonna Tipi di risorse (*obbligatorio) della tabella Operazioni è presente un collegamento al tipo di risorsa che si applica a un'operazione. Il tipo di risorsa nella tabella Tipi di risorse include la colonna Chiavi di condizione, che contiene le chiavi delle condizioni delle risorse che si applicano a un'operazione nella tabella Operazioni.

Per dettagli sulle colonne nella tabella seguente, consultare Tabella delle operazioni.

Azioni	Descrizione	Livello di accesso	Tipi di risorsa (*obbligatorio)	Chiavi di condizione	Operazioni dipendenti
AlterCluster	Concede l'autorizzazione per modificare vari aspetti del cluster, equivalente all'ACL ALTER CLUSTER di Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:DescribeCluster
AlterClusterDynamicConfiguration	Concede l'autorizzazione per modificare la configurazione dinamica di un cluster, equivalente all'ACL ALTER_CONFIGS CLUSTER di Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:DescribeClusterDynamicConfiguration
AlterGroup	Concede l'autorizzazione per unire dei gruppi all'interno di un cluster, equivalente all'ACL READ GROUP di Apache Kafka	Write	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
AlterTopic	Concede l'autorizzazione per modificare gli argomenti in un cluster, equivalente all'ACL ALTER TOPIC di Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
AlterTopicDynamicConfiguration	Concede l'autorizzazione per modificare la configurazione dinamica degli argomenti in un cluster, equivalente all'ACL ALTER_CONFIGS TOPIC di Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopicDynamicConfiguration
AlterTransactionalId	Concede l'autorizzazione per modificare gli ID transazionali in un cluster, equivalente all'ACL WRITE TRANSACTIONAL_ID di Apache Kafka	Write	transactional-id*		kafka-cluster:Connect kafka-cluster:DescribeTransactionalId kafka-cluster:WriteData
Connect	Concede l'autorizzazione per connettersi e autenticarsi al cluster	Write	cluster*
CreateTopic	Concede l'autorizzazione per creare argomenti in un cluster, equivalente all'ACL CREATE CLUSTER/TOPIC di Apache Kafka	Write	topic*		kafka-cluster:Connect
DeleteGroup	Concede l'autorizzazione per eliminare gruppi all'interno di un cluster, equivalente all'ACL DELETE GROUP di Apache Kafka	Write	group*		kafka-cluster:Connect kafka-cluster:DescribeGroup
DeleteTopic	Concede l'autorizzazione per eliminare argomenti in un cluster, equivalente all'ACL DELETE TOPIC di Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
DescribeCluster	Concede l'autorizzazione per descrivere vari aspetti del cluster, equivalente all'ACL DESCRIBE CLUSTER di Apache Kafka	Elenco	cluster*		kafka-cluster:Connect
DescribeClusterDynamicConfiguration	Concede l'autorizzazione per descrivere la configurazione dinamica di un cluster, equivalente all'ACL DESCRIBE_CONFIGS CLUSTER di Apache Kafka	Elenco	cluster*		kafka-cluster:Connect
DescribeGroup	Concede l'autorizzazione per descrivere i gruppi in un cluster, equivalente all'ACL DESCRIBE GROUP di Apache Kafka	Elenco	group*		kafka-cluster:Connect
DescribeTopic	Concede l'autorizzazione per descrivere argomenti su un cluster, equivalente all'ACL DESCRIBE TOPIC di Apache Kafka	Elenco	topic*		kafka-cluster:Connect
DescribeTopicDynamicConfiguration	Concede l'autorizzazione per descrivere la configurazione dinamica degli argomenti in un cluster, equivalente all'ACL DESCRIBE_CONFIGS TOPIC di Apache Kafka	Elenco	topic*		kafka-cluster:Connect
DescribeTransactionalId	Concede l'autorizzazione per descrivere gli ID transazionali in un cluster, equivalente all'ACL DESCRIBE TRANSACTIONAL_ID di Apache Kafka	Elenco	transactional-id*		kafka-cluster:Connect
ReadData	Concede l'autorizzazione per leggere i dati da argomenti in un cluster, equivalente all'ACL READ TOPIC di Apache Kafka	Read	topic*		kafka-cluster:AlterGroup kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteData	Concede l'autorizzazione per scrivere dati su argomenti in un cluster, equivalente all'ACL WRITE TOPIC di Apache Kafka	Write	topic*		kafka-cluster:Connect kafka-cluster:DescribeTopic
WriteDataIdempotently	Concede l'autorizzazione per scrivere dati in modo idempotente su un cluster, equivalente all'ACL IDEMPOTENT_WRITE CLUSTER di Apache Kafka	Write	cluster*		kafka-cluster:Connect kafka-cluster:WriteData

Tipi di risorse definiti dalle API di Apache Kafka per i cluster Amazon MSK

I seguenti tipi di risorse sono definiti da questo servizio e possono essere utilizzati nell'elemento Resource delle istruzioni di policy delle autorizzazioni IAM. Ogni operazione nella Tabella delle operazioni identifica i tipi di risorse che possono essere specificati con tale operazione. Un tipo di risorsa può anche definire quali chiavi di condizione puoi includere in una policy. Queste chiavi vengono visualizzate nell'ultima colonna della tabella Tipi di risorsa. Per dettagli sulle colonne nella tabella seguente, consulta Tabella dei tipi di risorsa.

Tipi di risorsa	ARN	Chiavi di condizione
cluster	arn:${Partition}:kafka:${Region}:${Account}:cluster/${ClusterName}/${ClusterUuid}	aws:ResourceTag/${TagKey}
topic	arn:${Partition}:kafka:${Region}:${Account}:topic/${ClusterName}/${ClusterUuid}/${TopicName}
group	arn:${Partition}:kafka:${Region}:${Account}:group/${ClusterName}/${ClusterUuid}/${GroupName}
transactional-id	arn:${Partition}:kafka:${Region}:${Account}:transactional-id/${ClusterName}/${ClusterUuid}/${TransactionalId}

Chiavi di condizione per le API di Apache Kafka per i cluster Amazon MSK

Le API di Apache Kafka per i cluster di Amazon MSK definiscono le seguenti chiavi di condizione che possono essere utilizzate nell'elemento Condition di una policy IAM. Puoi utilizzare queste chiavi per perfezionare ulteriormente le condizioni in base alle quali si applica l'istruzione di policy. Per dettagli sulle colonne nella tabella seguente, consulta Tabella delle chiavi di condizione.

Per visualizzare le chiavi di condizione globali disponibili per tutti i servizi, consulta Chiavi di condizione globali disponibili.

Chiavi di condizione	Descrizione	Tipo
aws:ResourceTag/${TagKey}	Filtra le operazioni in base a coppie chiave-valore di tag collegate alla risorsa. La chiave di contesto del tag risorsa si applica solo alla risorsa cluster e non agli argomenti, ai gruppi e agli ID transazionali	Stringa