0

0

深入理解Flask中的CSRF保护与Flask-WTF表单实践

碧海醫心

碧海醫心

发布时间:2025-11-18 12:55:02

|

516人浏览过

|

来源于php中文网

原创

深入理解Flask中的CSRF保护与Flask-WTF表单实践

本文深入探讨了flask应用中跨站请求伪造(csrf)攻击的原理与防御机制。我们将详细解释csrf攻击如何利用用户会话执行未授权操作,以及flask-wtf如何通过csrf令牌自动提供保护。内容涵盖csrf保护的适用场景(主要针对post请求而非get请求),以及如何在flask-wtf中使用空表单来集成csrf令牌,确保应用安全性。

1. 跨站请求伪造 (CSRF) 攻击原理

跨站请求伪造(Cross-Site Request Forgery, CSRF)是一种常见的网络攻击,其核心在于诱导受害者在不知情的情况下,向其已登录的Web应用程序发送伪造的请求。攻击者利用用户在目标网站上的有效认证会话(通常通过Cookie维护),迫使用户的浏览器执行用户本不打算执行的操作,例如更改邮箱、密码、发布内容或进行资金转账等。

攻击示例解析: 假设您的Flask应用中有一个功能,允许已登录用户通过访问特定URL来更新其邮箱地址,例如 https://mygreatapp.com/updatemail?email=new_email@example.com。当用户登录到 mygreatapp.com 后,其浏览器会持有该站点的有效会话Cookie。

攻击者可以构造一个恶意页面,并在其中嵌入一个看似无害的元素,例如一个 <img> 标签,其 src 属性指向一个恶意URL:

<img src="https://mygreatapp.com/updatemail?email=attacker@malicious.com" style="display:none;">

当已登录的用户访问攻击者控制的这个恶意页面时,用户的浏览器会自动加载 <img> 标签中的 src URL。由于浏览器在发送请求时会自动携带 mygreatapp.com 的会话Cookie,服务器会认为这是一个合法用户发起的请求,并执行邮箱更新操作,将用户的邮箱更改为 attacker@malicious.com。攻击者随后便可利用“忘记密码”功能重置密码,从而劫持用户账户。

2. CSRF 保护机制

CSRF保护的核心在于引入一个只有合法用户才能提供、且攻击者难以猜测或获取的秘密令牌(CSRF Token)。其工作流程如下:

  1. 服务器生成令牌: 当用户请求一个包含表单的页面时,服务器会生成一个唯一、随机且与用户当前会话绑定的CSRF令牌。这个令牌通常会存储在用户会话中,并通过一个隐藏字段嵌入到发送给用户的HTML表单中。
  2. 客户端提交令牌: 用户提交表单时,浏览器会将表单数据连同这个隐藏的CSRF令牌一起发送回服务器。
  3. 服务器验证令牌: 服务器接收到请求后,会验证提交的CSRF令牌是否与当前用户会话中存储的令牌一致。
    • 如果令牌一致,服务器认为请求是合法的,并允许执行相应的操作。
    • 如果令牌不一致或缺失,服务器会判断请求为伪造的,并拒绝该请求,从而阻止攻击。

由于攻击者无法预测或获取到这个随机生成的、与用户会话绑定的令牌,因此无法构造出带有正确令牌的恶意请求,从而有效阻止CSRF攻击。

3. Flask-WTF 与 CSRF 保护实践

Flask-WTF 是 Flask 框架的一个扩展,它集成了 WTForms 库,为表单处理提供了极大的便利,包括内置的CSRF保护。

3.1 CSRF 保护的适用场景

  • HTTP 方法: CSRF保护主要针对会改变服务器状态的请求,例如 POST、PUT、DELETE 等。对于不会改变服务器状态的 GET 和 HEAD 请求,通常不需要CSRF保护。这是因为 GET 请求被设计为幂等的、可缓存的,且不应产生副作用。如果一个 GET 请求被设计为改变服务器状态,那本身就违反了HTTP规范,应将其改为 POST 或其他适当的方法。
  • 用户状态: CSRF保护并非只针对已登录用户。任何可能导致服务器状态改变的操作,无论用户是否登录(例如匿名用户提交评论、注册账户等),都应考虑CSRF保护,以防止恶意用户利用这些接口进行滥用。

