导读

本文主要基于京东物流的分拣业务平台在生产环境遇到的一些安全类问题，进行定位并采取合适的解决方案进行安全治理，引出对行业内不同业务领域、不同类型系统的安全治理方案的探究，最后笔者也基于自己在金融领域的经验进行了关于 API 网关治理方案的分享。

写在前面

随着互联网应用的多元化、复杂化、服务化成为显著趋势，越来越多场景中的应用架构采用应用编程接口（API）作为应用间数据传输和控制流程。同时 API 接口负责传输数据的数据量以及敏感性也在增加。因此针对 API 的攻击变得越来越频繁和复杂，成为当今不少公司的头号安全威胁。

根据 API 安全服务提供商 Salt Security 的最新报告，近 66%的企业缺乏基本 API 安全策略。在过去的几年时间里，市场上已经看到了 API 面临的风险和攻击的巨大增长，不仅出现了 Facebook、T-Mobile 等公司的 API 违规事件，也出现了美国邮政服务（USPS）和 Google+的最新漏洞泄露事件。

这给我们敲响了警钟：安全无小事，研发需谨慎！

一、背景

2022 年 2 月 14 日接收到某 A 分拣中心一线同事反馈：出现部分解封车无下文的货物在 9 号至 13 号之间出现自动验货情况，经询问该分拣中心场地一线人员均未对其验货。

二、发现问题

2.1 锁定实操报文

查询系统日志，根据运单号 JDV0055896869XX 定位具体请求报文：

图 1 验货实操请求日志

2.2 确定 IP

查询 nginx 日志，定位请求 IP：

图 2 nginx 日志

2.3 确认场地

根据集团自研的运维保障统一管理平台-终端探测功能，依据 ip 定位出场地来源：

图 3 终端探测链路

2.4 定位主机

查看路由信息，根据 ip 和主机绑定关系，定位主机设备：

图 4 路由信息

图 5 主机信息

2.5 得出结论

某 B 分拣中心使用 HB-TZFJ-33257A 此电脑在 2022 年 2 月 13 日 17 点 55 分左右使用脚本工具，伪装了 HTTP 请求报文，将某 B 分拣中心部分解封车无下文的货物验货至某 A 分拣中心，构成恶意分拣，使得 B 分拣中心考核数据转嫁到 A 分拣中心。

为什么会这样呢？

由于历史发展原因，分拣 pda 存在 wince 和 android 两个版本，由于 wince 版本可扩展性较差、设备成本较高等原因，计划逐步下线 wince 版本。wince 版本没有接入物流网关，调用的传统的 rest 服务，这块未对 wince 设备访问进行校验拦截，存在漏洞。

最终综合考量未来的推广发展和整改成本等原因，wince 版本不再接入物流网关，只在原有的架构设计上增加一层鉴权拦截机制，既保证小部分用户安全过渡使用，又节省了一定的系统改动成本。

三、解决过程

基于 sha256 摘要算法为服务端 RestAPI 增加鉴权逻辑，防止非法请求。

具体细节：客户端需要在请求头中携带以下字段信息：

• registerNo-设备或者是身份识别码

• signation 序列号

• siteCode 调用方设备或者是用户所属站点

• timestamp 时间戳

• noceno 随机序列

• opCode 操作码

• authorization 签名

registerNo 和 siteCode 为调用方身份信息，需要预先在分拣管理系统中进行注册获取，客户端基于 header 中的字段和 body 信息排序封装，携带 salt 值做 sha256 摘要计算，得到摘要结果作为 authorization 签名信息，和其他字段一起上送给服务端。服务端接收到请求后，基于同样的算法做 sha256 摘要计算，如果得到的签名信息跟客户端传输的一样即验证通过，否则为非法请求。

之所以采用这种鉴权方案是因为摘要算法性能较高，满足当前的安全需要，且考虑到升级实施的便捷性（目前客户端有很多版本：android 和 wince 设备）最终选择了此方案。上线鉴权功能后，未携带鉴权逻辑的请求被拦截，系统安全问题得到很好的解决，并且可以根据日志快速定位非法请求来源。

四、行业方案鉴析

行业内关于 API 鉴权的方案有很多种，笔者基于自己的工作经验梳理了以下三类应用场景：

4.1 B-S 架构类系统（网站类）

这类大多以 cookie+session 或 token 机制为多，实现一些登录会话等安全管理功能。

4.1.1 cookie+session 机制

cookie + session 是最传统的 API 鉴权方式，比如很多网站的登录模块就是靠这种方式实现会话管理。在服务端会生成一个 session 来保存会话状态，各个 session 是通过唯一的 session_id 来标识的，session_id 会在响应前端请求时返回给前端，前端将其保存在 cookie 中，后续的所有请求都会携带 cookie 传到服务器端，服务器端解析 cookie 后找到对应的 session 进行判断是哪个客户端发起的。

其优点是：

• 比较传统，对开发来说资料较多，语言支持完善。

• 较易于扩展，外部 session 存储方案已经非常成熟了（比如 Redis）。

缺点是：

