API鉴权是保证API安全性和可用性的一项重要措施。通过API鉴权,系统可以对用户或者应用进行有效的身份认证和权限管理。
除了我们之前更新的 Basic Auth 鉴权插件,这次给大家带来 JWT 鉴权插件。
JSON Web Token是一种开放标准,可以让服务器生成一个密钥签名的Token,该Token包含用户、其角色和过期时间等信息。JWT Token会发送回客户端,然后传递到后续的API请求中,以对接下来的操作进行认证和授权。
如何使用
在插件市场中找到 JWT 插件,安装
安装插件后,测试页面选中鉴权,填入数据后会自动在请求信息中添加头部 Authorization
。
JWT 说明
Client Request GET /security/somethings HTTP/1.1 Authorization: Basic bmFtZTpwYXNzd29yZA==
包括:
头部
{ "alg": "HS256", "typ": "JWT" }
Payload
{ "name": "Postcat", "introduce": "An extensible API tool." }
WT 规定了 7 个默认字段供开发者选用。
- iss (issuer):签发人
- exp (expiration time):过期时间
- sub (subject):主题
- aud (audience):受众,相当于接受者
- nbf (Not Before):生效的起始时间
- iat (Issued At):签发时间
- jti (JWT ID):编号,唯一标识
签名 Signature
对于每种加密算法,签名都对应的一个计算公式。例如 SHA256 加密算法的签名如下:
HMACSHA256( base64UrlEncode(header) + "." + base64UrlEncode(payload) + "." + Secret )
后续我们还会继续更新其他鉴权插件,欢迎关注!
这个项目是开源的,感兴趣的话可以给项目 Star 和 fork 一下
Github:
https://github.com/Postcatlab/postcat
Gitee:
https://gitee.com/eolink_admin/postcat
关于 Postcat
Postcat 是开源的 API 管理工具,有 API 相关的核心功能,还有丰富的插件广场,帮你快速地完成 API 的发布和测试功能。
核心功能:
- API 文档管理,可视化 API 设计,生成 API 文档
- API 测试, 自动生成测试参数,自动生成测试用例,可视化数据编辑
- Mock,根据文档自动生成 Mock,或创建自定义 Mock 满足复杂场景
- 插件拓展,众多插件扩展产品功能,打造属于你和团队的 API 开发平台
- 团队协作,既能实现API 分享也能可以创建云空间共同协作
突出亮点:
- 免登录即可测试,省去繁琐的验证登录的操作
- 界面简洁,没有冗余的功能与复杂选项
- 开源,免费,适合个人以及小团队使用
- 丰富的插件,支持数据迁移、主题、API 安全等高达 22 款插件
- 国产,能更好的理解国内用户的需求,沟通无障碍
- 完善的用户文档,跟着操作就能快速上手