incubator common modules for node

[TOC] incubator公共模块,提供incubator体系下用户管理、日志管理、授权登录等模块的能力

refresh token机制

如果一直处于操作中，incubator支持维持登录态，在登录态即将过期时刷新有效期。

原理

如果在过期前一段时间用户有操作，在调用center接口时， 1、增加请求头——

'need-refresh-token': 1

2、请求返回时会添加响应头——

'incubator-refresh-token': 'a4268c96-8a11-407e-b9a5-b1a7ac047929'

3、将用户session中的原token更新为新的token即可

node sdk实现方式：

需要配合fbi-project-incubator项目模板使用，在poxyCenterRoutes中定义的路由，按需添加updateSession方法即可。如：

1router.post('/api/auth/islogin', async (ctx) => {
2  let res: any = ctx.session && !!ctx.session.token
3  if (res) {
4    res = await this.isLogin(ctx.session.token)
5    this.updateSession(res, ctx)
6    ctx.body = resReturn(res.data, res.code)
7  } else {
8    ctx.body = resReturn(res)
9  }
10})

单测执行须知

sdk接口规范文档可能会因为更新不及时，存在与当前版本的接口不一致的地方，这种不一致会造成子应用通过sdk调用center服务的时候出现异常。为了能快速找出文档与接口的不一致，可以通过执行单元测试来发现。具体执行步骤如下：

• incubator-center项目切换到已发布的最新版本，启动本地的center服务

• 打开http://127.0.0.1:8081，用平台管理员身份登录，抓包api/auth/getUser获取token和id

• 修改tests/inc.config.ts中部分参数，其中iamToken和userId来源于上一步

  1{
  2  // 本地环境
  3  appId: '46444645', 
  4  appSecret: 'd1b040e1-0dc1-4b8b-8812-297585daf101',
  5  incServer: 'http://127.0.0.1:8080',
  6  iamToken: 'a9b3545b-f799-4464-b921-fb3c08d6393e',
  7  userId: '144115205301725059', // 当前登录用户ID
  8  orgId: '100000000000000000000000', // center租户组织机构
  9}

• 执行单元测试npm run test。测试用例都是按照最新文档编写，下图体现了inc.org.getTreeById接口文档与实际不一致的情况

• 根据上一步中未通过用例的提示，修改接口文档

参考

• 文档
• CHANGELOG