Codelabs

版本说明

本示例不涉及SDK示例代码。

概述

合作伙伴在加入经销商伙伴计划之后，使用加入经销商伙伴计划的账号登录华为云伙伴中心，在“服务支持 > 能力开放”页面完成基本信息、接口人信息、实名认证信息等相关配置。 基本配置完成之后，伙伴可选择继续完成 “配置伙伴平台回跳地址”，此为可选步骤，用于定制部分场景下客户的回跳地址。

基本配置

操作步骤

1.使用合作伙伴账号登录合作伙伴中心，在左侧导航栏中选择“服务支持 > 能力开放”。
2.单击流程图中的“接入配置”图标，进入“接入配置”页面。
3.参照表1进行相关配置，配置完成后单击“确定”。表1 接入配置参数说明

参数	描述
基本信息
IDP Metadata文件（即企业身份提供商元数据文件）	合作伙伴销售平台按照SAML协议标准生成的IDP Metadata.xml文件。<br>文件格式为xml，文件大小不超过2M。<br>如何生成IDP Metadata，请参见生成IDP Metadata.xml。
通知结果绑定地址	合作伙伴销售平台提供的用于通知其绑定结果的回调地址，建议使用https协议的地址。请参见绑定通知接口说明。
接口人信息	方便华为侧接口人联系合作伙伴。
实名认证附件上传	若合作伙伴的客户购买中国站的产品，需要实名认证，认证过程中合作伙伴需要把客户的实名认证附件上传给华为云审核。上传客户实名认证附件请参考如何上传客户实名认证附件(https://support.huaweicloud.com/api-bpconsole/appendix_00008.html)。
订阅文件	转售类伙伴可订阅“子客户用量明细级伙伴账单”，基于该账单，伙伴销售平台对客户进行批价，生成客户账单明细；同时伙伴可与华为云完成对账。转售类伙伴可订阅“客户用量明细”，基于该用量明细，伙伴可在伙伴销售平台查看名下所有客户或某个客户的用量明细；客户可在伙伴销售平台查看自己的用量明细。

绑定通知接口说明

若合作伙伴销售平台通过跳转到华为云页面的方式接入华为云，合作伙伴需要向华为侧提供用于华为云通知其绑定结果的回调接口，建议使用https协议的地址。

合作伙伴在定义和开发此接口时，请遵循如下约定。

1.URL POST https://www.xxx.com/bind
2.请求参数 请求参数使用Form Data形式。

表2 绑定通知接口请求参数说明

| 参数 | 描述 | 示例 | | :----:| :----:| :----:| |bindRequest|绑定信息的消息体（JSON结构），经过BASE64编码。JSON消息体中的参数说明请参见表3。|EYJKB21HAW5OYW1LIJOIEW9UZ3POASISIMRVBWFPBKLKIJOIEW9UZ3POAWLKIIWIEFVZZXJJZCI6INLVBMD6AGL4IIWIYMLUZEFJDGLVBII6MX0%3D| |SigAlg|签名使用的签名算法（华为默认使用SHA256算法进行签名）。HTTP://WWW.W3.ORG/2001/04/XMLDSIG-MORE#RSA-SHA256|HTTP%3A%2F%2FWWW.W3.ORG%2F2001%2F04%2FXMLDSIG-MORE%23RSA-SHA256| |Signature|签名值。通过签名机制来验证请求的发起方。 华为云发起请求时将请求中的bindRequest使用私钥签名得到签名值，接收方收到请求后通过华为云提供的公钥（SP Metadata.xml文件中<ds:X509Certificate></ds:X509Certificate>标签内的值）来验证签名值。 签名验证通过，则表明是华为云发送的请求可以进行后续操作，否则请求非法。|SWCFTCP4NKMU%2BOBH1FCSXFY0DL31BGNH4EXUGTQY%2BSPLXC%2B94NXSS%2FRHPWYE9TXVNVSPTR6XRWBZLVHTBDRGLGC0OPTTCFYD4D3%2F6PMESNG5C4BPT|

表3 bindRequest的JSON消息体参数说明

参数	参数类型	描述
xUserId	String	合作伙伴客户在合作伙伴销售平台的用户ID。
xAccountId	String	合作伙伴客户在合作伙伴销售平台的账号ID（客户唯一标示，建议和domainName名称一致）。
domainName	String	合作伙伴客户的华为云账号名，后续API调用会使用。
domainId	String	合作伙伴客户的华为云账号ID，后续API调用会使用。
userName	String	合作伙伴客户的华为云用户名。
userId	String	合作伙伴客户的华为云用户ID。
exporetime	String	请求的失效时间，格式为UTC时间。<br>示例：2017-07-31T07:40:14.004Z
bindAction	String	绑定结果。<br> 0：绑定 <br>1：解绑

说明：表3中有账号名和用户名、账号ID和用户ID的定义是因为华为云IAM有账号和用户的概念。关于两个概念的具体介绍请参见身份管理中“账号”和“IAM用户”的描述。

后续处理

配置完成后，如果有参数配置错误，可以对配置信息进行修改，具体操作如下：

1.在左侧导航栏中选择“服务支持 > 能力开放”。
2.单击流程图中的“接入配置”图标，或者单击“接入配置”图标下的“查看/修改接入配置”。进入“接入配置”页面
3.单击“修改配置”可以对配置信息进行修改。
- 如果IDP Metadata.xml文件配置错误，您可以先单击“下载Metadata文件”将原IDP Metadata.xml下载到本地修改保存后，再单击“修改配置”进行重新上传。

##配置伙伴平台回跳地址(可选) 接入配置完成后，伙伴可以在能力开放页面配置伙伴平台回跳地址，以便于客户在完成订单支付后能返回到伙伴销售平台或者客户支付订单需要充值时能从华为云跳到伙伴销售平台。

支付订单需要充值

如果客户支付订单时余额不足，则会在支付页面出现充值入口，默认在华为云平台完成充值。若伙伴配置“订单充值跳转地址”，则客户单击充值时，会跳转到伙伴配置的页面完成充值。

图4: 支付订单图例1

完成订单支付后查看订单详情

客户支付订单成功后，在订单支付成功页面会出现“查看订单详情”的链接，默认跳转至华为云订单详情页面。若伙伴配置了“订单支付成功跳转地址”，则客户在完成订单支付后，单击“查看订单详情”，可以返回到伙伴销售平台完成查看。

1.在左侧导航栏中选择“服务支持 > 能力开放”。
2.单击流程图中“接入配置”图标下的“配置伙伴平台回跳地址”。

图6: 平台回跳图例1

3.配置“订单支付成功跳转地址”和“订单充值跳转地址”后单击“确定”。
如果“订单支付成功跳转地址”或“订单充值跳转地址”配置错误，您可以进入“配置伙伴平台回跳地址”页面，单击右上角的“修改”，修改该配置。

图8: 平台回跳图例3

参考

更多信息请参考合作伙伴中心

修订记录

发布日期	文档版本	修订说明
2021-06-02	1.0.1	伙伴接入配置demo第一个版本发布