文档中心

消息队列 RocketMQ版

权限管理

ACL 用户管理

消息队列 RocketMQ 5.x 提供权限管理功能，支持创建 ACL 用户并配置细粒度访问规则，精准控制不同身份对 Topic 或 Group 的操作权限。本文介绍如何管理 ACL 用户。

使用限制

新建的 5.x 版本实例默认支持权限管理功能。若您的存量实例暂不支持，请参见密钥管理配置相关权限。

前提条件

已创建 5.x 版本实例。具体操作，请参见创建实例。

新增 ACL 用户

操作步骤

登录消息队列 RocketMQ版控制台。

在顶部菜单栏，选择实例所在的地域。

在左侧导航栏，选择实例列表。

在实例列表页面，单击目标实例操作列的权限管理。

说明

您也可以单击目标实例的名称，在实例详情页面选择权限管理页签。

在权限管理页签下，选择 ACL 用户页签。

单击新增用户，在新增用户对话框中设置以下参数。

参数	说明
ACL 用户名	设置 ACL 用户名称。命名规范如下：必须以字母开头。仅支持字母、数字、下划线（_）或短划线（-）。长度必须为 3~64 个字符。
密码	设置 ACL 用户的密码。长度必须为 3~64 个字符。
确认密码	再次输入 ACL 用户的密码。

单击确定。

批量导入 ACL 用户

您可以按照模板填写配置并上传文件，系统将自动解析并创建 ACL 用户。

操作步骤

登录消息队列 RocketMQ版控制台。

在顶部菜单栏，选择实例所在的地域。

在左侧导航栏，选择实例列表。

在实例列表页面，单击目标实例操作列的权限管理。

说明

您也可以单击目标实例的名称，在实例详情页面选择权限管理页签。

在权限管理页签下，选择 ACL 用户页签。

单击批量导入 ACL 用户，在批量导入 ACL 用户对话框中单击点击下载模板。

打开下载的 CSV 模板文件，按照表格中的要求填写相关信息，文件限制说明如下：

仅支持 CSV 格式。

文件大小不超过 10 MB。

单次导入的用户信息不超过 100 条。

填写完成后，您可以通过以下两种方式上传 CSV 文件。

单击对话框的指定区域上传文件。

将文件拖拽至指定区域上传。

文件数据校验通过后，单击创建导入任务。

查看或编辑 ACL 用户信息

操作步骤

登录消息队列 RocketMQ版控制台。

在顶部菜单栏，选择实例所在的地域。

在左侧导航栏，选择实例列表。

在实例列表页面，单击目标实例操作列的权限管理。

说明

您也可以单击目标实例的名称，在实例详情页面选择权限管理页签。

在权限管理页签下，选择 ACL 用户页签。

在 ACL 用户列表，查看或编辑 ACL 用户信息，具体说明如下：

参数	说明
ACL 用户名	ACL 用户的名称。说明您可以单击名称后的复制图标，复制 ACL 用户名称。
状态	ACL 用户的状态。已启用：该 ACL 用户的身份识别与权限配置生效中。已禁用：该 ACL 用户的身份识别与权限配置未生效。
密码	ACL 用户的密码。说明单击密码后的显示/隐藏图标，可切换密码的可见状态。单击密码后的编辑图标，可以在修改密码对话框中修改密码。
操作	您可以禁用、开启或删除 ACL 用户。禁用：禁用后该用户身份认证失效，后续消息请求将被拒绝连接。启用：恢复该用户的身份认证与权限配置，使其重新生效。删除：删除该 ACL 用户，删除后立即生效且数据不可恢复。

最近更新时间：2026.08.19 14:46:04

这个页面对您有帮助吗？

有用

无用