3.2 在 Flask 应用中启用 Flask-WTF CSRF 保护

Flask-WTF 默认开启了CSRF保护。你只需确保在 Flask 应用配置中设置了 SECRET_KEY,并初始化 CSRFProtect 扩展。

MusicAI
MusicAI

AI音乐生成工具

下载

app.py 配置示例:

from flask import Flask
from flask_wtf.csrf import CSRFProtect

app = Flask(__name__)
# 必须设置一个强密钥,用于签名会话Cookie和CSRF令牌
# 生产环境中应通过环境变量或其他安全方式配置
app.config['SECRET_KEY'] = 'your_very_strong_and_random_secret_key' 

# 初始化 CSRFProtect 扩展
csrf = CSRFProtect(app)

# ... 其他路由和视图函数定义

3.3 使用空 Flask-WTF 表单集成 CSRF 令牌

即使表单不包含任何用户输入字段,你也可以利用 Flask-WTF 来生成并管理CSRF令牌。这对于那些仅用于触发特定操作(如确认删除、触发异步任务等)而无需额外用户输入的表单非常有用。

forms.py 示例:

from flask_wtf import FlaskForm

class EmptyForm(FlaskForm):
    """
    一个不包含任何用户输入字段的空表单。
    FlaskForm 会自动处理 CSRF 令牌的生成和验证。
    """
    pass

routes.py 示例:

from flask import render_template, request, redirect, url_for, flash
from app import app # 假设 app 实例在 app.py 中定义
from forms import EmptyForm

@app.route('/confirm_action', methods=['GET', 'POST'])
def confirm_action():
    form = EmptyForm()
    if request.method == 'POST':
        # form.validate_on_submit() 会自动验证 CSRF 令牌
        if form.validate_on_submit():
            # CSRF 令牌已验证通过,执行需要保护的操作
            # 例如:删除用户数据、发送通知等
            flash('操作已成功执行!', 'success')
            return redirect(url_for('index')) # 重定向到其他页面
        else:
            # CSRF 令牌无效或表单验证失败
            flash('操作失败,安全验证不通过,请重试。', 'danger')

    # 对于 GET 请求或 POST 请求验证失败的情况,渲染表单页面
    return render_template('confirm_action.html', form=form)

# 假设有一个首页路由用于重定向
@app.route('/')
def index():
    return "<h1>欢迎来到首页!</h1><p>点击 <a href='/confirm_action'>这里</a> 确认操作。</p>"

confirm_action.html 示例:

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>确认操作</title>
    <style>
        .success { color: green; }
        .danger { color: red; }
    </style>
</head>
<body>
    <h1>确认您的操作</h1>
    <p>您即将执行一个重要操作。请点击确认按钮继续。</p>

    <!-- 
        对于需要CSRF保护的表单,method 必须是 POST。
        GET 请求不应改变服务器状态,因此通常不应携带CSRF令牌来执行状态改变操作。
    -->
    <form method="POST">
        {{ form.csrf_token }} <!-- 自动渲染隐藏的 CSRF 令牌字段 -->
        <button type="submit">确认</button>
    </form>

    {% with messages = get_flashed_messages(with_categories=true) %}
        {% if messages %}
            <ul class="flashes">
                {% for category, message in messages %}
                    <li class="{{ category }}">{{ message }}</li>
                {% endfor %}
            </ul>
        {% endif %}
    {% endwith %}
</body>
</html>

关于原问题中 method="GET" 表单的说明: 在原始问题提供的HTML代码中,表单的 method 属性被设置为 GET。虽然 Flask-WTF 允许你在 GET 表单中渲染 csrf_token,但这通常不是推荐的做法。CSRF保护主要用于防止恶意 POST 请求,因为 GET 请求不应改变服务器状态。如果一个 GET 请求携带了CSRF令牌并改变了状态,这表明应用设计上存在缺陷。如果你的表单确实需要改变状态,请务必将其 method 设置为 POST。如果表单仅用于显示信息或不改变服务器状态,则不需要CSRF保护。

