使用用户名和密码认证

最近更新时间:2025-09-22 10:39:42

我的收藏
用户名和密码认证是 TDMQ MQTT 版最基础的认证方式,客户端在连接时提供用户名(Username)和密码(Password),MQTT 将其与内部存储的凭证进行匹配,匹配通过后接受客户端请求。

前提条件

已创建 MQTT 集群。具体步骤请参考新建集群

新建用户

1. 登录 MQTT 控制台
2. 在左侧导航栏单击资源管理 > 集群管理,选择好地域后,单击目标集群的“ID”,进入集群基本信息页面。
3. 在集群详情页,选择认证管理,进入用户名和密码页签。
4. 单击新建用户,填写用户名和说明,设置密码。用户名(username)和密码(password)是 MQTT 提供的最基本的认证方式,后续使用客户端收发消息时需要填写。
用户名:设置用户名称,需符合命名规则,最长为32个字符,支持数字、大小写字母和分隔符("_","-")。
设置密码:设置用户密码,支持系统自动生成密码或者自定义设置密码。密码最长64个字符,支持数字、大小写字母、分隔符("_","-")。
说明(选填):不能超过128个字符。



5. 单击保存,完成用户创建,后续在用户列表中,可以通过以下任一种方式复制用户名和密码。
注意:
密码泄露很可能导致您的数据泄露,请妥善保管您的密码。
方式一:密钥列复制
方式二:操作列查看并复制
在用户名(Username)、密码(Password)列复制。

单击操作列的查看密码,在查看密码弹框中点击查看图标后单击复制图标。




配置权限

在创建完成用户后,需要为创建好的用户授予生产消息和消费消息的权限。
在未开启授权策略时,数据面资源暂无权限管理,可以使用任意“用户名+密码”进行连接、生产和消费等操作。生产环境建议根据最小权限原则进行精细的权限控制。具体介绍和操作步骤请参考 配置数据面授权

删除用户

注意:
用户一旦被删除,其用户名和密码将立即失效,任何依赖此凭证的消息生产与消费行为都将中止。请在操作前确认相关任务已停止或已配置新的用户名和密码。
当您不再需要某用户时,可以在控制台中将其删除。具体操作步骤如下:
在用户列表页面,单击操作栏的删除,在弹窗中二次确认删除后,即可删除用户。