特性
引入该插件后
- webpack服务启动时，会依次请求获取企微信access_token、企业jsapi_ticket和应用jsapi_ticket；
- 使用用户传参和上一步生成的jsapi_ticket，通过JS-SDK使用权限签名算法，得到signature；
- 插件会将传参和signature注入到前端页面，页面加载通过js即可获取，完成企微SDK鉴权；
安装
使用npm安装
npm install ww-auth-webpack-plugin使用
比如在webpack.config.js文件中你可以这样配置
//...
const WwAuthPlugin = require('ww-auth-webpack-plugin')
module.exports = defineConfig({
// ...
configureWebpack: {
plugins: [
new WwAuthPlugin({
corpid: "", // 必填，企业微信的corpid，必须与当前登录的企业一致
corpsecret: "", // 必填，密钥
timestamp: "", // 必填，生成签名的时间戳
noncestr: "", // 必填，生成签名的随机串
agentid: "", // 必填，企业微信的应用id （e.g. 1000247）
url: "", // 页面URL
}),
],
},
});页面加载时，即可从__wwAuthInfo__.json获取企业微信SDK鉴权所需信息。
// 通过agentConfig注入应用的权限
const setUpAgentConfig = (authInfo) => {
const { corpid, agentid, timestamp, noncestr, appsign } = authInfo;
return new Promise((resolve, reject) => {
wx.agentConfig({
corpid, // 必填，企业微信的corpid，必须与当前登录的企业一致
agentid, // 必填，企业微信的应用id （e.g. 1000247）
timestamp, // 必填，生成签名的时间戳
nonceStr: noncestr, // 必填，生成签名的随机串
signature: appsign, // 必填，签名，见附录-JS-SDK使用权限签名算法
jsApiList: [
"selectExternalContact",
"getExternalContact",
"getCurExternalContact",
"getCurExternalChat",
"shareToExternalChat",
"shareToExternalContact",
"chooseImage",
"getContext"
], //必填，传入需要使用的接口名称
success: (res) => {
// 回调
resolve(res);
},
fail: (res) => {
if (res.errMsg.indexOf("function not exist") > -1) {
console.error("版本过低请升级");
}
reject(res);
}
});
});
};
// 初始化企业微信鉴权
export const initSdk = async () => {
const authInfo = await fetch("__wwAuthInfo__.json").then((response) =>
response.json()
);
const { noncestr, timestamp, corpid, corpsign } = authInfo;
return new Promise((resolve, reject) => {
wx.config({
beta: true, // 必须这么写，否则wx.invoke调用形式的jsapi会有问题
debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。
appId: corpid, // 必填，企业微信的corpID，必须是本企业的corpID，不允许跨企业使用
timestamp, // 必填，生成签名的时间戳
nonceStr: noncestr, // 必填，生成签名的随机串
signature: corpsign, // 必填，签名，见 附录-JS-SDK使用权限签名算法
jsApiList: ["chooseImage"] // 必填，需要使用的JS接口列表，凡是要调用的接口都需要传进来
});
wx.ready(async () => {
try {
const agentConfigRes = await setUpAgentConfig(authInfo);
resolve(agentConfigRes);
} catch (err) {
reject(err);
}
});
wx.error((err) => {
// config信息验证失败会执行error函数，如签名过期导致验证失败，具体错误信息可以打开config的debug模式查看，也可以在返回的res参数中查看，对于SPA可以在这里更新签名。
reject(err);
});
});
};