1. jwt 简介
JSON web token (JWT), 是为了在网络应用环境间传递声明而执行的一种基于 JSON 的开放标准 ((RFC 7519). 该 token 被设计为紧凑且安全的, 特别适用于分布式站点的单点登录 (SSO) 场景. JWT 的声明一般被用来在身份提供者和服务提供者间传递被认证的用户身份信息, 以便于从资源服务器获取资源, 也可以增加一些额外的其它业务逻辑所必须的声明信息, 该 token 也可直接被用于认证, 也可被加密.
2. jwt 构成
jwt 就是一段字符串, 由三段信息构成的, 将这三段信息文本用. 链接在一起就构成了 jwt 字符串, 就像这样:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
第一部分我们称它为头部 (header), 第二部分我们称其为载荷 (payload, 类似于飞机上承载的物品), 第三部分是签证 (signature).
header
jwt 的头部承载两部分信息:
a. 声明类型, 这里是 jwt
b. 声明加密的算法, 通常直接使用 HMAC SHA256
完整的头部就像下面这样的 JSON:
- {
- 'typ': 'JWT',
- 'alg': 'HS256'
- }
然后将头部进行 base64 加密 (该加密是可以对称解密的), 构成了第一部分
- eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9
- payload
载荷就是存放有效信息的地方, 这个名字像是特指承载的货品, 这些有效信息包含三部分
a. 标准中注册的声明
b. 公共的声明
c. 私有的声明
标准中注册的声明 (建议但不强制使用)
iss: jwt 签发者
sub: jwt 所面向的用户
aud: 接收 jwt 的一方
exp: jwt 的过期时间, 这个过期时间必须要大于签发时间
nbf: 定义在什么时间之前, 该 jwt 都是不可用的
iat: jwt 的签发时间
jti: jwt 的唯一身份标识, 主要用来作为一次性 token, 从而回避重放 ***.
公共的声明:
公共的声明可以添加任何的信息, 一般添加用户的相关信息或其他业务需要的必要信息, 但不建议添加敏感信息, 因为该部分在客户端可解密
私有的声明:
私有声明是提供者和消费者所共同定义的声明, 一般不建议存放敏感信息, 因为 base64 是对称解密的, 意味着该部分信息可以归类为明文信息
定义一个 payload:
- {
- "sub": "1234567890",
- "name": "John Doe",
- "admin": true
- }
- signature
JWT 的第三部分是一个签证信息, 这个签证信息由三部分组成:
- header (base64 后的)
- payload (base64 后的)
- secret
这个部分需要 base64 加密后的 header 和 base64 加密后的 payload 使用. 连接组成的字符串, 然后通过 header 中声明的加密方式进行加盐 secret 组合加密, 然后就构成了 jwt 的第三部分.
- // JavaScript
- var encodedString = base64UrlEncode(header) + '.' + base64UrlEncode(payload);
- var signature = HMACSHA256(encodedString, 'secret'); // TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
将这三部分用. 连接成一个完整的字符串, 构成了最终的 jwt:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiYWRtaW4iOnRydWV9.TJVA95OrM7E2cBab30RMHrHDcEfxjoYZgeFONFh7HgQ
注意: secret 是保存在服务器端的, jwt 的签发生成也是在服务器端的, secret 就是用来进行 jwt 的签发和 jwt 的验证, 所以, 它就是你服务端的私钥, 在任何场景都不应该流露出去. 一旦客户端得知这个 secret, 那就意味着客户端是可以自我签发 jwt 了.
django-REST-framework-jw 文档网站
安装配置 JWT
1. 安装
pip install djangorestframework-jwt
2. 在配置文件 dev.py 中增加以下内容:
- REST_FRAMEWORK = {
- 'DEFAULT_AUTHENTICATION_CLASSES': (
- 'rest_framework_jwt.authentication.JSONWebTokenAuthentication',
- 'rest_framework.authentication.SessionAuthentication',
- 'rest_framework.authentication.BasicAuthentication',
- ),
- }
- import datetime
- JWT_AUTH = {
- 'JWT_EXPIRATION_DELTA': datetime.timedelta(days=1),
- }
JWT_EXPIRATION_DELTA 指明 token 的有效期
3. Django REST framework JWT 扩展的说明文档中提供了手动签发 JWT 的方法
- from rest_framework_jwt.settings import api_settings
- jwt_payload_handler = api_settings.JWT_PAYLOAD_HANDLER
- jwt_encode_handler = api_settings.JWT_ENCODE_HANDLER
- payload = jwt_payload_handler(user)
- token = jwt_encode_handler(payload)
在用户注册或者登录成功后, 在序列化器中返回用户信息以后同时返回 token 即可
4. Django REST framework JWT 提供了登录获取 token 的视图, 可以直接使用
在子路由中, 配置路由:
- from rest_framework_jwt.views import obtain_jwt_token
- urlpatterns = [
- path('login/', obtain_jwt_token),
- ]
5. 在主路由中, 引入当前子应用的路由文件
- urlpatterns = [
- path('users/', include("users.urls")),
- # include 的值必须是模块名. urls 格式, 字符串中间只能出现一个圆点
- ]
来源: http://www.bubuko.com/infodetail-3366112.html