用户管理的规范

原文: http://exploreflask.com/en/latest/users.html

用户管理的规范

用户管理是现代 Web 应用都需要做的事情之一。一个仅有基本的账户功能的应用也需要处理一大堆诸如注册，邮件确认，安全地存储密码，重置密码，用户验证以及更多。考虑到许多安全问题都出现在管理用户时，在这个领域最好遵循普遍的规范。

注意在本章中我会假定你已经在用SQLAlchemy模型和WTForms来处理你的表单输入。如果你不使用它们，你需要修改这些规范来适应你喜欢的方法。

邮件确认

当一个新用户给你他们的邮件地址，你通常需要确认该地址是否是正确的。一旦你完成了验证，你就可以安心地发送密码重置链接和其他敏感信息给该邮箱，不用担心位于接收端的会是谁。

邮件确认的一个通常的规范是发送一个当前独一无二的 URL 密码重置链接，来确认用户的电子邮件地址。举个例子，john@gmail.com 注册了你的应用。你的应用把他登记在数据库中，设置 email_confirmed 列为 False 并发送一封带特定 URL 的邮件给 john@gmail.com。这个 URL 通常包括一个独一无二的 token，比如http://myapp.com/accounts/confirm/kj3kjhj3hj3。当 John 收到那封邮件时，他点击链接。你的应用看到了 token，知道是哪封邮件并设置 John 的 email_confirmed 列为 True。

那我们怎么知道给定的 token 对应的是哪封邮件？一个方法是在创建 token 时把它存储到数据库中，在我们收到一个确认请求时检索数据库来找到那个 token。这需要做很多事情，而幸运的是，我们不必这么做。

我们将邮件地址编码进 token。它还包括一个时间戳，表示这个 token 的有效期。为了做到这一点，我们要使用 itsdangerous 包。这个包提供了在无法信赖的环境中发送敏感信息的工具。（比如发送邮件确认 token 给未验证的邮件地址）。在这个例子里，我们将使用 URLSafeTimedSerializer。

myapp/util/security.py

from itsdangerous import URLSafeTimedSerializer

from .. import app

ts = URLSafeTimedSerializer(app.config["SECRET_KEY"])

现在当用户给我们邮件地址时，我们可以使用这个序列器来生成验证 token。通过这种方式，我们来实现一个简单的账户注册流程。

myapp/views.py

from flask import redirect, render_template, url_for

from . import app, db
from .forms import EmailPasswordForm
from .util import ts, send_email

@app.route('/accounts/create', methods=["GET", "POST"])
def create_account():
    form = EmailPasswordForm()
    if form.validate_on_submit():
        user = User(
            email = form.email.data,
            password = form.password.data
        )
        db.session.add(user)
        db.session.commit()

        # Now we'll send the email confirmation link
        subject = "Confirm your email"

        token = ts.dumps(self.email, salt='email-confirm-key')

        confirm_url = url_for(
            'confirm_email',
            token=token,
            _external=True)

        html = render_template(
            'email/activate.html',
            confirm_url=confirm_url)

  # 假设在myapp/util.py中定义了send_mail
        send_email(user.email, subject, html)

        return redirect(url_for("index"))

    return render_template("accounts/create.html", form=form)

这段视图实现了创建用户并发送邮件到给定的邮件地址。你可能注意到了，我们使用一个模板来给电子邮件生成 HTML。我们来看看这个电子邮件模板的例子。

myapp/templates/email/activate.html

你的账户已经成功创建<br>
请点击打开以下链接来激活你的邮箱：

<p>
<a href="{{ confirm_url }}">{{ confirm_url }}</a>
</p>

<p>
--<br>
如果对本邮件有疑问或者有话想说，发邮件给hello@myapp.com.
</p>

OK，所以现在我们只需要实现一个处理那个邮件中的验证链接的视图。

myapp/views.py

@app.route('/confirm/<token>')
def confirm_email(token):
    try:
        email = ts.loads(token, salt="email-confirm-key", max_age=86400)
    except:
        abort(404)

    user = User.query.filter_by(email=email).first_or_404()

    user.email_confirmed = True

    db.session.add(user)
    db.session.commit()

    return redirect(url_for('signin'))

