[WaferOnSCF]在SCF上的小程序会话服务器

2019-03-18 10:56:29 浏览数 (1)

Wafer On SCF

项目概况:

该项目基于腾讯云小程序会话服务器(Wafer)的二次开发。修改某些配置,破除一套服务器对应一个小程序或公众号哦的限制。添加了小程序、微信公众号、企业微信相关的AccessToken管理接口,JSAPI_TICKET管理接口等,更新mysql库到mysqli。适配了SCF架构,可直接部署到SCF上,通过API网关,提供内外网环境下的会话管理服务。

本人小白,完全不懂PHP,原项目在代码层面无法支持多个小程序或公众号,所以在此做了修改和适配。本项目可搭配官方Wafer的客户端SDK使用,但客户端SDK需要做一定的适配修改。

  • 成立时间:2019-3-15
  • 开发语言:PHP5
  • 运行环境:SCF PHP5.6
  • 项目地址:GITHUB
  • 原项目地址GITHUB:Wafer 会话服务器

功能说明:

  1. 小程序鉴权功能:由于微信官方并未实现小程序鉴权,直接前端暴露openid的方式虽然可行但是并不安全,所以Wafer实现了小程序的鉴权。通过生成自己的userid和userkey的方式在后端实现鉴权。本功能具体请参看官方Wafer介绍
  2. 小程序信息接密:小程序中敏感数据需要进行接密,如运动数据、用户信息等,直接调用本服务即可
  3. 公众号AccessToken托管:公众号AccessToken生命周期托管。
  4. 腾讯云COS签名
  5. 企业微信自有应用的AccessToken、JSAPI_Ticket生命周期托管(只适配了企业微信企业内部应用,第三方开发商是否可用我不知道)

目录说明:

  • application:应用目录
    • controllers:各接口功能
      • cosauth:COS鉴权相关服务 - minaauth:小程序&服务号鉴权相关服务 - workauth:企业微信鉴权相关服务
    • services:数据库相关操作
      • minauth:小程序&服务号 - workauth:企业微信
  • db:数据库创建语句
  • system:系统配置等文件
  • index.php:入口文件

使用方法:

  1. 配置/system/db/db.ini中为你的MySQL连接参数
  2. 数据库执行db.sql初始化表结构等
  3. 打包所有文件为XXX.zip
  4. SCF新建一个PHP5.6的运行环境
  5. 上传并部署ZIP包
  6. 申请API网关并添加API等,配置域名(如果有需要),配置接口后端等,具体请看官方文档
  7. 开始使用吧。

开发内容:

流程介绍:通过程序入口index.php文件调取了system目录下parse_request.php从而解析上传的json入参对象根据json中不同的interfacename来判断调取application/controllers/qcloud/minaauth/Auth.php中对应的方法。Auth.php通过调用application/services/qcloud/minaauth/Cappinfo_Service.php对数据库进行操作。

  • 项目增加了微信AccessToken的管理,可以自动进行AccessToken的生命周期托管,用户只需调用相关接口并使用即可,无需担心微信端请求次数限制。具体实现方式可查看/application/controllers/qcloud/minaauth/Auth.php中的get_access_token方法。
  • 由于AccessToken是有失效机制的,同一个appid,如果用户自己调用接口获取了AccessToken,则本系统中的AccessToken会在一定时间后即失效,但系统判断失效是按数据库中的有效期进行判断的,所以可能会存在通过本服务获取的AccessToken是无效的(当然也有force方式强制获取本系统中的AccessToken)。
  • 综上所述,推荐大家把同一应用的AccessToken等方法都迁移到本服务中,进行统一管理和维护。

修改内容:

  • 修改mysql方法为mysqli方法
  • 适配SCF入口函数
  • 新增企业微信应用的鉴权接口
  • 修改数据库cAuth表,插入了其他的小程序appid和SecretKey。
  • 修改parse_request.php中的解析内容,加入了appid参数的解析。
  • 修改Auth.php中的方法,新增了appid的入参。
  • 修改Cappinfo_Service.php中的方法,加入了appid的入参,并修改了sql语句。

