tencent cloud

消息队列 MQTT 版

动态与公告
新功能发布记录
产品简介
TDMQ 产品系列介绍与选型
什么是消息队列 MQTT 版
应用场景
技术架构
产品系列
MQTT 协议兼容说明
开源对比
高可用
产品约束与使用配额
基本概念
开服地域
购买指南
计费概述
续费说明
查看消费明细
欠费说明
退费说明
快速入门
入门流程指引
准备工作
公网接入
VPC 网络接入
用户指南
使用流程指引
配置账号权限
新建集群
管理 Topic
连接集群
查询消息
管理客户端
管理集群
查看监控和配置告警
数据集成
集成数据到云函数 SCF
集成数据到 CKafka
集成数据到 RocketMQ
开发指南
MQTT 5 高级特性
数据面 HTTP 接口说明
配置自定义域名
配置 SQL 过滤
配置点对点订阅
MQTT over QUIC
管理客户端订阅
消息增强规则
实践教程
MQTT 客户端开发注意事项
可观测能力
Topic 与通配符订阅
API 参考
History
Introduction
API Category
Making API Requests
Cluster APIs
Topic APIs
Authorization Policy APIs
User APIs
Client APIs
Message Enhancement Rule APIs
Message APIs
Data Types
Error Codes
SDK 参考
接入点格式
Java SDK
C SDK
Javascript/Node.JS/小程序
Go SDK
iOS SDK
JavaScript SDK
Dart SDK
Python SDK
.NET
安全与合规
权限管理
常见问题
相关协议
隐私协议
数据处理和安全协议
消息队列 MQTT 版服务等级协议
联系我们

使用用户名和密码认证

PDF
聚焦模式
字号
最后更新时间: 2026-01-30 15:10:01
用户名和密码认证是 TDMQ MQTT 版最基础的认证方式,客户端在连接时提供用户名(Username)和密码(Password),MQTT 将其与内部存储的凭证进行匹配,匹配通过后接受客户端请求。

前提条件

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

新建用户

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



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

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




配置权限

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

删除用户

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


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