接口安全11招，真香！

前言

最近知识星球中有位小伙伴问了我一个问题 ：如何保证接口的真香安全性？

根据我多年的工作经验  ，这篇文章从11个方面给大家介绍一下保证接口安全的接口一些小技巧，希望对你会有所帮助。安全

图片

1 参数校验

保证接口安全的真香第一步 ，也是接口最重要的一步
，需要对接口的安全请求参数做校验。

如果我们把接口请求参数的真香校验做好了，真的接口可以拦截大部分的云计算无效请求。

我们可以按如下步骤做校验
：

校验参数是安全否为空 ，有些接口中可能会包含多个参数，真香有些参数允许为空，接口有些参数不允许为空
，安全我们需要对这些参数做校验，真香防止接口底层出现异常
。接口校验参数类型，安全比如：age是int类型的 ，用户传入了一个字符串
："123abc"，这种情况参数不合法，需要被拦截 。校验参数的免费模板长度 ，特别是对于新增或者修改数据接口，必须要做参数长度的校验，否则超长了数据库会报异常
 。比如 ：数据库username字段长度是30，新用户注册时
，输入了超过30个字符的名称 ，需要提示用户名称超长了。虽说前端会校验字段长度，但接口对参数长度的校验也必不可少。校验枚举值，香港云服务器有些接口参数是枚举，比如：status，数据库中设计的该字段只有1、2
、3三个值。如果用户传入了4，则需要提示用户参数错误
 。校验数据范围，对于有些金额参数，需要校验数据范围，比如 ：单笔交易的money必须大于0 ，小于10000。

我们可以自己写代码  ，源码库对每个接口的请求参数一一做校验。

也可以使用一些第三方的校验框架
。

比如：hiberate的Validator框架，它里面包含了@Null 、@NotEmpty、@Size
 、@Max
、@Min等注解 。

用它们校验数据非常方便。

当然有些日期字段和枚举字段，可能需要通过自定义注解的方式实现参数校验
。

2 统一封装返回值

可能有些小伙伴认为，高防服务器对接口返回值统一封装是为了让代码更规范。

其实也是处于安全方面的考虑 。

假如有这样一种场景：你写的某个接口底层的sql
，在某种条件下有语法问题。某个用户请求接口之后，在访问数据库时，直接报了sql语法错误，将数据库名、表名、字段名、相关sql语句都打印出来了 。亿华云

此时，如果你的接口将这些异常信息直接返回给外网的用户，有些黑客拿着这些信息
，将参数做一些调整 ，拼接一些注入sql，可以对你的数据库发起攻击。

因此 ，非常有必要对接口的返回值做统一的封装。

例如下面这样 ：

复制{ "code":0, "message":null, "data":[{ "id":123,"name":"abc"}] }1.2.3.4.5.

该json返回值中定义了三个字段：

code ：表示响应码，0-成功，1-参数为空，2-参数错误，3-签名错误 4-请求超时 5-服务器内部错误等 。message：表示提示信息，如果请求成功，则返回空。如果请求失败，则返回我们专门在代码中处理过，让用户能看懂的错误信息
 。data：表示具体的数据 ，返回的是一个json字段
。

对返回值这样封装之后，即使在接口的底层出现了数据库的异常，也不会直接提示用户，给用户提示的是服务器内部错误 。

对返回值统一封装的工作 ，没有必要在业务代码中做，完全可以在放到API网关。

业务系统在出现异常时
，抛出业务异常的RuntimeException
，其中有个message字段定义异常信息。

所有的API接口都必须经过API网关 ，API网关捕获该业务异常 ，然后转换成统一的异常结构返回，这样能统一返回值结构。

3 做转义

在用户自定义输入框，用户可以输入任意内容 。

有些地方需要用html的格式显示用户输入的内容
，比如文章详情页或者合同详情页，用户可以自定义文案和样式。

这些地方如果我们不做处理，可能会遭受XSS（Cross Site Scripting）攻击 ，也就是跨站脚本攻击。

攻击者可以在输入的内容中 ，增加脚本，比如 ：<script>alert("反射型 XSS 攻击")</script> ，这样在访问合同详情页时，会弹出一个不需要的窗口，攻击者甚至可以引导用户访问一些恶意的链接 。

由此 ，我们需要对用户输入内容中的一些特殊标签做转义。

下面这张图中列出了需要转义的常见字符和转义后的字符：

图片

我们可以自定义一个转义注解
，打上该注解的字段 ，表示需要转义
。

有个专门的AOP拦截器，将用户的原始内容，转换成转义后的内容。

保存到数据库中是转义之后的内容 。

除此之外 ，为了防止SQL注入的情况，也需要将用户输入的参数做SQL语句方面的转义 。

关于SQL注入问题，可以参考我之前写的这篇文章 ：卧槽 ，sql注入竟然把我们的系统搞挂了

4 做权限控制

我们需要对接口做权限控制。

主要包含了下面3种情况。

4.1 校验是否登录

对于用些公共数据 ，比如：外部分类，所有人都能够看到，不用登录也能看到 。

