Learn how to restrict access to Kafka metadata in Zookeeper.
Locking down Kafka znodes (metadata) in Zookeeper can be used to protect Kafka metadata
against unauthorized access. Direct manipulation of metadata in Zookeeper is not only
dangerous for the health of the cluster, but can also serve as an entry point for malicious
users to gain elevated. Access to Kafka metadata in Zookeeper is restricted by default.
Follow these steps if you have previously unlocked access, but want to re-enable access
restrictions.
A secure Kafka cluster with Kerberos authentication enabled is required.
Enable the use of secure ACLs:
This can be achieved by setting the
zookeeper.set.acl configuration parameter to true.
In Cloudera Manager select the Kafka service.
Select Configuration.
Find the Enable Zookeeper ACL
property.
Set the property to true by selecting the checkbox next to the name of the
role group.
Perform a Rolling Restart:
Return to the Home page by clicking the Cloudera Manager
logo.
Check the Restart roles with stale configurations
only checkbox and click Rolling
restart.
Click Close when the restart has
finished.
Pass the JAAS configuration file location as a JVM parameter through a command line
interface.
You can do this by setting the value of the KAFKA_OPTS environment
variable to
-Djava.security.auth.login.config=[PATH_TO_JAAS.CONF].
Replace [ZOOKEEPER_KAFKA_CHROOT] with the value of the
zookeeper.chroot property. To view the value of the property, in
Cloudera Manager go to Kafka > Configuration and search for zookeeper.chroot.
The tool traverses the corresponding sub-trees changing the ACLs of the znodes.
Reset the ACLs on the root node to allow full access:
Resetting the ACLS on the root node is required because the
zookeeper-security-migration tool also changes the ACLs on the root
znode. This leads to the failure of the Zookeeper canary tests, which subsequently makes
the service display as unhealthy in Cloudera Manager.
Change the JVMFLAGS environment variable to
-Djava.security.auth.login.config=[PATH_TO_JAAS.CONF].
Enter the following to reset the ACLs of the root node.
setAcl / world:anyone:crdwa
Verify znode permissions.
You can do this with the getAcl ZooKeeper CLI command. For
example.
getAcl [ZK NODE PATH]
If
everything is set up correctly, running this command on the /kafka znode
(default chroot for Kafka) should return the following
permissions.
'sasl,'kafka
: cdrwa
'world,'anyone
: r
Kafka metadata in Zookeeper is restricted via ACLS. Administrative operations,
for example topic creation, deletion, any configuration changes and so on, can only be
performed by authorized users.