这个视图只是一个简单的表单视图。我们仅仅在开头添加了 try ... except 来检查这个 token 是否有效。这个 token 包括一个时间戳，所以我们可以调用 ts.loads()，如果它比 max_age 还大，就抛出一个异常。在这个例子，我们设置 max_age 为 86400 秒，也即 24 小时。

注意你可以用差不多的方法实现一个邮件重置的功能。仅需要发送带旧邮件地址和新地址的token的验证链接到新的邮件地址。如果token是有效的，用新的地址更新旧地址。

存储密码

用户管理的第一条军规是在存储它们之前使用 Bcrypt 算法（或者 scrypt，不过这里我们将使用 Bcrypt）hash 密码。你绝不可明文存储密码。这会是严重的安全问题并且它损害了你的用户。所有的繁重工作都已经有第三方的包来完成，所以没有任何不遵循这个最佳实践的理由。

参见 OWASP是业界最值得信赖的关于Web应用安全的信息来源之一。看一下他们推荐的一些安全编程规范： https://www.owasp.org/index.php/Secure_Coding_Cheat_Sheet#Password_Storage

我们将继续前进，使用 Flask-Bcrypt 插件来实现应用中的 bcrypt 包。这个插件只是基于 py-bcypt 包的包装，但是它帮我们处理了一些琐碎的事（比如在比较 hash 结果之前检查字符串编码）。

myapp/__init__.py

from flask_bcrypt import Bcrypt

bcrypt = Bcrypt(app)

Bcrypt 算法之所以深受欢迎，其中一个原因是它的“未来拓展性”。这意味着随着时间的迁移，当计算能力越来越廉价时，我们可以让它越来越难通过暴力算法来测试成百上千万密码组合来破解。我们用于 hash 密码的 "rounds" 越多，完成一次尝试所花费的时间就越长。如果在存储密码前，我们把它 hash 了 20 次，骇客也不得不 hash 他们的每次猜测 20 次。

记住如果我们 hash 密码 20 次，需要等到计算结束之后，我们的应用才会做出响应。这意味着，在选择计算的次数时，我们要取得安全性和可用性的一个平衡点。在给定时间内你能计算的次数取决于你拥有的计算资源，所以最好测试不同的数字，找到能在 0.25 到 0.5 秒间完成一个密码的 hash 的值。至少，先从 12 次（12 rounds）开始尝试吧。

要想测试 hash 一个密码的时间，你可以 time 一个简单的，用于 hash 一个密码的 Python 脚本看看。

benchmark.py

from flask_bcrypt import generate_password_hash

# 改变round的次数（第二个参数），直到运行时间在0.25到0.5之间。
generate_password_hash('password1', 12)

现在我们可以用 time 命令测几次看看。

$ time python test.py

real    0m0.496s
user    0m0.464s
sys     0m0.024s

我曾在一个小服务器上做过快速的基准测试，发现 12 rounds 正好能花费恰当的时间，所以我在这个例子中这么配置。

config.py

BCRYPT_LOG_ROUNDS = 12

既然 Flask-Bcrypt 已经配置完毕了，是时候开始 hash 密码。我们本可以在接受注册表单的视图函数中手工完成，但是将来在密码重置和密码修改视图中，同样的代码还得一再重复。所以，我们需要抽象 hash 的过程，这样即使我们忘记了，我们的应用也会悄悄完成它。秘诀在于我们写了个 setter，这样当设置 user.password = 'password1' 时，密码在存储之前就会被用 Bcrypt 自动 hash 了。

myapp/models.py

from sqlalchemy.ext.hybrid import hybrid_property

from . import bcrypt, db

class User(db.Model):
    id = db.Column(db.Integer, primary_key=True, autoincrement=True)
    username = db.Column(db.String(64), unique=True)
    _password = db.Column(db.String(128))

    @hybrid_property
    def password(self):
        return self._password

    @password.setter
    def password(self, plaintext):
        self._password = bcrypt.generate_password_hash(plaintext).decode("utf-8")