对于这种接口
，则不用校验登录
。

而对于有些查看内部分类的接口 ，需要用户登录之后  ，才能访问 。

这种情况就需要校验登录了。

可以从当前用户上下文中获取用户信息 ，校验用户是否登录。

如果用户登录了，当前用户上下文中该用户的信息不为空 。

否则  ，如果用户没登录，则当前用户上下文中该用户的信息为空
。

4.2 接口功能权限控制

对于有些重要的接口 ，比如订单审核接口，只有拥有订单审核权限的运营账号，才有权限访问该接口。

我们需要对该接口做功能权限控制。

可以自定义一个权限注解，在注解上可以添加权限点。

在网关层有个拦截器，会根据当前请求的用户的权限，去跟请求的接口的权限做匹配 ，只有匹配上次允许访问该接口。

4.3 接口数据权限控制

对于有些订单查询接口，普通运营只能查看普通用户的数据 。

而运营经理可以查看普通用户和vip用户的数据 。

这种情况我们需要对该订单查询接口做数据权限控制。

不同的角色
，能够查看的数据范围不同
。

可以在查询数据时，在sql语句中动态拼接过滤数据权限的sql 。

5 加验证码

对于一些非常重要的接口，在做接口设计的时候，要考虑恶意用户刷接口的情况。

最早的用户注册接口，是需要用图形验证码校验的 ，比如下面这样的 ：

图片

用户只需要输入 ：账号名称、密码和验证码即可
，完成注册
。

其中账号名称作为用户的唯一标识。

但有些图形验证码比较简单
，很容易被一些暴力破解工具破解。

由此，要给图形验证码增加难道  ，增加一些干扰项 ，增加暴力破解工具的难道。

但有个问题是 
：如果图形验证码太复杂了 ，会对正常用户使用造成一点的困扰
，增加了用户注册的成本，让用户注册功能的效果会大打折扣。

因此，仅靠图形验证码
，防止用户注册接口被刷
，难道太大了 。

后来，又出现了一种移动滑块形式的图形验证方式 ，安全性更高。

图片

此外
，使用验证码比较多的地方是发手机短信的功能
。

发手机短信的功能，一般是购买的云服务厂商的短信服务 ，按次收费，比如：发一条短信0.1元
。

如果发送短信的接口
，不做限制，被用户恶意调用，可能会产生非常昂贵的费用 。

6 限流

上一节中提到的发送短信接口  ，只校验验证码还不够，还需要对用户请求做限流。

从页面上的验证码，只能限制当前页面的不能重复发短信 ，但如果用户刷新了页面 ，也可以重新发短信。

因此非常有必要在服务端 ，即：发送短信接口做限制。

我们可以增加一张短信发送表 。

该表包含 ：id、短信类型
、短信内容、手机号、发送时间等字段。

图片

有用户发送短信请求过来时：

先查询该手机号最近一次发送短信的记录如果没有发送过，则发送短信 。如果该手机号已经发送过短信 ，但发送时间跟当前时间比超过了60秒 ，则重新发送一条新的短信 。如果发送时间跟当前时间比没超过60秒，则直接提示用户操作太频繁，请稍后重试 。

这样就能非常有效的防止恶意用户刷短信的行为 。

但还是有漏洞。

比如：用户知道在60秒以内，是没法重复发短信的 。他有个程序，刚好每隔60秒发一条短信
。

这样1个手机号在一天内可以发：60*24 = 1440 条短信。

如果他有100个手机号 ，那么一天也可以刷你很多条短信 。

由此
，还需要限制每天同一个手机号可以发的短信次数  。

其实可以用redis来做。

用户发短信之后，在redis中保存一条记录，key是手机号，value是发短信的次数，过期时间是24小时 。

这样在发送短信之前
 ，要先查询一下 ，当天发送短信的次数是否超过10次（假设同一个手机号一天最多允许发10条短信）  。

如果超过10次
，则直接提示用户操作太频繁 ，请稍后重试。

如果没超过10次 ，则发送短信，并且把redis中该手机号对应的value值加1 。

短信发送接口完整的校验流程如下：

图片

7 加ip白名单

对于有些非常重要的基础性的接口，比如：会员系统的开通会员接口 ，业务系统可能会调用该接口开通会员 。

会员系统为了安全性考虑，在设计开通会员接口的时候，可能会加一个ip白名单，对非法的服务器请求进行拦截 。

这个ip白名单前期可以做成一个Apollo配置
，可以动态生效。

如果后期ip数量多了的话，可以直接保存到数据库 。

只有ip在白名单中的那些服务器 
，才允许调用开通会员接口。

这样即使开通会员接口地址和请求参数被泄露了，调用者的ip不在白名单上
，请求开通会员接口会直接失败。

除非调用者登录到了某一个白名单ip的对应的服务器  ，这种情况极少，因为一般运维会设置对访问器访问的防火墙。

当然如果用了Fegin这种走内部域名的方式访问接口，可以不用设置ip白名单 ，内部域名只有在公司的内部服务器之间访问，外面的用户根本访问不了 。

