Flask 实现 Token 身份验证与装饰器校验详解
本文详细介绍在 Flask 框架中实现 Token 机制的完整流程。通过 Itsdangerous 库生成包含私钥、有效期和用户ID的加密 Token,并实现 Token 校验逻辑以获取用户信息。此外,利用 Python 装饰器封装登录校验逻辑,确保受保护接口必须携带有效 Token 才能访问,提供从生成到验证的完整代码示例。
Token 生成机制
Token 的生成
在前后端分离的开发模式中,使用 Token 进行身份校验是常见的交互方式。
Token 主要具备以下特性:
- 具有时效性,会失效。
- 经过加密处理,保证安全性。
- 解析后可获取关联的用户信息。
其生成方式通常结合内部配置的私钥、设定的有效期以及用户的唯一标识 ID。
#导入依赖包
from flask import request,jsonify,current_app
from itsdangerous import TimedJSONWebSignatureSerializer as Serializer
def create_token(api_user):
'''
生成token
:param api_user:用户id
:return: token
'''
#第一个参数是内部的私钥,这里写在共用的配置信息里了,如果只是测试可以写死
#第二个参数是有效期(秒)
s = Serializer(current_app.config["SECRET_KEY"],expires_in=3600)
#接收用户id转换与编码
token = s.dumps({"id":api_user}).decode("ascii")
return token
Token 校验流程
Token 的校验
系统接收前端传来的 Token 进行校验,若校验成功则返回对应用户信息,否则返回 None。
#基于上面的基础再导入用户的模型类
from app.model import User
def verify_token(token):
'''
校验token
:param token:
:return: 用户信息 or None
'''
#参数为私有秘钥,跟上面方法的秘钥保持一致
s = Serializer(current_app.config["SECRET_KEY"])
try:
#转换为字典
data = s.loads(token)
except Exception:
return None
#拿到转换后的数据,根据模型类去数据库查询用户信息
user = User.query.get(data["id"])
return user
登录校验装饰器实现
通过定义装饰器,强制要求特定接口必须携带 Token 进行校验。
对于大量需要登录状态才能操作的接口,最佳实践是编写一个通用的登录校验装饰器,并将其添加到所需的 API 路由上。
#在上面的基础上导入
import functools
def login_required(view_func):
@functools.wraps(view_func)
def verify_token(*args,**kwargs):
try:
#在请求头上拿到token
token = request.headers["z-token"]
except Exception:
#没接收的到token,给前端抛出错误
#这里的code推荐写一个文件统一管理。这里为了看着直观就先写死了。
return jsonify(code = 4103,msg = '缺少参数token')
s = Serializer(current_app.config["SECRET_KEY"])
try:
s.loads(token)
except Exception:
return jsonify(code = 4101,msg = "登录已过期")
return view_func(*args,**kwargs)
return verify_token
完整使用案例
使用案例
Token 生成示例
#此处的api是蓝图的对象
from . import api
from app.model import User,db
from flask import request,jsonify
#导入刚刚写的文件方法
from app.utils.common import create_token,login_required,verify_token
@api.route("/login",methods=["POST"])
def login():
'''
用户登录
:return:token
'''
res_dir = request.get_json()
if res_dir is None:
#这里的code,依然推荐用一个文件管理状态
return jsonify(code = 4103,msg = "未接收到参数")
#获取前端传过来的参数
phone = res_dir.get("phone")
password = res_dir.get("password")
#校验参数
if not all([phone,password]):
return jsonify(code=4103, msg="请填写手机号或密码")
if not re.match(r"1[23456789]\d{9}",phone):
return jsonify(code=4103,msg="手机号有误")
try:
user = User.query.filter_by(phone=phone).first()
except Exception:
return jsonify(code=4004,msg="获取信息失败")
if user is None or not user.check_password(password):
return jsonify(code=4103,msg="手机号或密码错误")
#获取用户id,传入生成token的方法,并接收返回的token
token = create_token(user.id)
#把token返回给前端
return jsonify(code=0,msg="成功",data=token)
必须登录的校验逻辑与根据 Token 获取用户信息的示例
@api.route("/user/detail")
@login_required #必须登录的装饰器校验
def userInfo():
'''
用户信息
:return:data
'''
token = request.headers["z-token"]
#拿到token,去换取用户信息
user = verify_token(token)
data = {
"phone":user.phone,
"name":user.name,
"head_portrait":user.head_portrait,
"intro":user.intro,
"level":user.level
}
return jsonify(code=0,msg="成功",data=data)
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持本站。
本站声明
本文内容仅供参考,不代表本站观点。转载或引用请注明出处。如发现内容问题,请通过联系我们页面反馈。