我们使用 SQLAlchemy 的 hybird（混合）拓展来定义一个同时供众多函数调用的接口属性。当赋值给 user.password 属性时，我们的 setter 会被自动调用。而在 setter 内，我们会 hash 纯文本密码并存储在用户表里的 _password 列里。既然我们定义 user.password 为混合属性，那么就可以通过这个属性来获取 _password 的值。

现在我们用这个模型来实现注册视图。

myapp/views.py

from . import app, db
from .forms import EmailPasswordForm
from .models import User

@app.route('/signup', methods=["GET", "POST"])
def signup():
    form = EmailPasswordForm()
    if form.validate_on_submit():
        user = User(username=form.username.data, password=form.password.data)
        db.session.add(user)
        db.session.commit()
        return redirect(url_for('index'))

    return render_template('signup.html', form=form)

验证

既然把用户加入到数据库中了，就可以实现验证功能了。我们想要让用户通过表单提交他们的用户名和密码（当然，有些时候是邮箱和密码），然后验证他们提供的密码是否正确。如果一切安好，我们将通过设置浏览器的 cookie 来标记他们是已验证的用户。下一次他们再提交请求时，通过查看 cookie，我们就知道他们已经登录过了。

先从用 WTForms 定义一个 UsernamePassword 开始吧。

myapp/forms.py

from flask_wtf import Form
from wtforms import StringField, PasswordField
from wtforms.validators import DataRequired

class UsernamePasswordForm(Form):
    username = StringField('Username', validators=[DataRequired()])
    password = PasswordField('Password', validators=[DataRequired()])

接下来我们将往我们的用户模型添加一个方法，拿一个字符串跟已存储的 hash 过的用户密码作比较。

myapp/models.py

from . import db

class User(db.Model):

    # [...] columns and properties

    def is_correct_password(self, plaintext):
        if bcrypt.check_password_hash(self._password, plaintext):
            return True

        return False

我们下一个目标是定义一个使用我们的表单类的登录视图。如果用户输入正确的账号，我们将使用 Flask-Login 插件来验证它们。这个插件简化了处理用户会话和验证的操作。

我们只需做少量的配置就能让 Flask-Login 用起来了。

我们先在 __init__.py 定义 Flask-Login 的 login_manager。

myapp/__init__.py

from flask_login import LoginManager

# 创建并配置应用
# [...]

from .models import User

login_manager = LoginManager()
login_manager.init_app(app)
login_manager.login_view =  "signin"

@login_manager.user_loader
def load_user(userid):
    return User.query.filter(User.id == userid).first()

我们在这里创建一个叫 LoginManager 的实例，用我们的 app 对象初始化它，定义登录视图并告诉它如何通过 id 获取用户类。这是使用 Flask-Login 的基本配置。

参见你可以在这里找到自定义Flask-Login的更多信息： https://flask-login.readthedocs.org/en/latest/#customizing-the-login-process

现在我们来定义处理验证的 signin 视图。

myapp/views.py

from flask import redirect, url_for

from flask_login import login_user

from . import app
from .forms import UsernamePasswordForm()

@app.route('signin', methods=["GET", "POST"])
def signin():
    form = UsernamePasswordForm()

    if form.validate_on_submit():
        user = User.query.filter_by(username=form.username.data).first_or_404()
        if user.is_correct_password(form.password.data):
            login_user(user)

            return redirect(url_for('index'))
        else:
            return redirect(url_for('signin'))
    return render_template('signin.html', form=form)

我们仅需要从 Flask-Login import login_user 函数，检查用户的验证信息，并调用 login_user(user)。你使用 logout_user() 登出当前用户。

myapp/views.py

from flask import redirect, url_for
from flask_login import logout_user

from . import app

@app.route('/signout')
def signout():
    logout_user()

    return redirect(url_for('index'))

忘记密码？

你总会需要实现一个“忘记密码？”功能来允许用户通过邮件重置自己的账号密码。这个地方可能会有潜在安全隐患，因为你不得不让一个未验证的用户接管一个账户。我们将会使用类似于邮件验证的方式来实现密码重置的功能。

我们将需要一个表单类来请求对给定账户的重置，还有一个表单来选择一个新的密码（前提是未验证用户访问了账户邮箱）。这里假设我们的用户模型有一个 email 和一个 password，而 password 是我们之前设置过的混合属性。

