验证管理
最后更新时间：2025-12-05 10:58:23
创建验证码
1. 登录 验证码控制台，左侧导航栏选择验证管理。
2. 在验证管理页面，单击创建验证码。
说明：
新建验证码上限为50个，您可以基于不同业务需求创建多个验证码，配置不同的客户端类型、安全策略等。
3. 进入创建验证码页面，配置相关参数，完成后单击保存。
参数说明如下：
参数 | 说明 |
显示名称 | 新建验证码的显示名称。 |
平台类型 | 设置接入验证码的平台类型，支持 Web、iOS 和 Android。 Web：选择 Web 时，需配置域名来添加验证码（域名不进行校验）。 iOS：选择 iOS 时，需配置 Bundle ID 来添加验证码。 Android：选择 Android 时，需配置 Package name 来添加验证码。 注意： 域名：可选择右边+号，最多可新增10个。 |
验证码设置 | 验证码设置包括控件样式、验证机制、行为验证类型和风控等级。 控件样式：支持简约版、基础版和隐形版。 简约版：界面显示不含品牌信息的勾选框控件。 基础版：界面显示基础的勾选框控件。 隐形版：界面不显示勾选框控件。 验证机制：支持一键验证、始终验证和无感验证。 一键验证：只有可疑用户才会看到行为验证。 始终验证：所有用户都会看到行为验证。 无感验证：所有用户都不会看到行为验证。 行为验证类型：支持滑动拼图、图形点选和语音验证。 滑动拼图：拖动滑块，完成拼图。 图形点选：根据提示按顺序点击正确图形。 语音验证：根据语音提示填写验证码。 风控等级：支持体验优先、平衡和安全优先。体验优先风控拦截等级最低，安全优先风控拦截等级最高。 拦截策略托管：开启后，由腾讯云验证码决定是否拦截有风险的请求并要求重试。默认关闭，表示由业务方根据票据返回的结果自行采取行动。 注意： 无感验证机制下不支持设置拦截策略托管。 |
WAF 服务 | 注意： 该选项保存后不支持修改。 |
CaptchaAppId强制校验 | |
资源标签 | 用于从不同维度对资源分类管理。 |
4. 完成新建后，即可在集成页面中查看快速接入验证码的指引。
5. 返回到验证管理页，即可查看已创建的验证码。
说明：
开启 WAF 服务的验证码会展示 WAF 标签。
查看验证码详情
1. 登录 验证码控制台，左侧导航栏选择验证管理。
2. 在验证管理页面，单击验证码下方验证码详情。
3. 进入验证码总览页面，可查看当前验证码的请求量、验证量、票据校验量、验证请求趋势、验证拦截率分析和票据校验趋势等数据。
指标说明如下：
指标名称 | 指标说明 |
请求量 | 客户端加载验证的次数 |
验证量 | 用户回答验证问题后，发起验证的次数 |
验证通过量 | 验证通过的次数 |
验证拦截量 | 验证未通过，被拦截的次数 |
验证拦截率 | 验证未通过，被拦截率 |
因答案错误拦截率 | 因答案错误导致验证被拦截率 |
因安全策略打击拦截率 | 因安全策略打击导致验证被拦截率 |
票据校验量 | 服务端发起票据校验的次数 |
票据校验通过量 | 票据校验通过的次数 |
票据校验拦截量 | 票据校验未通过的次数 |
4. 选择配置页签，可查看验证码的基础信息、验证码密钥、验证码设置、IP 白名单以及其他等配置情况，单击修改，可对验证码配置进行修改。
5. 选择集成页签，可查看验证码接入指引和迁移指引。
修改验证码
1. 登录 验证码控制台，左侧导航栏选择验证管理。
2. 单击验证码右侧
3. 进入修改验证码页面，可对验证码进行修改，配置完成后单击保存。
参数说明如下：
参数 | 说明 |
显示名称 | 验证码的显示名称。 |
平台类型 | 设置接入验证码的平台类型，支持 Web、iOS 和 Android。 Web：选择 Web 时，需配置域名来添加验证码。 iOS：选择 iOS 时，需配置 Bundle ID 来添加验证码。 Android：选择 Android 时，需配置 Package name 来添加验证码。 |
验证码设置 | 验证码设置包括控件样式、验证机制、行为验证类型和风控等级。 控件样式：支持简约版、基础版和隐形版。 简约版：界面显示不含品牌信息的勾选框控件。 基础版：界面显示基础的勾选框控件。 隐形版：界面不显示勾选框控件。 验证机制：支持一键验证、始终验证和无感验证。 一键验证：只有可疑用户才会看到行为验证。 始终验证：所有用户都会看到行为验证。 无感验证：所有用户都不会看到行为验证。 行为验证类型：支持滑动拼图、图形点选和语音验证。 滑动拼图：拖动滑块，完成拼图。 图形点选：根据提示按顺序点击正确图形。 语音验证：根据语音提示填写验证码。 风控等级：支持体验优先、平衡和安全优先。体验优先风控拦截等级最低，安全优先风控拦截等级最高。 拦截策略托管：开启后，由腾讯云验证码决定是否拦截有风险的请求并要求重试。默认关闭，表示由业务方根据票据返回的结果自行采取行动。 注意： 无感验证机制下不支持设置拦截策略托管。 |
IP 白名单 | |
WAF 服务 | 不支持修改，如需修改请新建验证码。 |
CaptchaAppId强制校验 | |
资源标签 | 用于从不同维度对资源分类管理。 |
添加白名单
1. 登录 验证码控制台，左侧导航栏选择验证管理。
2. 在验证管理页面，单击验证码下方验证码详情。
3. 进入验证码总览页面，选择配置页签，单击左下角修改。
4. 单击添加白名单，弹出添加名单对话框，配置相关参数后，单击确定。
参数说明如下：
参数 | 说明 |
名单名称 | 填写白名单名称。 |
IP 地址 | 填写 IP 地址。支持IPV4/IPV6格式，支持批量输入。 |
描述 | 填写描述信息。 |
删除验证码
1. 登录 验证码控制台，左侧导航栏选择验证管理。
2. 单击验证码右侧
3. 单击删除，弹出删除确认框，单击确定，即可删除当前验证码。
注意：
验证码删除后，使用该验证码的验证场景将出现以下情况，请谨慎操作。
前端无法加载验证码。
后端票据校验报错。
文档反馈