但对于一些第三方平台的接口 ，他们更多的是通过设置ip白名单的方式保证接口的安全性。

8 校验敏感词

对于某些用户可以自定义内容的接口，还需要对用户输入的内容做敏感词校验 。

比如 ：在创建商品页面 ，用户输入了 ：傻逼商品，结果直接显示到了商城的商品列表页面，这种情况肯定是不被允许的 。

当然你也可以做一个审核功能
，对用户创建的商品信息做人工审核，如果商品数量太多
，这样会浪费很多人力。

有个比较好的做法是
：对用户自定义的内容，做敏感词校验。

可以调用第三方平台的接口，也可以自己实现一个敏感词校验接口
。

可以在GitHub上下载一个开源的敏感词库，将那些敏感词导入到数据库中。

然后使用hanlp对用户输入的内容 ，进行分词。对分好的词，去匹配敏感词库中的那些敏感词。

如果匹配上了，则说明是敏感词  ，则验证不通过
。

如果没有匹配上，则说明非敏感词 ，则验证通过。

不可能在每个业务接口中都调用敏感词校验接口，我们可以自定义注解 ，在AOP拦截器中调用敏感词校验接口。

在调用业务接口之前，先触发拦截器，校验打了敏感词校验注解的那些字段
，将他们里面包含的内容
，作为入参传入敏感词校验接口做校验。

当然有时候hanlp分词器会把句子分错词，还需要添加一个敏感词的白名单 ，白名单中的词不是敏感词。

9 使用https协议

以前很多接口使用的是HTTP（HyperText Transport Protocol，即超文本传输协议）协议，它用于传输客户端和服务器端的数据
。

虽说HTTP使用很简单也很方便 ，但却存在以下3个致命问题：

使用明文通讯，内容容易被窃听。不验证通讯方的真实身份 ，容易遭到伪装。无法证明报文的完整性
，报文很容易被篡改。

为了解决HTTP协议的这些问题 ，出现了HTTPS协议。

HTTPS协议是在HTTP协议的基础上 ，添加了加密机制 ：

SSL
：它是Secure Socket Layer的缩写， 表示安全套接层 。TLS：它是Transport Layer Security的缩写 ，表示传输层安全 。

HTTPS = HTTP + 加密 + 认证 + 完整性保护。

为了安全性考虑，我们的接口如果能使用HTTPS协议，尽量少使用HTTP协议
。

如果你访问过一些大厂的网站，会发现他们提供的接口，都是使用的HTTPS协议
。

不过需要注意的地方是：HTTPS协议需要申请证书，有些额外的费用 。

10 数据加密

有些信息是用户的核心信息，比如 ：手机号、邮箱、密码、身份证、银行卡号等 ，不能别泄露出去。

在保存到数据库时，我们要将这些字段 ，做加密处理
。

后面即使这些数据被泄露了，获得数据的人，由于没有密钥 ，没办法解密。

这种情况可以使用AES对称加密的方式 
，因为后面系统的有些业务场景，需要把加密的数据解密出来。

为了安全性考虑，我们需要设置一个用于加密的密钥
，这个密钥可以稍微复杂一点 ，包含一些数字 、字母和特殊字符 。

我们同样可以通过自定义注解的方式  ，给需要加密的字段添加该注解 ，在Mybatis拦截器中实现加解密的功能 。

对于查询操作，需要将加了该注解的字段的数据做解密处理。

对于写入操作，要将加了该注解的字段的数据做加密处理。

有些页面显示的地方
，手机号一般不会显示完整的手机号，中间有一部分用*代替，比如 ：182***3457 。

这种情况需要做特殊处理
。

11 做风险控制

有些特殊的接口
，比如用户登录接口 ，我们需要对该接口做风险控制，尽可能减小被盗号的风险。

用户登录失败之后 ，需要有地方，比如：Redis ，记录用户登录失败的次数。

如果用户第一次输入账号密码登录时，出现的是一个稍微简单的验证码 。

如果用户把账号或密码连续输错3次之后 ，出现了更复杂的验证码 。

或者改成使用手机短信验证 。

如果用户在一天之内，把账号或密码连续输错10次 ，则直接锁定该账号。

这样处理是为了防止有人用一些软件 ，暴力破解账号和密码。

在用户登录成功之后 ，需要有一张表记录用户的ip 、所在城市和登录的设备id。

如果你的账号被盗了。

在盗号者在页面输入账号密码登录，会调用登录接口 ，此时登录接口中可以根据用户的ip和设备id，做一些风险控制
。

接口判断如果用户当前登录的ip、所在城市和设备ip，跟上一次登录成功时记录的相差非常大
。

比如：1小时之前
，用的ip是100.101.101.101，城市是北京 ，设备id是1001，而1小时之后，用的ip是200.202.202.101，城市是广州，设备id是2002。

这种情况用户的账号极有可能被盗了。

登录接口做安全性升级，需要校验用户手机验证码才能登录成功。

由于盗号者只有你的账号和密码，没有手机验证码，所以即使被盗号了
，也没办法登录成功。