19 lines
2.5 KiB
Markdown
19 lines
2.5 KiB
Markdown
|
# 腾讯云人机验证码：一个 JSON 文件
|
||
|
|
|
||
|
|
填写 `tencent-captcha.json.example` 并另存为 `tencent-captcha.json`，不要提交填写后的文件，不要发到聊天里。
|
||
|
|
|
||
|
|
- `secret_id`、`secret_key`：腾讯云 API 访问密钥，需要验证码票据校验权限。可以使用已有密钥，但仅有短信权限的子账号密钥需要增加验证码权限；建议独立最小权限密钥。
|
||
|
|
- `saas.captcha_app_id`、`saas.app_secret_key`：在腾讯云验证码控制台创建 **Web/App** 类型的验证码，填入其 CaptchaAppId、AppSecretKey。
|
||
|
|
- `mini_program.captcha_app_id`、`mini_program.app_secret_key`：单独创建 **微信小程序** 类型的验证码，填入另一组。不是微信小程序自身的 AppID/Secret，也不是短信 SDKAppID。
|
||
|
|
- 两端不能填同一个 CaptchaAppId；暂不使用的一端两个字段都留空。所有字段使用字符串，保留双引号。
|
||
|
|
|
||
|
|
文件上传到服务器 `/etc/data-terminal-cloud/voice-runtime/tencent-captcha.json`。该目录已有只读挂载，容器内默认读取 `/run/secrets/voice-runtime/tencent-captcha.json`，无须修改短信配置。权限设为 `root:65532`、`640`，重建/重启 api 和 worker 读取文件。
|
||
|
|
|
||
|
|
部署含迁移 71 的版本后，管理端 → 运行配置 → 验证码设置，分别选择 SaaS 或微信小程序的「现有图形验证码 / 腾讯云验证码」并保存。此配置全平台生效，仅 `ops_admin` 可操作。默认为图形验证码；配置文件本身不会启用腾讯云。页面显示「配置已加载」只说明字段完整，不代表已联网核验密钥、权限或套餐。
|
||
|
|
|
||
|
|
微信小程序还需在微信公众平台「设置 → 第三方设置 → 添加插件」授权 **腾讯验证码**，插件 provider `wx1fe8d9a3cb067a75`，代码使用版本 `2.1.5`。授权后用微信开发者工具重新编译、真机测试并发布小程序；后端发布不会自动发布小程序。
|
||
|
|
|
||
|
|
腾讯云控制台选择滑动拼图验证，填写对应的网站域名/小程序配置。当前未接入可选的 CaptchaAppId 加密鉴权，因此不要开启「CaptchaAppId 强制校验」。验证码套餐费用与短信费用独立。SDK/插件失败、云端拒绝或超时都不放行，也不自动退回图形验证；可由管理员主动切回图形模式。
|
||
|
|
|
||
|
|
参考：[Web](https://cloud.tencent.com/document/product/1110/36841)、[微信小程序](https://cloud.tencent.com/document/product/1110/49319)、[服务端票据校验](https://cloud.tencent.com/document/product/1110/75490)。
|