Skip to content

鉴权

加入在线文档编辑功能时,可以通过 JSSDK 传递 token 完成用户鉴权。

设置 token 分 3 个步骤:

  • 在线文档初始化时传递 auth 参数为 true
  • 通过 setToken 主动设置 token
  • 通过在 config 中配置 refreshToken 在过期时主动刷新 token

代码示例

js
// 刷新 token 函数。由接入方实现
const refreshToken = () => {
  // 接入方业务处理...

  // 可以返回 Promise 或者 return { token, timeout }
  return Promise.resolve({
    token: "yourToken", // 必需:你需要设置的 token
    timeout: 10 * 60 * 1000, //  必需:token 超时时间,以 10 分钟示例
  });
};

const jssdk = WebOfficeSdk.init({
  // ...

  // 刷新 token 的方法
  refreshToken,
});

// 设置 token
await jssdk.setToken({
  token: "yourToken", // 根据自身的业务需求,通过异步请求或者模板输出的方式,取得 token
  timeout: 10 * 60 * 1000, // token 超时时间,可配合 refreshToken 配置函数使用,在超时前调用 refreshToken 重新刷新 token
});
await jssdk.ready();

// 此时可以调用高级API进行业务能力开发了