提示：WPS Comate Lua脚本鉴权仅开放给管理员操作，配置前请确认已具备管理员权限。
为什么需要 Lua脚本鉴权？
很多业务系统（尤其是企业内部系统）采用自定义的签名算法，比如考勤系统的 MD5 动态签名、某些内部系统的 HMAC 变体。这些算法 APIHub 内置的凭据类型覆盖不了，AI 助手无法直接调用。Lua脚本鉴权就是解决这个问题的钥匙——管理员在网关层编写一段 Lua 脚本，自动完成签名计算，让 AI 能安全地调用这些特殊认证系统的数据。
准备工作
在开始配置 Lua脚本鉴权之前，需要准备以下内容：
- 拥有 WPS 365 管理员账号，并已开通 Comate Studio 平台权限
- 获取目标业务系统的接口文档，明确其鉴权算法（如 MD5 签名规则）
- 获取目标系统的访问凭证（如 appId、appKey）
- 确认目标系统的认证算法是 APIHub 内置凭据类型覆盖不了的
操作步骤
Step 1：进入脚本管理
打开浏览器，访问 Comate Studio 平台，使用管理员账号登录。进入左侧菜单栏的「APIHub 连接开发」→「脚本管理」。
Step 2：新建 Lua 脚本
点击「新建脚本」，粘贴自定义的签名算法逻辑。以考勤系统的 MD5 动态签名为例：
- 从请求头读取 X-App-Id（appId）和 X-App-Key（appKey）
- 读取请求体（GET 时为空串）
- 生成 13 位毫秒时间戳
- 计算
md5(时间戳 + appId + 请求体 + appKey) - 把 sign 和 timeStamp 写入请求头
- 清除原始凭证头（appId/appKey 不传给上游）
Step 3：保存脚本并绑定 API
保存脚本后，回到 API 列表，逐个为需要加工的 API 手动绑定脚本。注意：脚本绑定是逐 API 进行的，每个需要加工的接口都要单独绑定。
Step 4：创建凭证
在凭证管理中创建连接凭证，填写目标系统要求的 appId、appKey 等信息。凭证加密托管，平台无法查看明文。
Step 5：创建连接器
创建连接器实例，选择对应的连接模板和凭证，然后从模板同步 Skill 到连接器。创建完成后，分配给指定的 AI 专家使用。
Step 6：发布前校验
在测试环境验证脚本的语法和签名逻辑，确认 API 调用成功后，再发布到正式环境。修改脚本后需重新发布才生效。
效果展示
配置完成后，团队成员可以在 Comate 中通过自然语言与 AI 助手交互，AI 会自动调用连接器配置的 API 接口。网关在后台自动执行 Lua 脚本计算签名，用户完全无感知。
例如，配置了考勤系统连接器后，可以直接在 Comate 中问："帮我查一下今天云和部门的考勤汇总"——AI 助手自动调用考勤接口，网关执行 Lua 脚本算好签名，返回实时考勤数据。
常见问题（FAQ）
问：脚本写错了会导致什么后果？
答： 脚本语法错误会导致 API 调用失败。因此发布前务必在测试环境验证脚本，确认无误后再发布。修改已绑定的脚本后也需要重新发布才生效。
问：脚本可以自动应用到所有 API 吗？
答： 不可以。脚本绑定是逐个 API 进行的，每个需要加工的 API 都要单独绑定，不会自动继承。这是为了精确控制每个接口的加工逻辑。
问：普通用户能查看或修改脚本吗？
答： 不能。脚本的创建、编辑、绑定权限仅开放给管理员。这是平台的安全合规设计，防止脚本被恶意利用或配置错误导致数据泄露。
问：脚本需要经常维护吗？
答： 一般情况下脚本运行稳定后无需频繁维护。只有当目标系统的签名算法或接口结构发生变化时，才需要管理员更新脚本并重新发布。
注：部分内容由 AI 匹配目标关键词，结合WPS 365 官方知识库智能生成，如有疑问或者建议可以联系我们。
