Kafka - Comment utiliser les listes de contrôle d'accès (ACL)
Découvrez comment accorder des permissions sur les topics et le Schema Registry à vos utilisateurs Kafka avec les listes de contrôle d'accès (ACL)
Objectif
Apache Kafka est une plateforme open source distribuée de streaming d'événements, conçue pour le traitement de données en temps réel et à grande échelle, avec une scalabilité et une durabilité élevées ainsi qu'une faible latence.
Un utilisateur Kafka n'a aucun accès à vos topics tant que vous ne lui en accordez pas avec une liste de contrôle d'accès (ACL). Ce guide explique comment créer des ACL de topic depuis la console OVHcloud ou l'API OVHcloud, et des ACL Schema Registry depuis l'API OVHcloud.
Prérequis
- Disposer d'un projet Public Cloud dans votre compte OVHcloud
- Disposer d'un service Kafka acceptant les connexions entrantes, avec au moins un utilisateur et un topic
- Disposer d'un accès à l'API OVHcloud (pour les étapes via l'API)
Accès à la console OVHcloud
- Lien direct :
- Pour accéder à vos services :
Public Cloud> Sélectionnez votre projet >Analytics
En pratique
Accès par défaut
À la création de votre service, l'utilisateur admin préconfiguré avnadmin dispose de la permission admin sur tous les topics (*) et peut écrire dans le Schema Registry une fois celui-ci activé.
Tout utilisateur que vous créez ensuite n'a aucun accès. Tant que vous n'ajoutez pas d'ACL pour cet utilisateur, la production ou la consommation de messages sur un topic échoue avec l'erreur TOPIC_AUTHORIZATION_FAILED.
Nous vous recommandons de créer un utilisateur par application et de ne lui accorder que les topics et la permission dont elle a besoin.
Permissions
Pour un utilisateur et un topic (ou tous les topics avec *), vous pouvez accorder l'une des permissions suivantes :
- admin : accès complet au topic, y compris sa gestion
- read : consommer les messages du topic
- write : produire des messages dans le topic
- readwrite : produire et consommer des messages
La liste des permissions disponibles sur votre service est également renvoyée par l'API :
Configurer les ACL de topic
Dans l'onglet ACL, cliquez sur le bouton Ajouter une ACL.
Dans le panneau Ajouter une ACL, sélectionnez le Nom d'utilisateur, saisissez le nom du Topic (ou * pour tous les topics), choisissez la Permission (Administration, Lecture, Écriture ou Lecture et écriture), puis cliquez sur Créer.
Configurer les ACL Schema Registry avec l'API
Une fois le Schema Registry activé, un utilisateur a également besoin d'une ACL Schema Registry pour lire ou enregistrer des schémas.
Deux permissions sont disponibles :
- schema_registry_read : lire les schémas
- schema_registry_write : lire et enregistrer des schémas
La ressource est :
Subject:<nom du subject>, par exempleSubject:orders-value, ouSubject:*pour tous les subjects ;Config:, pour la configuration globale de compatibilité du Schema Registry.
Par défaut, avnadmin dispose de la permission schema_registry_write sur Config: et sur Subject:*.
Créez une ACL Schema Registry :
Avec cette ACL, app-orders peut enregistrer des schémas pour le subject orders-value. Le Schema Registry se comporte ainsi pour tout utilisateur :
- sans aucune ACL Schema Registry, chaque requête renvoie
401 Unauthorized; - un subject non couvert par ses ACL est signalé comme introuvable (
404).
Listez et supprimez les ACL Schema Registry :
Aller plus loin
Kafka - Comment activer le Schema Registry
Kafka - Comment activer l'API REST
Votre avis nous intéresse !
Nous serions ravis de répondre à vos questions et apprécions tout retour que vous pourriez nous faire.
Pour une formation ou une assistance technique sur la mise en œuvre de nos solutions, contactez votre commercial ou consultez la page Professional Services pour obtenir un devis et faire analyser votre projet par nos experts.
Vous êtes sur Discord ? Rejoignez notre chaîne via https://discord.gg/ovhcloud et interagissez directement avec l’équipe qui développe notre service Analytics !
Rejoignez notre communauté d'utilisateurs.