由于缺少 CSRF，表单验证失败

Question

几天前，我重置了本地烧瓶环境，但在删除之前没有通过pip freeze 捕获依赖项。因此我不得不重新安装整个堆栈的最新版本。

现在出乎意料的是，我不再能够使用表单进行验证。 Flask 声称 CSRF 会丢失。

def register():
    form = RegisterForm()
    if form.validate_on_submit():
       ...
    return make_response("register.html", form=form, error=form.errors)

第一次发送Get 时，我按预期检索了一个空的form.errors。 现在我填写表格并提交，form.errors 显示：{'csrf_token': [u'CSRF token missing']}

这太奇怪了。我想知道 Flask-WTF 是不是变了，我用错了。

我可以清楚地看到form.CSRF_token 存在，为什么它声称它丢失了？

CSRFTokenField: <input id="csrf_token" name="csrf_token" type="hidden" value="1391278044.35##3f90ec8062a9e91707e70c2edb919f7e8236ddb5">

我从未接触过工作模板，但我还是把它贴在这里：

{% from "_formhelpers.html" import render_field %}
{% extends "base.html" %}
{% block body %}
<div class="center simpleform">
    <h2>Register</h2>
    {% if error %}<p class=error><strong>Error:</strong> {{ error }}{% endif %}
    <form class="form-signin" action="{{ url_for('register') }}" method=post>
        {{form.hidden_tag()}}
        <dl>
            {{ render_field(form.name) }}
            {{ render_field(form.email) }}
            {{ render_field(form.password) }}
            {{ render_field(form.confirm) }}
            <dd><input type=submit value=Register class='btn btn-primary'>
        </dl>
    </form>
</div>
{% endblock %}

这是一个新错误吗？

更新：

我已重新安装所有内容，但问题仍然存在。

正如 Martijn 建议的那样，我正在flask_wtf 中调试以下方法：

def validate_csrf_token(self, field):
        if not self.csrf_enabled:
            return True
        if hasattr(request, 'csrf_valid') and request.csrf_valid:
            # this is validated by CsrfProtect
            return True
        if not validate_csrf(field.data, self.SECRET_KEY, self.TIME_LIMIT):
            raise ValidationError(field.gettext('CSRF token missing'))

最后一个条件是引发验证错误。

field.data = "1391296243.8##1b02e325eb0cd0c15436d0384f981f06c06147ec"
self.SECRET_KEY = None (? Is this the problem)
self.TIME_LIMIT = 3600

你是对的，HMAC 比较失败了……这两个值每次都不同。

return hmac_compare == hmac_csrf

我在我的配置中定义了 SECRET_KEY 和 CSRF_SESSION_KEY。

Answer 1

Flask-WTF CSRF 基础设施在以下情况下拒绝令牌：

• 令牌丢失。这里不是这样，你可以在表单中看到token。

• 它太旧了（默认过期设置为 3600 秒或一小时）。在表单上设置TIME_LIMIT 属性以覆盖它。可能不是这里的情况。

• 如果在当前会话中没有找到 'csrf_token' 键。您显然可以看到会话令牌，所以它也出来了。

• 如果 HMAC 签名不匹配；签名基于会话中在'csrf_token' 密钥下设置的随机值、服务器端密钥和令牌中的到期时间戳。

排除了前三种可能性后，您需要验证第四步失败的原因。您可以在flask_wtf/csrf.py 文件中的validate_csrf() 函数中调试验证。

对于您的设置，您需要验证会话设置是否正确（特别是如果您不使用默认会话配置），并且您使用的是正确的服务器端密钥。表单本身可能具有SECRET_KEY 属性集，但在请求之间不稳定，或者应用程序WTF_CSRF_SECRET_KEY 键已更改（后者默认为app.secret_key value）。

CSRF 支持是在 0.9.0 版本中添加的，如果您升级了，请查看特定的 CSRF protection documentation。标准的 Flask-WTF Form 类包含 CSRF 令牌作为隐藏字段，渲染隐藏字段足以包含它：

{{ form.hidden_tag() }}

Answer 2

经过将近一天的工作，我终于找到了问题所在。 :( 非常感谢 Martijn 的帮助。

实际问题在于最新的flask_wtf.csrf 的工作方式。制造商对其进行了彻底的改造。

您必须将模板中的所有 {{form.hidden_tag()}} 替换为 <input type="hidden" name="csrf_token" value="{{ csrf_token() }}"/>.

您现在必须通过添加 CsrfProtect(app) 来明确启用 CSRF 保护。

documentation现在明显反映了这一点，但我不知道这已经改变了，正在追鬼。

在不以某种方式通知开发人员的情况下，不推荐使用的功能是一个大问题。现在升级到最新版本的任何人都会像我一样追鬼。但这也是我没有拍摄我的依赖关系的快照的错。以艰难的方式吸取了教训。

Answer 3

在创建应用时：

from flask_wtf.csrf import CsrfProtect

csrf = CsrfProtect()

app = Flask(__name__)   

...

csrf.init_app(app)

...

Answer 4

对我来说，问题不在于 Flask-WTF 配置不当或缺少令牌。它来自环境变量。

如果您的 Flask 服务器没有在 localhost 上运行，那么为了让 Flask 正常工作，您需要设置一个 SERVER_NAME 环境变量。您可能忘记在某处修改 SERVER_NAME 值。

例如，您可以在config/settings.py 中有这样的内容：

SERVER_NAME = 'my-domain.com'

欲了解更多信息，请查看this great resource

Answer 5

使用字段列表？

使用FieldList 时，不幸的是，我在调试数小时后发现了另一个错误来源：

class Subform(FlaskForm):
    """Parent form."""
    text = StringField("Text")


class Maniform(FlaskForm):
    """Parent form."""
    laps = FieldList(
        FormField(Subform),
        min_entries=1,
        max_entries=30
    )

这将无法正确处理 CSRF，因为 Subform 应该继承自 wtforms.Form

class Subform(Form):
    """Parent form."""
    text = StringField("Text")

修复这个错误解决了我的问题。