On this page

Show all

Help Center/ MapReduce Service/ Component Operation Guide (LTS)/ Using ZooKeeper/ Configuring the ZooKeeper Permissions

Configuring the ZooKeeper Permissions

Updated on 2023-04-28 GMT+08:00

View PDF

Scenario

Configure znode permission of ZooKeeper.

ZooKeeper uses an access control list (ACL) to implement znode access control. The ZooKeeper client specifies a znode ACL, and the ZooKeeper server determines whether a client that requests for a znode has related operation permission according to the ACL. ACL configuration involves the following four operations:

Check znode ACLs in ZooKeeper.
Add znode ACLs to ZooKeeper.
Modify znode ACLs in ZooKeeper.
Delete znode ACLs from ZooKeeper.
The ZooKeeper ACL permission is described as follows:

ZooKeeper supports five types of permission, create, delete, read, write, and admin. ZooKeeper permission control is of a znode level. That is, the permission configuration for a parent znode is not inherited by its child znodes. The ZooKeeper znode default permission is world:anyone: cdrwa. That is, any user has all permissions.

NOTE:

ACL has three parts:

The first part is the authentication type. For example, world indicates all authentication types and sasl indicates the kerberos authentication type.

The second part is the account. For example, anyone indicates any user.

The third part is permission. For example, cdrwa indicates all permissions.

In particular, because starting the client in common mode does not need authentication, ACL with sasl authentication type cannot be used in common mode. Authentications of sasl scheme in this document are performed in clusters that have the security mode enabled.

**Table 1** Five types of ZooKeeper ACLs
Permission Description	Permission Name	Permission Details
Create permission	create(c)	Users with this permission can create child znodes in the current znode.
Delete permission	delete(d)	Users with this permission can delete the current znode.
Read permission	read(r)	Users with this permission can obtain data of the current znode and list all the child znodes of the current znode.
Write permission	write(w)	Users with this permission can write data to the current znode and its child znodes.
Administration permission	admin(a)	Users with this permission can set permission for the current znode.

Impact on the System

NOTICE:

Modifying ZooKeeper ACLs is a critical operation. If znode permission is modified in ZooKeeper, other users may have no permission to access the znode and some system functions are abnormal. In 3.5.6 and later versions, users must have the read permission for the getAcl operation.

Prerequisites

The ZooKeeper client has been installed in a directory, for example, /opt/client.
You have obtained the username and password of an MRS cluster administrator.

Procedure

Start the ZooKeeper client.

Log in to the server where the ZooKeeper client is installed as user root.
Run the following command to go to the client installation directory:

cd /opt/client
Run the following command to configure environment variables:

source bigdata_env
Run the following command and enter the user password to authenticate the user's identity (This step is required only for clusters in security mode, and user userA is provided as an example of an authorized user.):

kinit userA
On the ZooKeeper client, run the following command to go to the ZooKeeper command-line interface (CLI):

sh zkCli.sh -server ZooKeeper plane IP address of any instance:clientPort

The default clientPort is 2181.

Example: sh zkCli.sh -server 192.168.0.151:2181
Run the ls command to view the znode list in ZooKeeper. For example, you can view the list of znodes in the root directory.

ls /
```
[zk: 192.168.0.151:2181(CONNECTED) 1] ls /
[hadoop-flag, hadoop-ha, test, test2, test3, test4, test5, test6, zookeeper]
```

View the ZooKeeper znode ACL.

Start the ZooKeeper client.
Run the getAcl command to view znodes. The following command can be used to view the created znode ACL named test:

getAcl /znode name
```
[zk: 192.168.0.151:2181(CONNECTED) 2] getAcl /test
'world,'anyone
: cdrwa
```

Add a ZooKeeper znode ACL.

Start the ZooKeeper client.
View the old ACL information to check whether the current account has the permission to modify the znode ACL information (a permission). If no, use kinit to switch to a user that has the permission and restart the ZooKeeper client.
getAcl /znode name
```
 [zk: 192.168.0.151:2181(CONNECTED) 3] getAcl /test
'world,'anyone
: cdrwa
```
Run the setAcl command to add an ACL. The command for adding an ACL is as follows:

setAcl /test world:anyone:cdrwa,sasl: username@: <system domain name>:ACL value

For example, to create the ACL of user admin to the test znode, run the following command:

setAcl /test world:anyone:cdrwa,sasl:userA@HADOOP.COM:cdrwa
NOTE:
When adding a new ACL, reserve the existing ones. The new and old ACLs are separated by a comma. The newly added ACL has three parts:
- The first part is the authentication type. For example, sasl indicates kerberos authentication.
- The second part is the account. For example, userA@HADOOP.COM indicates user userA.
- The third part is permission. For example, cdrwa indicates all permissions.

After adding the ACL, run the getAcl command to check whether the permission is added successfully:

getAcl /znode name

[zk: 192.168.0.151:2181(CONNECTED) 4] getAcl /test 
'world,'anyone
: cdrwa
'sasl,'userA@<System domain name>
: cdrwa

Modify the ZooKeeper znode ACL.

Start the ZooKeeper client.
View the old ACL information to check whether the current account has the permission to modify the znode ACL information (a permission). If no, use kinit to switch to a user that has the permission and restart the ZooKeeper client.

getAcl /znode name
```
[zk: 192.168.0.151:2181(CONNECTED) 5] getAcl /test 
'world,'anyone
: cdrwa
'sasl,'userA@<System domain name>
: cdrwa
```
Run the setAcl command to modify an ACL. The command for adding an ACL is as follows:

setAcl /test sasl:Username@<System domain name>:ACL value

For example, to reserve all permissions of user userA and delete the rw permission of user anyone, run the following command:

setAcl /test sasl:userA@HADOOP.COM:cdrwa
After modifying the ACL, run the getAcl command to check whether the permission is modified successfully:

getAcl /znode name
```
[zk: 192.168.0.151:2181(CONNECTED) 6] getAcl /test 
'sasl,'userA@<System domain name>
: cdrwa
```

Delete the ZooKeeper znode ACL.

Start the ZooKeeper client.
View the old ACL information to check whether the current account has the permission to modify the znode ACL information (a permission). If no, use kinit to switch to a user that has the permission and restart the ZooKeeper client.

getAcl /znode name
```
[zk: 192.168.0.151:2181(CONNECTED) 5] getAcl /test 
'world,'anyone
: rw
'sasl,'userA@<System domain name>
: cdrwa
```
Run the setAcl command to add an ACL. The command for adding an ACL is as follows:

setAcl /test sasl:Username@<System domain name>:ACL value

For example, to reserve all permissions of user userA and delete the rw permission of user anyone, run the following command:

setAcl /test sasl:userA@HADOOP.COM:cdrwa
After modifying the ACL, run the getAcl command to check whether the permission is modified successfully:

getAcl /znode name
```
[zk: 192.168.0.151:2181(CONNECTED) 6] getAcl /test
'sasl,'userA@<System domain name>
: cdrwa
```

Parent topic: Using ZooKeeper

Previous topic: Using ZooKeeper from Scratch

Next topic: ZooKeeper Common Configuration Parameters

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot