如何为网站设计安全的API访问?
我们在设计一个网站或平台的时候,经常需要向用户开放API访问。
这样用户就可以程序化地调用一些功能,举几个例子:
- 交易所开放API让用户可以进行低时延的程序化交易,
- 微信公众号平台开放API让三方工具进行运营管理工作,
- Stripe开放API让商家和其他平台能很好地集成支付功能。
当我们向用户开放API访问时,我们需要确保每次API调用都经过鉴权。
这意味着我们需要确认用户是他们所声称的身份。
我们一般使用两种常见的方法来进行鉴权:
- 基于令牌的身份验证
- HMAC(基于哈希的消息验证码)验证
下图说明了它们的工作原理。
1、基于令牌
第1步
用户在客户端输入密码,然后客户端将密码发送到鉴权服务器。
第2步
鉴权服务器验证密码并生成一个有有效期的令牌。
第3步和第4步
现在,客户端可以发送请求,使用HTTP头中带有的令牌访问服务器资源。
这种访问在令牌过期前一直有效。
2、基于 HMAC
这种机制通过使用哈希函数(SHA256 或 MD5)生成消息验证码(签名)。
第1步和第2步
服务器生成两个密钥,一个是公共APP ID(公钥),另一个是 API Key(私钥)。
第3步
现在我们在客户端生成一个HMAC 签名(hmac A),该签名是根据图中列出的一组字段生成的。
注意这里会加入请求的时间戳,这样一个HMAC签名是有有效期的,不会一直有效。
第4步
客户端发送请求来访问服务器资源,HTTP头中包含hmac A。
第5步
服务器收到包含请求数据和鉴权标头的请求。
它从请求中提取必要的字段,并使用存储在服务器端的API Key 生成签名(hmac B)。
第6步和第7步
服务器会比较hmac A(在客户端生成)和hmac B(在服务器端生成)。
如果两者匹配,请求的资源将返回给客户端。