|
| 1 | +--- |
| 2 | +title: Kafka - How to use Access Control Lists (ACLs) |
| 3 | +excerpt: Learn how to configure Access Control Lists (ACLs) |
| 4 | +updated: 2025-08-19 |
| 5 | +--- |
| 6 | + |
| 7 | +## Objective |
| 8 | + |
| 9 | +Apache Kafka is an open-source, distributed event streaming platform designed for real-time, large-scale data processing with high scalability, durability, and low latency. |
| 10 | + |
| 11 | +This guide explains how to configure Access Control Lists (ACLs) via the OVHcloud Control Panel. |
| 12 | + |
| 13 | +## Requirements |
| 14 | + |
| 15 | +- access to the [OVHcloud Control Panel](/links/manager) |
| 16 | +- a [Public Cloud project](/links/public-cloud/public-cloud) in your OVHcloud account |
| 17 | +- a [Kafka cluster running](/pages/public_cloud/data_analytics/analytics/kafka_create_cluster) on OVHcloud Public Cloud [accepting incoming connections](/pages/public_cloud/data_analytics/analytics/kafka_incoming_connections) with at least one [topic](/pages/public_cloud/data_analytics/analytics/kafka_create_topics) |
| 18 | + |
| 19 | +## Instructions |
| 20 | + |
| 21 | +### Configure ACLs on topics |
| 22 | + |
| 23 | +Kafka supports access control lists (ACLs) to manage permissions on topics. This approach allows you to limit the operations that are available to specific connections and to restrict access to certain data sets, which improves the security of your data. |
| 24 | + |
| 25 | +By default the admin user has access to all topics with admin privileges. You can define some additional ACLs for all users / topics, by clicking on the `Add an ACL`{.action} button from the `ACL`{.action} tab: |
| 26 | + |
| 27 | +{.thumbnail} |
| 28 | + |
| 29 | +For a particular user, and one topic (or all with '*'), define the ACL with the following permissions: |
| 30 | + |
| 31 | +- **admin**: full access to APIs and topic |
| 32 | +- **read**: allow only searching and retrieving data from a topic |
| 33 | +- **write**: allow updating, adding, and deleting data from a topic |
| 34 | +- **readwrite**: full access to the topic |
| 35 | + |
| 36 | +{.thumbnail} |
| 37 | + |
| 38 | +*Note*: Write permission allows the service user to create new indexes that match the pattern, but it does not allow deletion of those indexes. |
| 39 | + |
| 40 | +When multiple rules match, they are applied in the order listed above. If no rules match, access is denied. |
| 41 | + |
| 42 | +## We want your feedback! |
| 43 | + |
| 44 | +We would love to help answer questions and appreciate any feedback you may have. |
| 45 | + |
| 46 | +If you need training or technical assistance to implement our solutions, contact your sales representative or click on [this link](/links/professional-services) to get a quote and ask our Professional Services experts for a custom analysis of your project. |
| 47 | + |
| 48 | +Are you on Discord? Connect to our channel at <https://discord.gg/ovhcloud> and interact directly with the team that builds our Analytics service! |
| 49 | + |
| 50 | +Join our [community of users](/links/community). |
0 commit comments