单向认证

最近更新时间:2025-11-14 11:28:52

我的收藏
单向认证由客户端认证服务端,客户端对服务端的认证通过服务端证书完成,服务端会使用您选择的证书和客户端建联。为了保证集群的安全,消息队列 MQTT 版提供了默认的服务端证书进行单向认证,如需要使用自有证书进行认证,可以参考本文指引绑定自定义证书。服务端证书需要由您自行购买或自行签发后,托管到 腾讯云 SSL 证书,再在 MQTT 控制台完成配置。

约束与限制

单集群内服务端证书的最大数量为3个。

配置自定义证书

步骤1:托管服务端证书

MQTT 支持加载托管在腾讯云 SSL 证书服务中的证书,请先在 SSL 证书控制台完成自签名证书托管或购买证书。具体步骤请参考 上传 SSL 证书指引SSL 证书购买流程

步骤2:开启单向认证

如您是第一次配置集群认证方式,MQTT 默认开启了单向认证,您可以跳过此步骤。如您之前使用的是双向认证或者一机一证认证方式,可以参考此步骤将认证方式切换回单向认证。
1. 登录 MQTT 控制台
2. 在左侧导航栏单击资源管理 > 集群管理,选择好地域后,单击要配置证书的集群的“ID”,进入集群基本信息页面。
3. 在基本信息页面选择认证管理,二级页签选择 X.509 证书管理,单击右侧的编辑图标


4. 在弹窗中设置认证方式为单向认证,单击提交,完成配置。

步骤3:绑定自定义证书

1. 登录 MQTT 控制台
2. 在左侧导航栏单击资源管理 > 集群管理,选择好地域后,单击目标集群的“ID”,进入集群基本信息页面。
3. 在集群详情页,选择服务端证书管理页签,单击左上角的绑定自定义证书
证书来源:选择 SSL 证书。
服务端证书:在下拉框中勾选托管到腾讯云的 SSL 证书。
4. 单击提交,完成绑定。

说明:
在默认服务端证书的基础上可配置多个自定义证书,当前服务端自定义证书的最大个数上限为3个。
集群支持在开启单向认证/双向认证时,使用多个服务端证书进行认证。

步骤4:配置自定义域名

添加证书后,为了保证客户端的正常连接,证书域名的 CNAME 配置需要进行如下对应修改。如您的域名维护在腾讯云上,您可以前往 云解析控制台 修改。
参数
填写说明
主机记录
填写使用证书的域名
记录类型
CNAME
记录值
如使用公网,填写 -。
如使用 VPC 内网,填写 mqtt-xxxx-nj-vpce-xxx.mqtt.tencenttdmq.com
MX 优先级
无需填写
TTL(秒)
建议保持为默认值600s
假设选择的服务端证书 Subject Alternative Name 包含以下域名:mqtt-abc.compay.com
参考 云解析-CNAME 记录,创建一个 CNAME 记录,将 mqtt-abc.compay.com 解析到集群的接入点提供的域名: mqtt-xxx-sh-public.mqtt.tencenttdmq.com,后续可以通过 mqtt-abc.company.com访问集群。

步骤5:配置 TLS 版本(可选)

若您的集群中部分设备或 SDK 因仅支持特定版本的 TLS 协议,导致与默认配置的服务端无法完成握手而连接失败时,可通过 TLS 协议版本配置的功能调整服务端所支持的 TLS 协议版本范围,使通信双方能够协商出一个共同认可的协议版本,从而解决因版本不匹配产生的兼容性问题,确保所有组件都能成功建立安全连接,保障集群通信的稳定性。
注意:
修改服务端支持的 TLS 协议版本配置后,将立即生效,影响集群下所有新连接/重新连接的客户端,请谨慎操作。
服务端默认支持TLS 1.0 至 TLS 1.3 的全部版本,如需修改可参考如下配置步骤:
1. 进入 集群管理 > 认证管理,二级页签选择 X.509 证书管理,单击 TLS 协议版本配置右侧的编辑图标

2. 在弹窗中选择支持的 TLS 版本范围。由于 TLS 协议仅支持开启连续版本或单一版本,因此修改配置方法如下:
​​若要启用连续版本​​(如 TLS 1.1 和 TLS 1.2):请先选择其中一个版本作为“最低版本”,再选择另一个版本作为“最高版本”,单击确定提交配置。
​​若要仅启用单个版本​​(如仅启用 TLS 1.2):请​​连续两次单击该版本​​,单击确定提交配置。


管理证书

禁用默认服务端证书

在绑定其他自定义证书后,可以禁用 TDMQ MQTT 版提供的默认服务端证书,具体步骤如下:
在服务端证书管理页面,单击默认服务端证书操作栏的禁用,在弹窗中确认后可以禁用默认证书。


解绑自定义证书

若您不再需要配置的自定义证书,可以将其解绑。解绑后,将无法通过证书对应的域名进行连接。