啤酒弹跳器 2.2.4

简介

基于Keg和KegElements构建的啤酒弹跳器提供了一系列管理授权和认证的功能。啤酒弹跳器允许您选择在您的应用程序中处理哪些功能。它通过提供每个功能的Mixin类来实现，您可以选择性地将这些类混入您的实体（可能是User实体）。

可用的混入包括

• 三层权限系统

• 基于密码的认证和密码历史记录

• 登录历史记录

有关如何使用这些功能的详细信息，请参阅以下部分。

权限

为了使用KegBouncer的授权功能来保护Keg视图，您还需要Flask-Login。然而，KegBouncer的模型不需要这个依赖。

keg_bouncer.mixins.PermissionMixin提供了一种三级权限模型。它管理四种类型的实体

• 用户

• 权限（用于描述系统内可以受保护的行动）

• 用户组（按最能满足业务需求的方式分组用户）

• 权限包（按最能满足系统的方式分组权限）

我们称之为“三级”权限模型，因为用户可以通过三种方式获得权限

1. 直接

2. 通过权限包

3. 通过用户组

这个术语是为了将此权限模型与其他模型区分开来，如允许任何深度的层次结构的RBAC。技术上，这个三级模型是RBAC的特殊情况。

关于术语“角色”的说明：虽然这个模型在技术上是一种广泛使用的基于角色的访问控制（RBAC）的特殊情况，但我们尽量避免使用高度模糊的术语“角色”。

import flask_login  # Only necessary if using KegBouncer to protect you views.
from sqlalchemy import import Column, Integer, String

Base = sqlalchemy.ext.declarative.declarative_base()

class User(Base, flask_login.UserMixin, keg_bouncer.model.mixins.PermissionMixin):
    __tablename__ = 'users'
    id = Column(Integer, primary_key=True)

[alembic]
version_locations = alembic/versions keg_bouncer:alembic/versions

$ alembic heads
51ba1b47505e (application) (head)
13d265b97e4d (keg_bouncer) (head)

$ alembic merge -m "pull KegBouncer into application" 51ba1b 13d265
Generating /path/to/app/alembic/versions/31b094b2844f_pull_keg_bouncer_into_application.py ... done

$ alembic heads
31b094b2844f (application, keg_bouncer) (head)

基于密码的认证

要将基于密码的认证添加到您的实体中，您需要动态构建一个密码mixin对象并将其混入到您的实体中。

from keg_bouncer.model import mixins
from passlib.context import CryptContext
import sqlalchemy as sa

crypt_context = CryptContext(schemes=['bcrypt'])

# This mixin is optional but allows you to add additional fields to the password history table.
class OptionalAdditionalFields(object):
    another_field = sa.Column(sa.Integer)


password_history_mixin = mixins.make_password_mixin(
    OptionalAdditionalFields,    # [optional] Allows you to add more fields to the password
                                 # history table via a mixin
    crypt_context=crypt_context  # [optional, but must be provided here or via another means]
                                 # Configures the CryptContext for hashing and verifying
)


class User(password_history_mixin):
    default_crypt_context = crypt_context  # An alternative way of specifying your CryptContext

    # Yet another way to specify your CryptContext
    def get_crypt_context(self):
        return crypt_context


help(User.set_password)  # Adds password to password history

help(User.verify_password)  # Verifies a password against most recent password

help(User.is_password_used_previously)  # Looks for password in history

help(User.password_history_entity)  # SQLAlchemy entity defining password history entries

User.password_history  # SQLAlchemy relationship for past passwords;
                       # sorted in reverse chronological order

注意：如果您使用is_password_used_previously或类似的概念，您选择的散列算法可以极大地影响性能，因为密码验证是有意设计为缓慢的。例如，使用bcrypt而不是sha256_crypt可以使您大约快两倍地验证密码。这在您在旧密码中筛选时会有很大影响。

登录历史记录

要将登录历史记录添加到您的实体中，您需要动态构建一个历史记录mixin对象并将其混入到您的实体中。

from keg_bouncer.model import mixins
import sqlalchemy as sa

# This mixin is optional but allows you to add additional fields to the login history table.
class OptionalAdditionalFields(object):
    another_field = sa.Column(sa.Integer)


login_history_mixin = mixins.make_login_history_mixin(
    OptionalAdditionalFields,  # [optional] Allows you to add more fields to the login history
                               # table via a mixin
)


class User(login_history_mixin):
    pass


help(User.login_history_entity)  # SQLAlchemy entity defining login history entries

User.login_history  # SQLAlchemy relationship for past logins;
                    # sorted in reverse chronological order

# Example use:
def register_login(user):
    user.login_history.insert(0, user.login_history_entity(is_login_successful=True))

开发

ln -s scripts/pre-commit .git/hooks