淘宝对数据安全的高度重视,小程序框架设计的是一个封闭的环境,在框架内,小程序的后端服务只允许使用小程序云提供的环境。考虑到当前用户确实是有部分的与外部服务通信的诉求,例如和商家自身的会员系统通信,查询会员等级等,因此,平台开放应用外联白名单,申请外联白名单通过后,小程序即可与指定的域名通信。
1.域名请求时必须填写清楚业务描述场景,参见HTTP白名单申请文档模版。
2.新域名在申请通过前,只有在测试环境下可以进行调用,申请通过后,才可以在其他环境下进行调用。
3.请求的域名不需要写完整路径,细化到接口维度,只需要填写域名地址即可,若有端口号,请求域名需要加上端口号。
4.域名白名单在等待申请新的字段的时候,旧的字段是可以继续使用的,不会影响线上云函数的使用,审核通过后,只能使用新申请字段。
5.只要该域名下调用用到的参数都需要进行申请(包括url以及body中的参数),未申请的参数在调用时会被过滤,无法调通(请求参数申请不验证大小写)。
6.一个域名有一条申请通过记录,若需要修改该域名下的参数,不必重新申请,申请补充字段即可。
7.POST请求,相对GET请求审核更严格,如无必要请使用GET,若需要,只需要申请POST请求即可,GET请求同步开放。
1.登录【淘宝开放平台控制台 - 应用管理 - 我的应用】页面,点击应用的【应用管理】按钮,进入应用管理页面。
2.开通云服务,点击【云函数 -> 域名配置 -> 添加】。
3.填写申请的域名信息,注意:域名申请会有多层审核,审核周期1-5个工作日,请将申请原因和数据需要使用的具体场景描述清楚,否则很有可能被拒绝。白名单域名最多支持配置10个(指申请通过的记录数最多10条),配置后无法删除,请谨慎使用。
4.域名申请通过后,若想在审核通过的域名修改或者补充参数,点击申请补充字段,填写参数,重新进入审批流程。
进入审批中域名可在测试环境下进行调试。
5. 对于还未审核的域名可以撤销申请,审核撤销后,可以删除域名或者重新进行申请。
部分定制的开发者可能对多个商家的小程序提供相同的服务,每次都需要进行相同的录入工作,支持导出和导入可以快速进行域名配置的复制。
点击配置导出,可以将该商家云下所有配置的域名白名单批量导出成json文件,开发者可以对导出的文件进行修改。
点击配置导入,导入相应格式json文件,开发者可以将曾经配置过的域名快速复制。
导入域名配置后,申请状态为编辑状态,此时域名在测试环境下无法调试,点击提交申请后,可以在测试环境下进行测试。