Access Token 和 Refresh Token 的双令牌机制,维持登陆状态

目录


为了实现客户端在 JWT Token 过期后自动更新 Token,通常会采用 Access Token 和 Refresh Token 的双令牌机制。以下是实现自动更新 Token 的具体方法和流程:

1. 双令牌机制

  • Access Token:有效期较短(例如 15 分钟到 1 小时),用于客户端访问受保护的资源。
  • Refresh Token:有效期较长(例如 7 天到 30 天),用于刷新过期的 Access Token。

2. 工作流程

  1. 用户登录:

    • 用户提交用户名和密码给服务器。
    • 服务器验证成功后,生成 Access Token 和 Refresh Token。
    • Access Token 有较短的有效期,而 Refresh Token 有较长的有效期。
  2. Access Token 过期:

    • 当 Access Token 过期时,客户端在发送请求时会携带过期的 Access Token 和有效的 Refresh Token。
    • 客户端不需要让用户重新登录,而是使用 Refresh Token 向服务器请求刷新一个新的 Access Token。
    • 服务器验证 Refresh Token,如果有效,则生成新的 Access Token 和新的 Refresh Token(防止 Refresh Token 被盗用),并将它们返回给客户端。
    • 客户端用新的 Access Token 继续访问 API。
  3. Token 刷新失败:

    • 如果 Refresh Token 也过期,或者 Refresh Token 被篡改,服务器会要求用户重新登录。

3. 客户端实现

客户端需要在每次请求时检查 Access Token 是否过期,并在过期时自动使用 Refresh Token 请求新的 Access Token。以下是一个示例流程:

客户端请求逻辑

  1. 发送请求 :
    • 客户端发送请求时,携带 Access Token。
  2. 检查响应 :
    • 如果服务器返回 401 Unauthorized(表示 Access Token 过期),客户端自动使用 Refresh Token 请求新的 Access Token。
  3. 刷新 Token :
    • 客户端向服务器发送一个刷新请求,携带 Refresh Token。
    • 服务器验证 Refresh Token,如果有效,返回新的 Access Token 和新的 Refresh Token。
    • 客户端更新本地存储的 Access Token 和 Refresh Token,并重新发送之前失败的请求。

4. 服务器端实现

服务器端需要提供一个专门的接口用于刷新 Token。以下是一个示例:

python 复制代码
from flask import Flask, request, jsonify
import jwt
import datetime

app = Flask(__name__)
app.config['SECRET_KEY'] = 'your_secret_key_here'  # 替换为你的密钥

# 模拟用户数据库
users = {
    "user1": "password1",
    "user2": "password2"
}

def create_token(payload, expiry_minutes=60):
    """生成 Access Token"""
    expiry = datetime.datetime.utcnow() + datetime.timedelta(minutes=expiry_minutes)
    return jwt.encode(payload, app.config['SECRET_KEY'], algorithm='HS256')

def create_refresh_token(payload, expiry_days=7):
    """生成 Refresh Token"""
    expiry = datetime.datetime.utcnow() + datetime.timedelta(days=expiry_days)
    return jwt.encode(payload, app.config['SECRET_KEY'], algorithm='HS256')

@app.route('/login', methods=['POST'])
def login():
    # 获取请求中的用户名和密码
    username = request.json.get('username')
    password = request.json.get('password')

    # 验证用户名和密码
    if username not in users or users[username] != password:
        return jsonify({'error': 'Invalid username or password'}), 401

    # 生成 Access Token 和 Refresh Token
    access_token = create_token({"user_id": username})
    refresh_token = create_refresh_token({"user_id": username})

    # 返回 Token
    return jsonify({
        'access_token': access_token,
        'refresh_token': refresh_token
    })

@app.route('/token/refresh', methods=['POST']) # 刷新 Token 的接口
def refresh_token():
    refresh_token = request.json.get('refresh_token')
    if not refresh_token:
        return jsonify({'error': 'Refresh token is missing'}), 400

    try:
        # 解码 Refresh Token
        payload = jwt.decode(refresh_token, app.config['SECRET_KEY'], algorithms=['HS256'])
        user_id = payload['user_id']

        # 生成新的 Access Token 和 Refresh Token
        new_access_token = create_token({"user_id": user_id})
        new_refresh_token = create_refresh_token({"user_id": user_id})

        return jsonify({
            'access_token': new_access_token,
            'refresh_token': new_refresh_token
        })
    except jwt.ExpiredSignatureError:
        return jsonify({'error': 'Refresh token has expired'}), 401
    except jwt.InvalidTokenError:
        return jsonify({'error': 'Invalid refresh token'}), 401

if __name__ == '__main__':
    app.run(debug=True)

5. 注意事项

  • 安全性:确保 Refresh Token 的安全性,避免泄露。可以对 Refresh Token 的使用次数进行限制。
  • 用户体验:通过自动刷新机制,用户无需频繁重新登录,提升用户体验。
  • 存储方式:客户端可以将 Token 存储在本地,存储方式可以考虑SQLite 数据库、文件存储、Android Keystore、EncryptedSharedPreferences、SQLCiphe。
拓展:Token在客户端安全存储的几种方式

Token在客户端安全存储的几种方式

相关推荐
4SAPI4 小时前
多模型请求路由怎么设计?成本、速度和能力如何平衡
人工智能·python·gateway·php
XCDoris6 小时前
郴州logo设计机构
大数据·人工智能·python
gCode Teacher 格码致知7 小时前
Pandas教学-17:Series与Dataframe的关系
开发语言·python·pandas
撩得Android一次心动7 小时前
Jetpack Compose 知识点整理2【个人用】
android·笔记·学习·kotlin·compose
马良神笔8 小时前
2026 年Rag最近技术前沿总结
后端·python·django
不像程序员的程序媛8 小时前
maven基础
python·pycharm·maven
是真的小外套8 小时前
2024年软考中级信息安全工程师|选择题考点+案例分析真题解析(含答案)
android·网络
苏能润滑油油液文哥9 小时前
储能液冷安全边界解析:从热失控链条看冷却液的介入区间与选型指标
安全
xiaogai_gai9 小时前
仅查询策略实战:从金蝶云·星空旗舰版定时拉取收料通知单
大数据·数据库·python
benchmark_cc10 小时前
Python 量化系统如何设计统一的数据访问接口:从策略解耦到数据层架构
开发语言·python·数据分析·pandas·量化交易·股票数据·quantdash