Skip to content

鉴权

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

设置 token 分 3 个步骤:

  1. 在线文档预览地址的 url 参数中设置 _w_tokentype=1(注意,这个参数也是需要参与签名的)
  2. 通过 setToken 主动设置 token
  3. 通过在 config 中配置 refreshToken 被动刷新 token

提示

由于 js-sdk 会提前 5 分钟调用该方法,所以建议设置的 timeout 为 10 分钟以上(10 * 60 * 1000 以上,单位为毫秒),避免刷新过快的问题

// 获取 token 函数
const refreshToken = () => {
  // 自身业务处理...

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

// 配置超时获取 token 函数
const jssdk = WebOfficeSDK.config({ refreshToken });

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