管理归因角色
======

应用生态伙伴通过应用归因服务云端管理台注册归因角色及配置信息，包括：角色、名称、回传地址（用于接收归因结果回传的URL）、公钥。注册成功后平台生成归因角色ID。

注册归因角色前需生成用于签名/验签的密钥对。

#### 开通权限

注册归因角色前，需开通应用市场服务权限。当前功能为定向邀请功能，如果您有意向请通过客服邮箱**developer@huawei.com**进行邮件申请。

请提供如下信息进行申请，我们会在1~2个工作日内回复申请结果，请您留意邮箱消息。

**邮件模板如下：**

**邮件主题**：AppGallery Kit应用归因服务的权限申请

**邮件内容**：

开发者ID：\*\*\*\*\*\*

开发者名称：\*\*\*\*\*\*

应用ID：\*\*\*\*\*\*

应用名称：\*\*\*\*\*\*

申请原因：\*\*\*\*\*\*\*

#### 生成密钥对

可参考HarmonyOS[提供的API](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/js-apis-cryptoframework#cryptoframeworkcreatesign)生成用于签名/验签的密钥对，或者自行选取方法生成（推荐[使用JavaScript的库线下生成](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/payment-certificates-config#生成商户证书)）。

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/ca/v3/kHeZLEc9ToC5mkQjS3BnNg/caution_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073555Z&HW-CC-Expire=86400&HW-CC-Sign=0CBB7240AE6976AC98BE7C08BBF5CACDD4B8C872F5057FA57D4694CD0A18FC53)

请使用签名算法SHA256withRSA/PSS，生成密钥位数大于3072的密钥对。

生成的私钥用于生成签名，建议自行妥善保管；生成的公钥需要在注册角色时，提供给应用归因服务，请确保签名的私钥和注册角色时的公钥是成对生成的，以确保验签成功。

#### 注册归因角色

1.  登录[华为开发者联盟网站](https://developer.huawei.com/consumer/cn/)。
    
2.  通过点击“管理中心”进入生态服务中心。
    
3.  点击“生态服务 > 应用服务 > 开发服务”下的“应用市场服务”卡片，进入应用归因云端管理台。
    
4.  点击右上角“去注册”，进入“归因注册”信息填写页面。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/9/v3/eq_c_v0xRB6JxyUwNrEtWw/zh-cn_image_0000002594669072.png?HW-CC-KV=V1&HW-CC-Date=20260612T073555Z&HW-CC-Expire=86400&HW-CC-Sign=18813A6D4E0EA571E9782B7AF0EF164733CA669E257F556E45248498D7FD3B00)
    
    参数填写说明如下：
    
    | 参数 | 填写说明 |
    | :-- | :-- |
    | 角色 | 选择应用生态伙伴的角色，角色包括：分发平台、监测平台、开发者。 |
    | 名称 | 填写分发平台、监测平台或开发者的名称。 |
    | 公钥 | 填写已[生成密钥对](#生成密钥对)中的公钥。应用生态伙伴按照[生成签名方法](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-attribution-appendix-triger#生成签名方法)生成签名时，使用该公钥对应的私钥并遵照应用归因服务定义的[归因来源签名计算规则](https://developer.huawei.com/consumer/cn/doc/harmonyos-guides/appgallery-attribution-appendix-triger#归因来源签名计算规则)，应用归因平台使用该公钥对签名值做验签。 |
    | 回传地址 | 填写用于接收华为应用归因回传归因结果的URL，推荐使用HTTPS协议。 |
    
5.  注册信息填写完毕后，点击“提交”，生成一条状态是“新建待审核”的注册信息，后台运营人员进行审核，审核生效后，完成注册。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/65/v3/90gmVQ9YSwajjwuv65lXZA/zh-cn_image_0000002594829000.png?HW-CC-KV=V1&HW-CC-Date=20260612T073555Z&HW-CC-Expire=86400&HW-CC-Sign=F434630B20CFEBE48ECA3E08E38301ECCA9F50821C09EBCDC870B1E9A1850F9A)
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d0/v3/vnWJ_GY1TPi1vvLSaKxYHw/note_3.0-zh-cn.png?HW-CC-KV=V1&HW-CC-Date=20260612T073555Z&HW-CC-Expire=86400&HW-CC-Sign=29AE3664DFCB46DAFECFD4F5D65B411CCC0EADD5514FBB8751A4B2143838887F)
    
    状态为新建待审核，表示未完成注册。不能编辑、删除该条注册信息。
    
    状态为生效，表示完成注册。之后编辑、删除该条注册信息均无需运营人员审核。
    
    状态为驳回，表示未完成注册。编辑该条注册信息，需要重新提交运营人员审核；删除该条注册信息，无需审核。
    
6.  注册成功后，平台生成合作伙伴唯一标识（归因角色ID，用于归因过程中，标识相应的归因角色），在注册列表页展示已注册的信息。
    
    ![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/b9/v3/sAr1ZExUQ5ecsvPgNpaTtg/zh-cn_image_0000002625188447.png?HW-CC-KV=V1&HW-CC-Date=20260612T073555Z&HW-CC-Expire=86400&HW-CC-Sign=2D3DB1D08F37FB6A580B8B00C43B073DE8293EEEA0532042A4D60CF0B5E8D90B)