4. 注意事项与最佳实践

  • SECRET_KEY 的安全性: SECRET_KEY 是 Flask 应用安全的核心。它用于签名会话Cookie和CSRF令牌。务必使用一个长、随机且复杂的密钥,并且绝不能将其硬编码在代码中或提交到版本控制系统。在生产环境中,应通过环境变量或其他安全配置方式进行管理。
  • 严格遵守HTTP方法语义: 严格遵守HTTP方法语义,不要在 GET 请求中执行任何会改变服务器状态的操作。如果需要改变状态,请使用 POST 请求,并辅以CSRF保护。
  • 理解 form.validate_on_submit(): 这个方法会在 POST 请求时自动验证

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
Python Flask框架
Python Flask框架

本专题专注于 Python 轻量级 Web 框架 Flask 的学习与实战,内容涵盖路由与视图、模板渲染、表单处理、数据库集成、用户认证以及RESTful API 开发。通过博客系统、任务管理工具与微服务接口等项目实战,帮助学员掌握 Flask 在快速构建小型到中型 Web 应用中的核心技能。

106

2025.08.25

Python Flask Web框架与API开发
Python Flask Web框架与API开发

本专题系统介绍 Python Flask Web框架的基础与进阶应用,包括Flask路由、请求与响应、模板渲染、表单处理、安全性加固、数据库集成(SQLAlchemy)、以及使用Flask构建 RESTful API 服务。通过多个实战项目,帮助学习者掌握使用 Flask 开发高效、可扩展的 Web 应用与 API。

81

2025.12.15

cookie
cookie

Cookie 是一种在用户计算机上存储小型文本文件的技术,用于在用户与网站进行交互时收集和存储有关用户的信息。当用户访问一个网站时,网站会将一个包含特定信息的 Cookie 文件发送到用户的浏览器,浏览器会将该 Cookie 存储在用户的计算机上。之后,当用户再次访问该网站时,浏览器会向服务器发送 Cookie,服务器可以根据 Cookie 中的信息来识别用户、跟踪用户行为等。

6500

2023.06.30

document.cookie获取不到怎么解决
document.cookie获取不到怎么解决

document.cookie获取不到的解决办法:1、浏览器的隐私设置;2、Same-origin policy;3、HTTPOnly Cookie;4、JavaScript代码错误;5、Cookie不存在或过期等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

368

2023.11.23

阻止所有cookie什么意思
阻止所有cookie什么意思

阻止所有cookie意味着在浏览器中禁止接受和存储网站发送的cookie。阻止所有cookie可能会影响许多网站的使用体验,因为许多网站使用cookie来提供个性化服务、存储用户信息或跟踪用户行为。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

447

2024.02.23

cookie与session的区别
cookie与session的区别

本专题整合了cookie与session的区别和使用方法等相关内容,阅读专题下面的文章了解更详细的内容。

97

2025.08.19

登录token无效
登录token无效

登录token无效解决方法:1、检查token的有效期限,如果token已经过期,需要重新获取一个新的token;2、检查token的签名,如果签名不正确,需要重新获取一个新的token;3、检查密钥的正确性,如果密钥不正确,需要重新获取一个新的token;4、使用HTTPS协议传输token,建议使用HTTPS协议进行传输 ;5、使用双因素认证,双因素认证可以提高账户的安全性。

6654

2023.09.14

登录token无效怎么办
登录token无效怎么办

登录token无效的解决办法有检查Token是否过期、检查Token是否正确、检查Token是否被篡改、检查Token是否与用户匹配、清除缓存或Cookie、检查网络连接和服务器状态、重新登录或请求新的Token、联系技术支持或开发人员等。本专题为大家提供token相关的文章、下载、课程内容,供大家免费下载体验。

844

2023.09.14

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

49

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Bootstrap 5教程
Bootstrap 5教程

共46课时 | 3.6万人学习

AngularJS教程
AngularJS教程

共24课时 | 4.2万人学习

CSS教程
CSS教程

共754课时 | 43.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号