• 性能相于较低：每一个用户经过后端应用认证之后，后端应用都要在服务端做一次记录，以方便用户下次请求的鉴别，通常而言 session 都是保存在内存中，而随着认证用户的增多，服务端的开销会明显增大。

• 因为基于 cookie 来进行用户识别, cookie 如果被截获，用户就会很容易受到 CSRF 攻击；用户如果禁用了浏览器 cookie，这套机制就不再适用。

• 很难跨平台：在移动应用上 session 和 cookie 很难行通，你无法与移动终端共享服务器创建的 session 和 cookie。

总的来说，如果是传统的 web 网站，且同时认证的人数不是足够大（比如只是内部使用）的都可以用这种方式，很多网站依旧采用该方式。

4.1.2 token 机制

token 令牌机制是用来代替 session 的鉴权方案，现在很多 API 的鉴权都是通过 token 机制。token 机制是服务器端生成的一串加密串发放给客户端，客户端请求服务器端所有资源时会带上这个 token，由服务器端来校验这个 token 的合法性。其具有无状态、适合分布式、扩展性好、性能高和安全性好等优点。

4.2 C-S 架构类系统（客户端-服务器）

这类大多以摘要算法和加密算法的为主。

4.2.1 摘要算法

消息摘要算法也被称为散列算法或哈希（Hash）算法。任何消息经过散列函数处理后，都会获得唯一的散列值，这一过程称为 “消息摘要”，其散列值称为 “数字指纹”，如果其数字指纹一致，就说明其消息是一致的。

主流摘要算法有 md5 和 sha 系列，sha 系列也分为 sha1 和 sha2 系列（包含 sha-224、sha-256、sha-384 和 sha-512）。md5 与 sha 系列有啥不区别呢？算法核心过程大同小异，输出的摘要信息位数不同，MD5 的摘要的长度是 128bit，SHA-1 摘要长度 160bit。多出 32bit 意味着什么呢？不同明文的碰撞几率降低了 2^32 = 324294967296 倍，从而提高了安全性，安全性的提高是以牺牲性能为代价的。

md5 把 128bit 的信息摘要分成 A，B，C，D 四段（Words），每段 32bit，在循环过程中交替运算 A，B，C，D，最终组成 128bit 的摘要结果。

图 6 md5 计算过程

sha-1 算法核心过程大同小异，主要的不同点是把 160bit 的信息摘要分成了 A，B，C，D，E 五段。

图 7 sha-1 计算过程

sha-2 系列算法，核心过程更复杂一些，把信息摘要分成了 A，B，C，D，E，F，G，H 八段。

图 8 sha-2 计算过程

信息摘要越长，发生碰撞的几率就越低，破解的难度就越大。但同时，耗费的性能和占用的空间也就越高。没有最好，根据实际所需性能和安全性做选择即可。摘要算法由于其单向不可逆性，经常用在验证文件完整性（比如代码的版本比对）和存储系统用户密码口令等场景。

4.2.2 加密算法

加密算法通常分为两大类：“对称式”加密和“非对称式”加密。

对称加密就是加密和解密使用同一个密钥。非对称加密就是加密和解密所使用的不是同一个密钥，通常有两把钥匙，称为“公钥”（Public Key）和“私钥”（Private Key），它们两个必需配对使用，否则不能打开加密文件。

这里的“公钥”是指可以对外公布的，“私钥”则不能，只能由持有人一个人知道。它的优越性就在这里，因为对称式加密加解密公用一套密钥，需要将密钥告诉对方，一旦传输密钥，不管用什么方法都有可能被别人窃听到。而非对称式的加密方法有两个密钥，且其中的“公钥”是可以公开的，即使泄露也只是泄露一部分数据权限，私钥只有持有人自己保存，数据的权限还是得以控制，这样就很好地避免了因密钥的传输安全问题。

4.3 开放平台（open API）

1. 安全系数较高的场景（支付、资金下发等）以数字签名为主。

2. 安全系数不是很高的场景（查询用户信息等）以 accessToken 机制为主。具体流程为应用需要基于平台分配的 AppId 和 AppSecret 获取一个 accessToken（缓存在本地，需要定期刷新），后续请求接口带上 accessToken 即可，这样对于安全系数没有那么高的接口不需要每次都走加解密的逻辑，提高性能。

4.3.1 数字签名

数字签名是摘要算法与非对称加密算法的综合应用。客户端（请求端）和服务端（接收端）各自持有一对密钥（这里面有两套密钥），各自把自己的公钥给对方，自己持有私钥。请求方先对报文做摘要获取签名信息，然后使用自己的私钥对摘要信息加密（这个过程称之为加签），接收方使用请求方的公钥进行验签，同理接收方处理完业务响应时也是用自己的私钥加签，数据响应给请求方后，请求方也是使用接收方的公钥进行验签。这种算法在开放平台(尤其以微信、支付宝为代表的支付类平台)的 API 安全设计中较为广泛使用。

支付开放平台目前主流的两种签名算法：

五、自身实践经历

5.1 背景介绍

笔者之前一直在金融支付相关业务领域从事研发工作，参与过 2c 的钱包 app 应用、2b 的资金下发 saas 系统以及资金下发开放平台等相关系统的 API 设计与研发工作。下面以资金下发开放平台为例具体谈一下 API 安全方面的建设。

