第4节-如何给登录接口增加图片验证码？

本节介绍怎么给接口增加图片验证码功能，以登录接口为例：给登录接口增加图片验证码功能。

图片验证码功能只需要在网关中操作

1. 修改网关配置

网关支持验证码过滤器，通过配置启用

1.1 启动验证码过滤器

详细配置可以参考。验证码过滤器

wueasy:
  gateway:
    interceptor:
      captcha:
        enabled: true #是否启用，默认false
        items:
        - captcha-urls: #生成图片验证码url地址
          - /demo/captcha
          urls: #验证图片验证码url地址
          - /demo/login
          code-field-name: code #临时code的参数名称
          value-field-name: captcha #验证码值的参数名称
          parameter-type: body #参数类型

1.2 修改redis配置

验证码值保存在redis中，所以需要配置redis连接信息

wueasy :
  data:
    redis: #redis配置
      captcha: #验证码配置
        database : 1 #数据库索引（默认为0）
        host : 127.0.0.1 #服务器地址
        port : 6379 #服务器连接端口
        password : 123456  #服务器连接密码（默认为空）
        pool : #连接池配置
          maxIdle : 8 # 连接池中的最大空闲连接，默认值也是8。
          minIdle : 0 #连接池中的最小空闲连接，默认值也是0。
          maxTotal : 2000 # 如果赋值为-1，则表示不限制；如果pool已经分配了maxActive个jedis实例，则此时pool的状态为exhausted(耗尽)。
          maxWaitMillis : 1000 # 等待可用连接的最大时间，单位毫秒，默认值为-1，表示永不超时。如果超过等待时间，则直接抛出JedisConnectionException
        timeout : 3000 #连接超时时间（毫秒）

2. 启动服务

分别启动 注册中心、微服务、网关

3. 测试接口

3.1 生成验证码接口

• 接口地址：http://127.0.0.1:8088/demo/captcha
• 请求类型：GET
• 成功示例：

  {
    "errorNo":0,
    "data":
    {
        "code":"b386652047cbb9ec192ae95c35241c5b",
        "captcha":"data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAJYAAAAoCAIAAACTo5SwAAADR0lEQVR42u3ZO2tVQRAA4Pv3/Ak2FmJho3JFQTRgE4IRrSLRxgciXFAQBFExcBuxkUBA0lsIFysbTX0cGBiG2d05s8+cY3YYQtizlzw+Znd2z2LoMfNY9H9BJ+zRCXt0wk7YQ8Z684NnJ5wfnmWwE07UL/lpJ+yEp0T4fOuWm2V/vxcXH8Rmvt/q4V2ejRVv7++GsiShF68G5JkiVPAUyEUNv1KKSPL03JJnDT/OI/zaEBrxvIqLSn4u4eHHtZv6z/Ka6ZDFCRtsh7F+WYS6U+ipoqU8+vvmlbKuomKNdqZGCf48+cRz1E9nzlpIR5dKd8JoqXnneP3E1giKDQgPfr/DhKfwNQ0vNGhsWARkOqFlq6tK6K6oxde0Rzs3IRFv795lSHG0R067n/40yo8UWxOmLaQWwlClUnw+/kZp/BsRDyEhQ/cyFkXdDzGu792I8ss9VCQTprUzrlBUCQo2oyLVn9vLxCrWIHy/ektZgNC4F+YEKHJI0ZGKyZuDFSWA4Texis0IkY0ILT3qpa0ln0mKWYRtDvgISefC7Qt3MIWfSxWrKPx0wkxFvQRDfmImKuYeKhpc0FAJohyd/17++Qo56sQnRBGO/krGHdHbkXI/AWMpwXTCnKN9EUJxhEfC0Trz1mgbwtC5UOlFqxMqm2JVQu5HhGADipal0lKI9QhHb2Qs00DR9RsKvmyq6gdO3os0hOGK+YSkWNDv+MtK5JXta7GEkLkdaWazWrwEyxLe31nyLFWCCOa1AUUOmVyp0e2MZWssfmkSInTX0oS98NnmCFLcq+Fgvt/oWqoolic8lS7GQpjTkZKT+44JllMoR3cQb91qEEa9JqxFONQJhdDtS7mTrsvrzCXEBEVkwzR2OhZCWk4bEX44erx79TxmYz/vcUIQpt3OKCXICZU3iMl7IT3K9LMSgh+vQqE4VA6dEA/4aXekDQhDHalwTZCLIEQ/y2DV8Dp5x7+/3se0vKlQepbRpxOJ2RB6tbx+7ge9g6IjtQx2wgKE3MxdQhUqXZHMKIf5xJwIuZyx/qImzDTmR5gsdHYJXbAJ+nVCkyLlZP+YnL3w/yecSyR0pJ1wiooi9fmbJ78oO2HrWJ8c8oz9uMs2R8h/KSgBIDJqMCIAAAAASUVORK5CYII="
    }
  }
  

3.2 登录接口

由于在网关拦截器中设置了接口/demo/login需要验证 图片验证码，那么需要在参数中传入验证码

• 接口地址：http://127.0.0.1:8088/demo/login
• 请求类型：POST
• 请求参数：code验证码code参数，captcha验证码值 （和网关配置要保持一致）

  {
    "accountNo":"admin",
    "password":"123456",
    "code":"b386652047cbb9ec192ae95c35241c5b",
    "captcha":"9TLG"
  }
  

• 成功示例：

  {
    "errorNo": 0,
    "data": "bearer:1:35c8538dcfefab00d574cf2a48e93f96"
  }