主题
验证码验证拦截器
WARNING
对接口进行图片验证码验证。
支持功能:
- 验证图片验证码
配置
参数说明
配置后,对需要验证的地址进行验证拦截
enabled
:是否启用拦截器,默认不启用false
items
:规则列表,可以配置多个generate-urls
:生成验证码的接口地址verify-urls
:需要验证的接口地址business-key
:业务key,当需要区分业务时,需要配置,通过业务key进行隔离parameter-type
:获取参数类型,header
请求头,query
查询参数,body
code-field-name
:临时code的参数名称value-field-name
:验证码值的参数名称expire
: 过期时间,默认5分钟,可以配置秒,分钟,小时,天,例如:PT30M
30分钟,PT2H
2小时,参考说明captcha-type
:验证码类型,custom
自定义,调用接口
示例
yaml
wueasy:
gateway:
filter:
captcha:
enabled: true #是否启用,默认false
items:
- generate-urls:
- /demo/captcha
verify-urls:
- /demo/login
code-field-name: code
value-field-name: captcha
parameter-type: body
特殊说明:需要注意接口登录权限的处理
实际案例
- 登录接口
/demo/login
需要图片验证码 - 通过访问生成验证码接口
http://127.0.0.1:8080/demo/captcha
,接口返回ResultVo<CaptchaVo>
- 生成验证码代码
java
/**
* 获取验证码
* @author: fallsea
* @return
*/
@PostMapping(value = "/captcha", produces = MediaType.APPLICATION_JSON_VALUE)
public Mono<ResultVo<CaptchaVo>> captcha() {
AbstractCaptcha captcha = CaptchaUtil.createLineCaptcha(150,60,5,150);
captcha.setGenerator(new RandomGenerator("23456789ABCDEFGHJKLMNPQRSTUVWXYZ",5));
String captchaCode = captcha.getCode();
CaptchaVo vo = new CaptchaVo();
//验证码值
vo.setCode(captchaCode);
//验证码图片
vo.setCaptcha(captcha.getImageBase64Data());
return Mono.just(ResultVo.ok(vo));
}
- 验证码返回数据
json
{
"errorNo":0,
"data":
{
"code":"88e8d3552ed0d2b8467bc5e497614e69",
"captcha":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJYAAAAoCAIAAACTo5SwAAADMElEQVR42u3asWuVMRAA8PePufoHdFXpooh0VWihiwUnXVwc3tPBwUXU0oKCxUFQFBQnF4cHDoIIYhfdXwMH4cgll0tyyZev5rih330p79Ef+XLJ18WGjQ/fP9rcjOgyFrwfczmid0Iv2FAchCNaETJUQ3EQjhiEI84T4eHfZzYH4czaGcr230JqEt7eu+Sk1rdc7uziPLi+zdA6g00KP+XhjftOCoeFRgrj0ZOVk8KRylt76jcJobmVTUh5SqRLCEOKyYQb8QGb10+LkJKAk3dkbcI2fl7C0IBF+Z+4qp+XEKjoWljoFxVS92MIqWItwpBfbUKwwR0pM6xE8ZwTOmDtCaNjooRHRy9wMoQ1/CYm5P3qLYRahNbMKd7Z2qNU+PLe1q7JT8dPISv5OU6M7kLFr9kUxJVCP+ZDqSL2c+ZfiSKFaUTopWpPGL0MEfJ+MOe8itSvUDFKaLXUCBmnuRBG/RjFBoRJxWTC/ZsXbDpIO1cuQtZeCPnuRvIgLST0Ds4jlE84vtMREf45XQKbTVMxCXdfPj6xdVCsNwVDhMx4RUKvlu4UlLQ50jNS7Bfa/xlXPPOwonAuvv+9xtkPIW1qsBlOxV5mAkLq59SjfnwlRJJa1yXUiqaEofMXnjDVj9YlVBLyDEUzpsZGXkiYtOUXrYW2hcGPUO9TVJFQuJFP9ZMoTu6XdPyd0JFCC+M0Mt7tBNTrEcp7n+jRWqhYQnj45hhnHqH8JVTpMTduRyElfpK1sDZh6IxU+NaJ8YtW+iKETSF+hCb9LtORtiHMeF+R5Beqd0Ro5SBV1okvv97evXoNEjyef/4HWe538u6UZlU/elf4bxbCkcrvC8vxTGISo3hw+ZYdEFKUEHq1vLeSCJc/X9HkFfsiVAzAcwLM8C1mLvKTT2UMxfNOQS8kP02zo2tCq+XcylBUJ3SEvDySMYMwTVH4IB2ECmuhpXIqJYTydmYQ6kCaDFElEf5YfcWp+D3HWhiPckJqpqso70hV/F6vH0DOhtCrVeJXSTFja5/n5/25d0LHrNyvvaK6n1OZASHI8acz/RBuZMfcWoTfVut5EGbEhITqQf1s3RCeAa0b9swfeTD/AAAAAElFTkSuQmCC"
}
}
- 登录接口
http://127.0.0.1:8080/demo/login
传入附加验证码参数 - 登录接口传入数据
json
{
"accountNo":"admin",
"password":"123456",
"code":"88e8d3552ed0d2b8467bc5e497614e69", //验证码临时code
"captcha":"4myn" //验证码值
}