Ajouter une entrée de LCA à une LCA Managed Kafka

Ce document explique comment créer une entrée LCA et l'ajouter à une ressource LCA Managed Kafka. Si la ressource LCA Managed Kafka n'existe pas, cette opération la crée également.

Cette opération est analogue à la création d'une liaison unique de LCA Apache Kafka. Contrairement à l'opération d'update, elle ne nécessite pas d'ETag pour le contrôle de la simultanéité.

Rôles et autorisations nécessaires

Pour obtenir l'autorisation nécessaire pour ajouter une entrée LCA, demandez à votre administrateur de vous accorder le rôle IAM Éditeur de LCA Kafka géré (roles/managedkafka.aclEditor) sur votre projet. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Ce rôle prédéfini contient l'autorisation managedkafka.acls.updateEntries, qui est requise pour ajouter une entrée ACL.

Vous pouvez également obtenir cette autorisation avec des rôles personnalisés ou d'autres rôles prédéfinis.

Ajouter une entrée LCA

Console

  1. Dans la console Google Cloud , accédez à la page Clusters.

    accéder aux clusters

  2. Cliquez sur le nom du cluster auquel vous souhaitez ajouter une entrée de LCA.

  3. Cliquez sur l'onglet Contrôle des accès.

  4. Cliquez sur Créer une entrée LCA.

  5. Dans le panneau Créer une entrée LCA, saisissez les détails de l'entrée LCA :

    1. Dans la liste Type de ressource, sélectionnez le type de ressource de cluster auquel s'applique cette ACL. Pour en savoir plus, consultez ID de la LCA.

    2. Si le type de ressource est Topic, Consumer group ou Transactional ID, sélectionnez ou saisissez l'ID de la ressource.

    3. Si le type de ressource est Topic prefix, Consumer group prefix ou Transactional ID prefix, saisissez le préfixe auquel la LCA doit correspondre.

    4. Dans le champ Principal, saisissez le principal pour l'entrée ACL.

    5. Dans la liste Type d'autorisation, sélectionnez ALLOW ou DENY.

    6. Dans la liste Opération, sélectionnez le type d'opération pour l'entrée ACL.

  6. Cliquez sur Créer.

gcloud

Exécutez la commande 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=*

Remplacez les éléments suivants :

  • ACL_ID : ID de la ressource LCA Managed Kafka à mettre à jour. Pour en savoir plus, consultez ID de la LCA. Si un LCA Managed Kafka avec cet ID n'existe pas, il est créé automatiquement.

  • CLUSTER_ID : ID de votre cluster Kafka.

  • LOCATION : région de votre cluster Kafka.

  • PRINCIPAL : principal de la nouvelle entrée LCA.

  • OPERATION : type d'opération, tel que READ ou CREATE.

  • PERMISSION_TYPE : autorisation dont dispose le compte principal pour l'opération. Indiquez ALLOW ou DENY.

Exemple de commande

Exécutez la commande suivante pour autoriser un compte de service spécifique à lire un sujet nommé test-topic dans le cluster test-cluster de la région 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='*'

Voici un exemple de résultat :

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

Le résultat de la commande add-acl-entry fournit des informations sur l'état de la LCA :

  • acl : cette section décrit la ressource LCA mise à jour après l'ajout de la nouvelle entrée.

    • aclEntries : liste contenant toutes les entrées de contrôle des accès pour cette LCA. Dans cet exemple, il inclurait désormais l'entrée qui vient d'être ajoutée. Chaque entrée comporte les champs suivants :

      • host : hôte de l'entrée LCA.
      • operation : opération Kafka à laquelle s'applique cette entrée.
      • permissionType : indique si l'accès est ALLOW ou DENY.
      • principal : compte d'utilisateur ou de service auquel cette entrée est associée.
    • etag : il s'agit de l'étiquette d'entité pour la LCA mise à jour. Il est utilisé pour le contrôle de simultanéité optimiste lors des mises à jour ultérieures. La valeur change après l'ajout d'une entrée.

    • name : identifiant unique de la ressource LCA. Il suit le format projects/{project}/locations/{location}/clusters/{cluster}/acls/{acl_id}.

    • patternType : type de modèle de ressource pour cette LCA.

    • resourceName : nom de la ressource Kafka à laquelle s'applique cette ACL.

    • resourceType : type de ressource Kafka.

  • aclCreated : valeur booléenne indiquant si la ressource LCA a été créée suite à l'ajout de cette entrée.

Étapes suivantes

Apache Kafka® est une marque déposée d'Apache Software Foundation ou de ses sociétés affiliées aux États-Unis et/ou dans d'autres pays.