注意不要发送密码重置链接给未确认的邮箱！你要确保发送链接给正确的人。

我们将需要两个表单。一个用于请求一个重置链接，另一个用于在通过验证之后修改密码。

myapp/forms.py

from flask_wtf import Form

from wtforms import StringField, PasswordField
from wtforms.validators import DataRequired, Email

class EmailForm(Form):
    email = StringField('Email', validators=[DataRequired(), Email()])

class PasswordForm(Form):
    password = PasswordField('Email', validators=[DataRequired()])

假设我们的密码重置表单只需要密码这一栏。许多应用需要用户两次输入他们的新密码，确保没有打错。为了实现这个，我们仅需添加另一个 PasswordField，并加一个 WTForms 验证函数 EqualTo 到主密码域。

参见很多人站在用户体验的角度，对什么是设计注册表单的最佳方式有过许多有趣的讨论。我个人喜欢Stack Exchange用户 Roger Attrill说的一番话：“我们不应该一再要求用户输入密码 - 我们应该要求输入一次，然后确保‘忘记密码’能无缝且正确地运行。”

你可以在User Experience Stack Exchange读到更多关于这个话题的内容:http://ux.stackexchange.com/questions/20953/why-should-we-ask-the-password-twice-during-registration/21141

在Smashing Magazine的文章中，你可以读到一些简化注册和登录表单的酷想法：http://uxdesign.smashingmagazine.com/2011/05/05/innovative-techniques-to-simplify-signups-and-logins/

现在我们将开始迈出第一步，让用户可以请求发送一个密码重置链接给绑定的邮箱地址。

myapp/views.py

from flask import redirect, url_for, render_template

from . import app
from .forms import EmailForm
from .models import User
from .util import send_email, ts

@app.route('/reset', methods=["GET", "POST"])
def reset():
    form = EmailForm()
    if form.validate_on_submit()
        user = User.query.filter_by(email=form.email.data).first_or_404()

  subject = "Password reset requested"
        # Here we use the URLSafeTimedSerializer we created in `util` at the beginning of the chapter
        token = ts.dumps(user.email, salt='recover-key')

        recover_url = url_for(
            'reset_with_token',
            token=token,
            _external=True)

        html = render_template(
            'email/recover.html',
            recover_url=recover_url)

        # Let's assume that send_email was defined in myapp/util.py
        send_email(user.email, subject, html)

        return redirect(url_for('index'))
    return render_template('reset.html', form=form)

当表单接受到一个邮件地址时，我们取出对应的用户，生成一个重置 token，再发送一个重置密码 URL 给用户。这个 URL 将引导用户前往验证 token 的视图，并让用户重置密码。

myapp/views.py

from flask import redirect, url_for, render_template

from . import app, db
from .forms import PasswordForm
from .models import User
from .util import ts

@app.route('/reset/<token>', methods=["GET", "POST"])
def reset_with_token(token):
    try:
        email = ts.loads(token, salt="recover-key", max_age=86400)
    except:
        abort(404)

    form = PasswordForm()

    if form.validate_on_submit():
        user = User.query.filter_by(email=email).first_or_404()

        user.password = form.password.data

        db.session.add(user)
        db.session.commit()

        return redirect(url_for('signin'))

    return render_template('reset_with_token.html', form=form, token=token)

我们将使用验证用户邮箱时用的那个 token 验证方式。这个视图传递 token 回模板，然后模板会在表单中提交正确的 URL。让我们看看这个模板到底长啥样。

myapp/templates/reset_with_token.html

{% extends "layout.html" %}

{% block body %}
<form action="{{ url_for('reset_with_token', token=token) }}" method="POST">
    {{ form.password.label }}: {{ form.password }}<br>
    {{ form.csrf_token }}
    <input type="submit" value="Change my password" />
</form>
{% endblock %}

总结

使用 itsdangerous 包来创建和验证送往邮箱的 token。
你可以使用 token 来验证邮箱，无论是在用户注册账户，还是修改邮箱，或者忘记密码的时候。
使用 Flask-Login 插件来验证用户，这样能避免处理一堆会话管理的麻烦事。
总是设想会有恶意的用户试图从应用中挖掘漏洞。