使用场景
网站和APP,在所有可能被机器行为攻击的场景,例如但不限于注册、登录、短信接口、查询接口、营销活动、发帖评论等等,都可以部署使用「行为验证」,来抵御机器批量操作。
验证码流程时序图
极验产品后台使用
1、获取账号
如您需体验行为验证 4.0 产品,请事先注册极验产品账号,可点击此处提交账号申请
2、通过注册邮箱登录极验产品后台后,选择【行为验】产品
3、进入【行为验】产品后台后,根据提示选择【创建业务模块】输入应用名称、应用地址、所属行业。
4、创建业务模块完成后,点击【新增业务场景】,输入场景名称、选择客户端类型、业务类型后生成部署所需的 captcha_id
和 captcha_key
。
验证流程上不会校验不同场景和客户端是否共用一套
id
和key
,但为区分验证数据和配置不同的验证策略,建议不同的业务场景单独创建id
和key
部署
5、点击【部署检测】-【跳过指引】,即可进行后续场景的数据查看和验证形式配置等操作
服务端接入
当用户在前端界面通过验证码后,会产生一批与验证码相关的参数,用户的业务请求带上这些参数,后台业务接口再将这些参数上传到极验二次校验接口,确认该用户本次验证的有效性。
1、获取 captcha_id
和 captcha_key
参考上述步骤登录极验产品后台-业务管理,获取到服务端部署所需的 captcha_id
(验证 ID)和 captcha_key
(验证 key),或联系您的项目对接人获取。
2、获取客户端验证参数并签名
在客户端完成验证后,可通过回调函数获取验证码相关参数,并通过业务自定义接口如注册登录等传入服务端,服务端拿到客户端验证参数后,需要使用客户端验证参数 lot_number
和 captcha_key
参考示例进行签名生成 sign_token
。
3、上传验证参数提交二次校验
将客户端和服务端最终验证参数提交二次校验接口,进行二次校验,并根据二次校验返回结果处理最终的业务请求
参数请求格式请使用 application/x-www-form-urlencoded 格式,否则将返回报错-50005
4、处理容灾降级逻辑
注意处理二次校验接口异常情况,当请求极验二次验证接口异常或响应状态非200时对请求进行放行处理,避免因为接口请求超时或服务未响应而阻碍业务流程。
5、处理业务逻辑
根据极验二次校验接口返回的结果状态,进行后续的业务逻辑处理:仅当二次校验接口返回 result
为 success
时,才允许通过业务流程。
服务端预计开发周期:30分钟
服务端接入常见问题,请参考此处
6、接入示例
二次校验接口
接口信息 | 说明 |
---|---|
接口地址 | http://gcaptcha4.geetest.com/validate |
协议支持 | https/http |
请求方法 | GET/POST |
请求格式 | application/x-www-form-urlencoded |
返回类型 | json |
请求参数
参数名 | 类型 | 是否必填 | 说明 |
---|---|---|---|
lot_number | string | 是 | 验证流水号 |
captcha_output | string | 是 | 验证输出信息 |
pass_token | string | 是 | 验证通过标识 |
gen_time | string | 是 | 验证通过时间戳 |
captcha_id | string | 是 | 验证 id |
sign_token |