先说一下何为开放平台：概括来讲就是企业基于自己的业务生态（或者说基于自己的业务 sop）进行能力沉淀，以 API 的形式进行开放，供第三方开发者（个人或者企业）使用（开发者将能力集成到自己的应用之中，达到赋能的目的），这种行为称之为 Open API，提供开放 API 的企业/平台称之为开放平台。

资金下发开放平台是基于薪资下发 SOP（标准业务流程）进行能力沉淀，以 API 的形式对外开放，便于企业将薪资下发的能力集成到自己的应用之中，从而具备下发薪资能力。资金下发开放平台整体采用 API GateWay 的架构设计。

5.2 API 网关整体架构

图 9 API GateWay 架构设计

API 网关采用 pipeline（责任链模式）实现网关的核心处理流程，将每个处理逻辑看成一个 pipe，每个 pipe 处理一件事情。这样无论增加处理逻辑还是增加不同协议的服务，仅需新增一个 pipe 到调度逻辑，想要禁用某个 pipe，也能静态或者动态排除它，即可插拔性。客户端请求过来之后通过 pipeline 实现鉴权、访问控制、流控以及分流等一系列的前置逻辑。底层容器基于 netty 实现，对外暴露统一采用 http 协议，请求由容器线程池处理，之后分发到应用线程池异步处理。应用线程池在设计之初考虑不同类型的任务可能会出现耗时不一的情况，所以将任务拆分到不同的线程池以做隔离，提高不同类型任务的并发度，从而提高整体的吞吐。

5.3 选择网关的原因

为什么采用 API GateWay 的设计呢？核心有三点考虑

1.隔离性

隔离是对企业系统安全的一种保护，由于 API 是在边界提供给企业组织之间或企业外部进行访问的，因此保证企业系统不受有威胁的访问是 API 的首要责任。API 网关在安全方面实现了将安全访问控制能力从应用程序中剥离至 API 网关，实现了安全隔离。

2.解耦性

服务的提供者往往希望服务具有始终稳定的服务提供能力，因此往往不希望受到太多的外部功能需求的干扰，但是业务的快速发展决定了业务访问方的需求是多变的，因此通过在服务提供方与服务访问方之间设置一个中间层，通过该层封装不同的业务访问请求并按照统一的服务提供方要求进行转化并访问。通过这样一个中间层，将两个完全不同诉求的双方有效的调和起来，实现解耦。

3.扩展性

从位置与形态上看，API GateWay 类似 proxy 的角色，除了负责请求的接收、路由、响应外，还可以执行诸如流量控制、日志管理、安全控制等。由于业务可能快速变化，如果核心业务功能无法在某些方面快速实现需求，API GateWay 可以通过插件化的设计实现自定义功能的快速扩展，来适应业务灵活多变的需求。

5.4 网关在安全方面的建设

应用接入平台时，需要平台给应用分配 appId 和 appSecret，设置安全规则（加密方式），主要是以摘要算法 sha256（加盐）和数字签名 sha256WithRsa 两种鉴权方式，然后分配资源（接口）权限以及接口限流和白名单等相关的配置。然后接入方按照相应的加密规则进行封装报文请求调试接口，进行接入即可。

具体细节：

1. ip 白名单：ip 白名单是指将接口的访问权限对部分 ip 进行开放，这样就能避免其他 ip 进行访问攻击。

2. 时间戳：请求报文携带时间戳跟服务器当前时间进行对比若超过规定阈值直接被拦截。

3. 随机序列：在时间戳有效范围内不允许重复，时间戳+随机序列有效解决了重放问题。

4. 接口限流：对服务端资源进行保护。

以 sha256WithRsa 为例：请求端携带业务字段、appId、随机序列、时间戳等字段做排序，再做 sha256 摘要计算，然后使用自己的私钥对摘要结果进行 Rsa 加密得到 sign（这个过程称之为加签），将签名结果和其他字段一起封装传输给服务端。服务端接收到后先对时间戳、随机序列、ip 进行校验，校验通过后使用请求方的公钥进行验签，验签通过后，进行业务流程，业务处理完毕将响应数据做 sha256，再使用私钥对摘要数据做 Rsa 加密得到 sign，和业务报文一起响应给请求方，请求方以同样的方式验签处理数据。整个请求-响应的安全流程机制就是这样。

5.5 小结

API 网关不仅仅是针对安全方面的解决方案，更多的是对 API 治理的一种综合解决方案，集安全性、隔离性、可扩展性等多方面的综合考量，是一种企业级 API 治理的通用解决方案。

写在最后

本文结合实际业务痛点对系统存在的安全风险漏洞进行了整改，以及落地验证解决问题，继而对行业安全方案进行对比鉴析，并且结合之前的工作经历探讨了一些关于 API 安全的架构设计。它可能并不全面，或者说并不完全适用所有的情况，但本文的意义更多是起到抛砖引玉的效果，启发大家对 API 安全的思考，唤醒对 API 安全的意识。

作者：京东物流 魏晓峰

来源：京东云开发者社区 自猿其说 Tech 转载请注明来源