# 授权流程相关配置

开发者在申请创建第三方平台时,需要填写很多开发参数。以下这些开发参数的说明

# 授权发起页域名

授权发起页域名指小程序在登录授权给第三方平台时的授权回调域名,在小程序进行登录授权流程中,必须从本域名内网页跳转到登录授权页,才可完成登录授权。

授权成功后会回调授权时提供的 URI,小程序平台会检查 URI,必须保证 URI 所属域名与服务申请时提供的授权域名保持一致。

注意: 域名不需带有 http:// 等协议内容,也不能在域名末尾附加详细的 URI 地址,严格按照类似 www.qq.com 的写法。

# 授权事件接收 URL

用于接收取消授权通知、授权成功通知、授权更新通知,也用于接收 验证票据(component_verify_ticket),component_verify_ticket 是验证平台方的重要凭据,请妥善保存。

服务方在获取 component_access_token 时需要提供最新推送的 component_verify_ticket 以供验证身份合法性

【授权后代替小程序实现业务】

小程序消息校验 Token:  开发者在代替小程序接收到消息时,用此 Token 来校验消息。用法与普通小程序 token 一致

小程序消息加解密 Key: 在代替小程序收发消息过程中使用。必须是长度为 43 位的字符串,只能是字母和数字。用法与普通小程序 symmetric_key 一致

小程序消息与事件接收 URL: 该 URL 用于接收已授权小程序的消息和事件,消息内容、消息格式、签名方式、加密方式与普通小程序接收的一致,唯一区别在于签名 token 和加密 symmetric_key 使用的是服务方申请时所填写的信息。由于消息具体内容不会变更,故根据消息内容里的 ToUserName,服务方是可以区分出具体消息所属的小程序。请注意:

1、考虑到服务需要接收大量的授权小程序的消息,为了便于做业务分流和业务隔离,必须提供如下形式的 url:www.abc.com/aaa/$APPID$/bbb/cgi,其中$APPID$在实际推送时会替换成所属的已授权小程序的 appid。

2、第三方平台只需获得某个业务模块的授权(而不需要获得客服与菜单权限的授权),然后在收到该业务模块事件推送后,如果该事件是允许进行 5 秒内被动回复消息给粉丝的,那么第三方就可以被动回复(业务模块的哪些事件推送允许被动回复用户,哪些不允许,需咨询具体业务模块), 点击查看被动回复接口文档

3、如果第三方希望实现实时获知小程序有新粉丝关注,只需要收到关注事件后回复 success 即可,不必另行回复,免得小程序出现多个第三方同时进行粉丝关注后的自动回复。

网页开发域名: 网页开发域名最多可以填写 3 个。每个网页开发域名会产生 2 个效果(请注意,勿域名不需带有“http://”等协议内容,也不能在域名末尾附加详细目录):

1、在该域名和符合要求的下级域名内,可以代替旗下授权后小程序发起网页授权。下级域名必须是$APPID$.wx.abc.com 的形式($APPID$为小程序的 AppID 的替换符,建议第三方用这种方式,若需可做域名映射),如果不按这种形式来做,旗下小程序违规将可能导致整个网站被封。

2、在该域名(一级域名)内,可以代替旗下授权后小程序调用 JS SDK(需要配合小程序的 AppID)

【其他】

白名单 IP 地址列表: 仅当开发者 IP 地址在该列表中时,才被允许调用相关接口。最多填写 100 个 IP 地址。后续有出口 IP 变更时一定要先在申请资料里填写并覆盖现网,否则会被拦截。

注:对于申请资料中填写的所有完整有效 url,都需要做一次 echo 校验,以确定该 url 是有效可连通的,这个与普通小程序开发模式下 url 校验方式一致,只是使用的 token 为服务方的 token。

具体校验规则请点击