接口安全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。

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

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

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