# 小程序环境共享
版本要求:开发者工具 >=
1.03.2009140
(稳定版下载)
云开发支持跨账号环境(资源)共享,即一个小程序的云开发资源可以授权共享给同主体下其他小程序 / 公众号使用,并有以下好处:
优势 & 特点 | 说明 |
---|---|
资源复用 | 云开发资源可共享给其他账号使用,创建新小程序无需复制或迁移数据 |
能力复用 | 开发好的云函数可以授权给其他账号原生调用,类似 HTTP 服务,做到能力复用 |
Web 支持 | 在 Web 中既可以使用公众号登录态访问微信云开发资源和能力,又可以在 Web 中用未登录模式访问 |
细粒度授权 | 授权粒度细,如可以只授权云函数调用权限而不授权修改权限 |
单层级授权 | 单层级授权保证了安全,如A有B的授权,B有C的授权,但A没有C的授权,此时A可以调B但不能直接调C |
# 小程序间跨账号资源共享
# 操作步骤
1.开通,使用 1.03.2009140
或以上版本的开发者工具,进入云控制台,到 “设置 - 拓展能力 - 环境共享” 点击开通即开通环境共享能力。
2.共享,环境共享开通后将在顶部tab显示环境共享功能,进入 “环境共享” 的页面,点击“添加共享”,即可授权同主体下其他小程序/公众号使用当前小程序下的云开发资源。
3.授权,选择共享的云环境,默认选中所有环境操作权限,可根据实际使用场景自定义授权。授权只可授权当前小程序的自有环境,如A有B授权的环境,A不可将B授权的环境再次授权给C;
4.被共享环境的小程序使用,使用 1.03.2009140
或以上版本的开发者工具,进入云控制台,点击“环境共享”进入“环境共享”页面可查看被共享小程序情况;如需在云控制台查看授权环境的资源情况,可前往“设置-环境名称”将环境切换至该授权环境即可,同时在被授权操作的情况下可以对授权环境进行操作。
# cloudbase_auth 云函数
在使用共享环境之前,需要保证资源方拥有 cloudbase_auth
云函数,用于鉴权调用方的身份并制定相关权限。
在调用方 cloud.init()
的过程中,会首先执行这个函数,如果这个函数不存在,会提示找不到对应的FunctionName
。请务必参考示例在资源方添加此函数。
被调的资源方小程序 cloudbase_auth 云函数简易示例:
const cloud = require('wx-server-sdk')
cloud.init({
env: cloud.DYNAMIC_CURRENT_ENV
})
// 云函数入口函数
exports.main = async (event, context) => {
const wxContext = cloud.getWXContext()
console.log(event)
console.log(wxContext)
// 跨账号调用时,由此拿到来源方小程序/公众号 AppID
console.log(wxContext.FROM_APPID)
// 跨账号调用时,由此拿到来源方小程序/公众号的用户 OpenID
console.log(wxContext.FROM_OPENID)
// 跨账号调用、且满足 unionid 获取条件时,由此拿到同主体下的用户 UnionID
console.log(wxContext.FROM_UNIONID)
return {
errCode: 0,
errMsg: '',
auth: JSON.stringify({
// 自定义安全规则
// 在前端访问资源方数据库、云函数等资源时,资源方可以通过
// 安全规则的 `auth.custom` 字段获取此对象的内容做校验,
// 像这个示例就是资源方可以在安全规则中通过 `auth.custom.x` 获取
x: 1,
}),
}
}
cloudbase_auth 云函数交互协议说明
cloudbase_auth
云函数返回的对象结构协议:
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
errCode | number | 是 | 自定义错误码,0 表示授权通过,非 0 表示拒绝授权,会透传回给调用方 | |
errMsg | string | 否 | 自定义错误信息,errCode 非 0 时透传回给调用方 | |
auth | string | 否 | 安全规则对象,必须序列化成字符串 |
# 代码使用
小程序代码使用示例(需小程序公共库 2.13.0
或以上):
// 声明新的 cloud 实例
var c1 = new wx.cloud.Cloud({
// 资源方 AppID
resourceAppid: 'wxe0e2656d74f0bff3',
// 资源方环境 ID
resourceEnv: 'test-f96b31',
})
// 跨账号调用,必须等待 init 完成
// init 过程中,资源方小程序对应环境下的 cloudbase_auth 函数会被调用,并需返回协议字段(见下)来确认允许访问、并可自定义安全规则
await c1.init()
// 完成后正常使用资源方的已授权的云资源
await c1.callFunction({
name: '函数名',
data: {},
})
在云函数中使用与在小程序中并没有多少区别(需 wx-server-sdk
版本大于或等于 2.3.0
):
const cloud = require('wx-server-sdk')
exports.main = async (event) => {
// 声明新的 cloud 实例
var c1 = new cloud.Cloud({
// 资源方 AppID
resourceAppid: 'wxe0e2656d74f0bff3',
// 资源方环境 ID
resourceEnv: 'test-f96b31',
})
// 跨账号调用,必须等待 init 完成
// init 过程中,资源方小程序对应环境下的 cloudbase_auth 函数会被调用,并需返回协议字段(见下)来确认允许访问、并可自定义安全规则
await c1.init()
// 完成后正常使用资源方的已授权的云资源
return c1.callFunction({
name: '函数名',
data: {},
})
}
# 环境共享给未开通云开发的小程序
1.未开通云开发的小程序无法进入云开发控制台,如被同主体的其他小程序共享环境后,默认允许未开通云开发的小程序可进入云开发控制台,且默认开通“环境共享”功能;进入控制台后默认显示授权共享环境的第一个小程序的云开发环境。
2.未开通云开发的小程序被共享后,如需开通云开发,则可通过路径“设置-切换环境-创建环境”开通云开发并创建环境;
3.未开通云开发的小程序被共享后,解除所有小程序的共享关系,则环境共享功能注销,且云开发制台入口消失;