消息通知服务 SMN-HTTP(S)消息格式:操作场景

时间:2024-09-12 17:26:11

操作场景

  1. 接收 SMN 服务发送的HTTP(S)消息时,终端证书的CN名称请参考业界规范,部分特殊字符可能导致https消息发送失败。
  2. 在互联网上传递未加密的http协议消息内容存在信息泄漏风险,推荐用户终端添加订阅时对接通道优先使用https类型。

描述SMN服务向HTTP(S)终端发送消息的格式,您可以通过消息头部信息中的消息类型来区分消息格式。消息格式包括:HTTP(S)订阅确认消息的格式、HTTP(S)推送消息的格式和HTTP(S)取消订阅消息的格式三种消息格式,HTTP/HTTPS协议均为POST方式。

当SMN服务向HTTP(S)终端发送消息时,头部包括请求X-SMN-MESSAGE-TYPE,X-SMN-MESSAGE-ID,X-SMN-TOPIC-URN,如表1所示。

表1 消息HTTP(S)头部参数说明

参数

说明

X-SMN-MESSAGE-TYPE

消息类型,消息类型分别有:

  • SubscriptionConfirmation
  • Notification
  • UnsubscribeConfirmation

X-SMN-MESSAGE-ID

消息唯一标识。

X-SMN-TOPIC-URN

主题的唯一标识,表示消息归属的主题。

关于HTTP(S)头部字段的说明:

  • RFC 7230 章节3.2中规定,HTTP(S)头部的字段名称不区分大小写。
  • RFC 7540 章节8.1.2中规定,对于支持HTTP/2的服务端,头部字段信息需要统一改为全小写。
  • 对于用户自定义的HTTP(S)头部字段,SMN也将采用上述的处理策略。
  • 用户如果从HTTP(S)头部中获取相关字段,建议采用不区分大小写的方式。
support.huaweicloud.com/usermanual-smn/smn_ug_a9002.html