Django实现接口token检测的实现方案

百锦再2026-02-26 18:01

目录

    • **一、Token认证的实现思路**
    • **二、环境准备**
    • [**三、基于 Django REST Framework（DRF）的 Token 认证**](#三、基于 Django REST Framework（DRF）的 Token 认证)
      • [**1. 安装 Django REST framework**](#1. 安装 Django REST framework)
      • [**2. 添加到 Django 配置**](#2. 添加到 Django 配置)
      • [**3. 生成 Token 表**](#3. 生成 Token 表)
      • [**4. 创建 API 视图**](#4. 创建 API 视图)
      • [**5. 保护 API 端点**](#5. 保护 API 端点)
      • [**6. 测试 API**](#6. 测试 API)
    • [**四、自定义 Token 认证方案**](#四、自定义 Token 认证方案)
      • [**1. 自定义 Token 模型**](#1. 自定义 Token 模型)
      • [**2. 创建 Token 生成逻辑**](#2. 创建 Token 生成逻辑)
      • [**3. 中间件拦截 Token**](#3. 中间件拦截 Token)
      • [**4. 受保护的 API**](#4. 受保护的 API)
      • [**5. 测试**](#5. 测试)
    • **五、总结**

一、Token认证的实现思路

  1. 用户登录后生成Token：用户登录成功后，服务器生成一个Token，并返回给客户端。
  2. 客户端请求时携带Token：客户端在每次请求时，将Token放入HTTP请求头（Headers）中。
  3. 服务器端验证Token：Django后端解析请求中的Token，并验证其合法性。
  4. Token校验通过，允许访问接口；否则，返回未授权的错误信息。

二、环境准备

在Django项目中，我们可以使用rest_framework.authtoken或者自定义Token认证逻辑。这里介绍两种方式：

  1. 基于 Django REST framework（DRF） 的 Token 认证
  2. 自定义 Token 认证

三、基于 Django REST Framework（DRF）的 Token 认证

Django REST Framework 提供了现成的 Token 认证机制，下面是实现步骤。

1. 安装 Django REST framework

如果还未安装 Django REST framework，请使用 pip 安装：

sh 复制代码 
pip install djangorestframework
pip install djangorestframework.authtoken

2. 添加到 Django 配置

在 settings.py 中启用 Django REST framework 和 Token 认证：

python 复制代码 
INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'rest_framework',
    'rest_framework.authtoken',
]

REST_FRAMEWORK = {
    'DEFAULT_AUTHENTICATION_CLASSES': (
        'rest_framework.authentication.TokenAuthentication',
    ),
    'DEFAULT_PERMISSION_CLASSES': (
        'rest_framework.permissions.IsAuthenticated',
    ),
}

3. 生成 Token 表

运行 Django 迁移命令，创建 Token 认证所需的数据表：

sh 复制代码 
python manage.py migrate

4. 创建 API 视图

创建用户登录接口，生成并返回 Token。

python 复制代码 
from django.contrib.auth import authenticate
from rest_framework.authtoken.models import Token
from rest_framework.response import Response
from rest_framework.views import APIView
from rest_framework import status

class LoginView(APIView):
    def post(self, request):
        username = request.data.get("username")
        password = request.data.get("password")
        user = authenticate(username=username, password=password)
        if user:
            token, created = Token.objects.get_or_create(user=user)
            return Response({"token": token.key})
        return Response({"error": "Invalid Credentials"}, status=status.HTTP_401_UNAUTHORIZED)

5. 保护 API 端点

在 API 视图中使用 TokenAuthentication 保护 API，仅允许持有有效 Token 的用户访问：

python 复制代码 
from rest_framework.authentication import TokenAuthentication
from rest_framework.permissions import IsAuthenticated
from rest_framework.views import APIView
from rest_framework.response import Response

class ProtectedView(APIView):
    authentication_classes = [TokenAuthentication]
    permission_classes = [IsAuthenticated]

    def get(self, request):
        return Response({"message": "You have access to this protected endpoint."})

6. 测试 API

  1. 获取 Token：

    sh 复制代码 
    curl -X POST http://127.0.0.1:8000/api/login/ -H "Content-Type: application/json" -d '{"username": "admin", "password": "password"}'

    服务器返回：

    json 复制代码 
    {"token": "abc123xyz456"}

  2. 访问受保护的 API：

    sh 复制代码 
    curl -X GET http://127.0.0.1:8000/api/protected/ -H "Authorization: Token abc123xyz456"

    服务器返回：

    json 复制代码 
    {"message": "You have access to this protected endpoint."}

四、自定义 Token 认证方案

如果不使用 DRF 自带的 TokenAuthentication，我们也可以自定义 Token 认证。

1. 自定义 Token 模型

在 models.py 中创建 Token 存储表：

python 复制代码 
from django.db import models
from django.contrib.auth.models import User
import uuid

class CustomToken(models.Model):
    user = models.OneToOneField(User, on_delete=models.CASCADE)
    key = models.CharField(max_length=255, unique=True, default=uuid.uuid4)
    created_at = models.DateTimeField(auto_now_add=True)

    def __str__(self):
        return self.key

2. 创建 Token 生成逻辑

在 views.py 中定义登录逻辑，生成自定义 Token：

python 复制代码 
from django.contrib.auth import authenticate
from django.http import JsonResponse
from .models import CustomToken

def custom_login(request):
    if request.method == "POST":
        username = request.POST.get("username")
        password = request.POST.get("password")
        user = authenticate(username=username, password=password)

        if user:
            token, created = CustomToken.objects.get_or_create(user=user)
            return JsonResponse({"token": token.key})
        return JsonResponse({"error": "Invalid credentials"}, status=401)

3. 中间件拦截 Token

在 middleware.py 中定义 Token 验证逻辑：

python 复制代码 
from django.http import JsonResponse
from .models import CustomToken

class TokenMiddleware:
    def __init__(self, get_response):
        self.get_response = get_response

    def __call__(self, request):
        token = request.headers.get("Authorization")

        if not token:
            return JsonResponse({"error": "Token missing"}, status=401)

        try:
            user_token = CustomToken.objects.get(key=token)
            request.user = user_token.user
        except CustomToken.DoesNotExist:
            return JsonResponse({"error": "Invalid token"}, status=401)

        return self.get_response(request)

然后，在 settings.py 中启用中间件：

python 复制代码 
MIDDLEWARE = [
    'django.middleware.security.SecurityMiddleware',
    'django.contrib.sessions.middleware.SessionMiddleware',
    'django.middleware.common.CommonMiddleware',
    'django.middleware.csrf.CsrfViewMiddleware',
    'django.middleware.authentication.AuthenticationMiddleware',
    'django.contrib.messages.middleware.MessageMiddleware',
    'django.middleware.clickjacking.XFrameOptionsMiddleware',
    'myapp.middleware.TokenMiddleware',  # 添加自定义 Token 认证中间件
]

4. 受保护的 API

在 views.py 中定义需要 Token 认证的接口：

python 复制代码 
from django.http import JsonResponse

def protected_view(request):
    return JsonResponse({"message": "Welcome, you are authenticated!"})

5. 测试

  1. 获取 Token：

    sh 复制代码 
    curl -X POST http://127.0.0.1:8000/custom_login/ -d "username=admin&password=admin"

    返回：

    json 复制代码 
    {"token": "abc123xyz456"}

  2. 访问受保护 API：

    sh 复制代码 
    curl -X GET http://127.0.0.1:8000/protected_view/ -H "Authorization: abc123xyz456"

    返回：

    json 复制代码 
    {"message": "Welcome, you are authenticated!"}

五、总结

本方案介绍了 Django 中实现接口 Token 认证的两种方法：

  1. 使用 Django REST framework（DRF）的 Token 认证：适用于 REST API，简单易用。
  2. 自定义 Token 认证：适用于更灵活的需求，可定制 Token 规则、过期策略等。

以上代码和步骤确保了 API 的安全性，避免未经授权的访问，适用于 Django Web 项目的用户身份验证。

相关推荐
QQ4022054961 小时前
Python+django+vue3预制菜半成品配菜平台
开发语言·python·django
starlaky1 小时前
Django入门笔记
笔记·django
QQ5110082851 小时前
python+springboot+django/flask的校园资料分享系统
spring boot·python·django·flask·node.js·php
QQ_19632884751 小时前
Python-flask框架西山区家政服务评价系统网站设计与开发-Pycharm django
python·pycharm·flask
WeiXin_DZbishe1 小时前
基于django在线音乐数据采集的设计与实现-计算机毕设 附源码 22647
javascript·spring boot·mysql·django·node.js·php·html5
B站计算机毕业设计超人1 小时前
计算机毕业设计Django+Vue.js高考推荐系统 高考可视化 大数据毕业设计(源码+LW文档+PPT+详细讲解)
大数据·vue.js·hadoop·django·毕业设计·课程设计·推荐算法
遥遥江上月1 小时前
Node.js + Stagehand + Python 部署
开发语言·python·node.js
计算机程序猿学长1 小时前
大数据毕业设计-基于django的音乐网站数据分析管理系统的设计与实现(源码+LW+部署文档+全bao+远程调试+代码讲解等)
大数据·django·课程设计
B站计算机毕业设计超人1 小时前
计算机毕业设计Django+Vue.js音乐推荐系统 音乐可视化 大数据毕业设计 (源码+文档+PPT+讲解)
大数据·vue.js·hadoop·python·spark·django·课程设计
热门推荐
01GitHub 镜像站点02【OpenClaw 本地实战 Ep.3】突破瓶颈：强制修改 openclaw.json 解锁 32k 上下文记忆03Claude Code + GLM4.7 避坑指南：解决 Unable to connect to Anthropic services04OpenClaw 使用和管理 MCP 完全指南05AI Agent 平台横评：ZeroClaw vs OpenClaw vs Nanobot06Clawdbot部署教程：解决‘gateway token missing’授权问题的完整步骤07AI 规范驱动开发“三剑客”深度对比：Spec-Kit、Kiro 与 OpenSpec 实战指南08让 Trae IDE 智能体 “读懂”文档 Excel+PDF+DOCX ：mcp-documents-reader 工具使用指南09OpenClaw 安装之（三）DeepSeek模型接入配置和详细配置参数10AI agent：介绍 ZeroClaw 安装，使用