通过上述修改,实现了带appid参数调用会话服务器,服务器根据对应的appid和secretKey调用微信服务器的接口解析用户登录信息,并生成第三方session保存到数据库cAuth中的sessioninfo表中。

接口说明:

测试语句:curl API网关域名/release/mina_auth/ -X POST -H 'content-type:application/json' -d '{下面的json入参}'

小程序鉴权:id_skey接口,客户端传入appid和code,后台返回生成的skey和id,创建用户成功

代码语言:txt复制
    {
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cam.id_skey",
		"para":{
			"appid":"",
			"code":""
			}
	    }
    }

小程序userinfo解密接口。客户端传入id,skey,encrypt_data,iv,会话服务器进行解密并更新用户信息和返回揭秘数据

代码语言:txt复制
    {
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cam.userinfo",
		"para":{
			"id":"",
			"skey":"",
			"encrypt_data":"",
			"iv":""
		    }
	    }
    }

小程序auth接口。客户端鉴权,入参id,skey,appid。

代码语言:txt复制
    {
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cam.auth",
		"para":{
			"id":"",
			"skey":"",
			"appid":""
			}
	    }
    }

小程序decrypt接口。数据解密接口,通过传入id,skey,encrypt_data,iv进行数据解密并返回

代码语言:txt复制
    {
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cam.auth",
		"para":{
			"id":"",
			"skey":"",
			"encrypt_data":"",
			"iv":""
			}
	    }
    }

小程序&公众号access_token接口。根据appid获取有效的accesstoken

代码语言:txt复制
	{
		"version":1,
		"componentName":"MA",
		"interface":{
			"interfaceName":"qcloud.mimi.access_token",
			"para":{
				"appid":"",
				"force":false,//强制刷新
			}
		}
	}

腾讯云COS Reusable签名接口。根据传入的参数获取COS长效签名

代码语言:txt复制
{
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cos.auth.reusable",
		"para":{
			"appid":"",
			"sid":"",
			"skey":"",
			"bucket":"",
			"expiration":"",
			"filepath":"" || null
		}
	}
}

腾讯云COS NonReusable签名接口。根据传入的参数获取COS一次性签名

代码语言:txt复制
{
	"version":1,
	"componentName":"MA",
	"interface":{
		"interfaceName":"qcloud.cos.auth.nonreusable",
		"para":{
			"appid":"",
			"sid":"",
			"skey":"",
			"bucket":"",
			"filepath":"" || null
		}
	}
}

企业微信access_token接口。根据agentid,corpid获取有效的accesstoken

代码语言:txt复制
	{
		"version":1,
		"componentName":"MA",
		"interface":{
			"interfaceName":"qcloud.work.access_token",
			"para":{
				"corpid":"",//企业ID
				"agentid":"",//应用ID
				"force":false,//强制刷新
			}
		}
	}

企业微信新增或重置应用配置接口

代码语言:txt复制
	{
		"version":1,
		"componentName":"MA",
		"interface":{
			"interfaceName":"qcloud.work.initagent",
			"para":{
				"corpid":"",//企业ID
				"agentid":"",//应用ID
				"agentsecret":"",//应用对应的secret
				"remark":"备注"//备注信息
			}
		}
	}

企业微信jsapi_ticket接口。根据agent,corpid获取有效的jsapi_ticket

代码语言:txt复制
	{
		"version":1,
		"componentName":"MA",
		"interface":{
			"interfaceName":"qcloud.work.ticket",
			"para":{
				"corpid":"",//企业ID
				"agentid":"",//应用ID
				"force":false,//强制刷新
			}
		}
	}

企业微信应用的jsapi_ticket接口。根据agent,corpid获取有效的jsapi_ticket

代码语言:txt复制
	{
		"version":1,
		"componentName":"MA",
		"interface":{
			"interfaceName":"qcloud.work.agent.ticket",
			"para":{
				"corpid":"",//企业ID
				"agentid":"",//应用ID
				"force":false,//强制刷新
			}
		}
	}

0 人点赞