目录

公共说明

接口协议:HTTPS

响应协议接口数据格式:JSON

协议接口数据字符编码:UTF-8

(可选)签名算法

如果您想增强服务端的安全能力,可使用IAP提供的安全能力,在相关接口中传入SHA256WithRSA/PSS签名算法。建议您使用SHA256WithRSA/PSS签名算法。

使用方式如下:

  1. 请求头HW-IAP-APPINFO为JSON格式的字符串。
  2. 请求头HW-IAP-APPINFO中的signatureAlgorithm仅支持传递SHA256WithRSA/PSS。

站点信息

服务

站点信息

Order

中国站点:https://orders-drcn.iap.cloud.huawei.com.cn

德国站点:https://orders-dre.iap.cloud.huawei.eu

新加坡站点:https://orders-dra.iap.cloud.huawei.asia

俄罗斯站点:https://orders-drru.iap.cloud.huawei.ru

Subscription

中国站点:https://subscr-drcn.iap.cloud.huawei.com.cn

德国站点:https://subscr-dre.iap.cloud.huawei.eu

新加坡站点:https://subscr-dra.iap.cloud.huawei.asia

俄罗斯站点:https://subscr-drru.iap.cloud.huawei.ru

加密套件:

TLS版本

加密套件(IANA名称)

备注

TLS 1.3

TLS_AES_128_GCM_SHA256

TLS_AES_256_GCM_SHA384

TLS_CHACHA20_POLY1305_SHA256

俄罗斯站点暂不支持TLS 1.3,当前请使用TLS 1.2,后续会逐步支持。

TLS 1.2

TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384

TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256

TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384

TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256

  
  1. TLS 1.2以下版本和CBC加密套件存在安全风险(如CVE-2012-1870、CWE-326、CVE-2011-3389),为了您的业务安全和功能持续正常运作,请务必使用TLS 1.2及以上版本,同时,在使用HTTP客户端进行访问时,务必使用表格中规定的特定加密套件。
  2. 当前部分域名实际支持的TLS版本和加密套件比上述要求更广泛,出于安全考虑,将于2023年4月全面清理低于1.2的TLS版本和规定之外的加密套件支持,请按照要求进行配置,否则届时可能会导致访问出现异常。
  3. 请注意加密套件在不同的依赖库(OpenSSL、GnuTLS等)中可能存在对应的不同名称,请对应选择

站点选择

您需要在四个站点信息中选择一个(中国、德国、新加坡和俄罗斯),关于这四个站点的选择,有以下两点建议:

  1. 建议您根据您的服务器部署所在地就近选择站点以便更快获取订单信息,例如:

    如果您的服务器在中国大陆,建议您优先访问中国站点域名。

    如果您的服务器在亚洲、非洲或者拉丁美洲,建议您优先访问新加坡站点域名。

    如果您的服务器在俄罗斯,建议您优先访问俄罗斯站点域名。

    如果您的服务器在欧洲和北美洲,建议您优先访问德国站点域名。

  2. 本质上选择任一站点都可以,华为服务器会进行站点间路由,请确保请求以application/json进行发送。

证书校验

如果服务端的证书未经验证或被篡改,客户端连接到的服务端可能不是预期的服务端,会导致中间人攻击、数据泄漏等安全问题。为保障连接安全,您的服务器在访问华为IAP服务器时,必须验证华为IAP服务器提供的证书。

验证包含两部分,首先是验证华为IAP服务器提供证书是否来自值得信任的来源,然后验证华为IAP服务器是否提供正确的证书。