python-eve 认证和授权

摘要：要使用验证，需要通过一些外部技术例如，向客户发送包含用户和秘密密钥的电子邮件向客户端提供用户和密钥。客户端将使用提供的密钥来签署所有请求。

要实现安全认证，只需要在Eve实例化的时候传入验证类即可，这样就创建了一个全局的验证类

    from eve.auth import BasicAuth
    class MybasicAuth(BasicAuth):
        def check_auth(self, username, password, allowed_roles, resource, method):
            return username == "admin" and password == "admin"
                
    app = Eve(auth=MybasicAuth)

只有用户名和密码满足条件才允许访问

如果要做到对某一资源公开，其他资源安全，可以用下面的写法

    if resource in ("people","countries"):
        return True
    else:
        return username == "admin" and password == "secret"

同样，你可以控制method，以在某个方法上启用或者关闭验证

有时候要对某些资源进行特别的权限控制，这时候全局验证就不太好用了
可以重写某个资源的验证类

    people = {
        "authentication":MyEndpointAuth,
    }

其中MyEndpointAuth和上面的MybaseAuth一样继承自BasicAuth并且重写了check_auth方法，可以为每一个资源设置不同的验证方法

在setting中加入下面的内容，可以使所有资源的GET方法都是公开的

    PUBLIC_METHODS = ["GET"]
    PUBLIC_ITEM_METHODS = ["GET"]

PUBLIC_METHODS 引用资源端点，例如/ people ，而PUBLIC_ITEM_METHODS引用像/people/这样的单个项目。

可以为资源设置public_methods，public_item_methods来设置资源的访问控制，资源中的这两个属性会覆盖全局设定，利用这一特点可以设置全部资源公开但某一资源私有

    DOMAIN = {
        "invoices": {
            "public_methods": [],
            "public_item_methods": [],
             }
        }

这样invoices这个资源就被隐藏了

假设用户名和密码都存储在MongoDB中，并且密码存储为SHA1 / HMAC哈希值，我们可以用下面的方法验证用户名和密码

    from eve.auth import BasicAuth
    from werkzeug.security import check_password_hash
    from flask import current_app as app
        
    class Sha1Auth(BasicAuth):
        def check_auth(self, username, password, allowed_roles, resource, method):
            # use Eve"s own db driver; no additional connections/resources are used
            accounts = app.data.driver.db["accounts"]
            account = accounts.find_one({"username": username})
            return account and 
                check_password_hash(account["password"], password)

为了要测试用户名和密码，我们要事先往mongodb的accounts表中插入一条记录

    use eve
    db.createCollection("accounts")
    db.accounts.insert({username:"test1",passowrd:"pbkdf2:sha1:1000$v86Nv0hS$817921c0a065c4289416f559a2d8da3010b66727"})

密码为admin
tips:更新密码请用db.accounts.update({"username":"test1"},{$set:{"password":"new password"}})

之后测试登录即可

token验证可以看作只有用户名没有密码的验证方式，使用Token作为验证，Token本身必须具备足够的强度并且有合理的失效机制

    class TokenAuthS(TokenAuth):
        def check_auth(self, token, allowed_roles, resource, method):
            accounts = app.data.driver.db["accounts"]
            return accounts.find_one({"token": token})

和SHA1/HMAC验证一样，我们要事先在数据库里存放一个token，方法类似

    db.accounts.insert({toke:"86Nv0h817921c0a065c4289416f559a2d8da3010b66727"})
    

eve.auth.HMACAuth类允许自定义的类似于Amazon S3的HMAC（哈希消息认证码）认证，这基本上是一个非常安全的定制认证方案，围绕Authorization头部而构建。

要使用HMAC验证，需要通过一些外部技术（例如，向客户发送包含用户ID和秘密密钥的电子邮件）向客户端提供用户ID和密钥。 客户端将使用提供的密钥来签署所有请求。
当客户想要发送一个请求时，先建立完整的请求，然后使用密钥，在整个消息体上计算一个散列（如果需要的话还可以包含一些消息头），接下来，客户端将计算出的散列和他的用户ID添加到授权标头中的消息中，下面是一个例子：

        Authorization: johndoe:uCMfSzkjue+HSDygYB5aEg==

如果要实现类似的效果，可以这样做：
1.先往mongodb中插入一条记录，记录userid和secret_key
2.用secret_key计算出我们需要的散列值，添加到头中，eve中写法如下

    class HMACAuths(HMACAuth):
        def check_auth(self, userid, hmac_hash, headers, data, allowed_roles,
                           resource, method):
            accounts = app.data.driver.db["accounts"]
            user = accounts.find_one({"userid": userid})
            if user:
                secret_key = user["secret_key"]
            return user and hmac.new(bytes(secret_key.encode()), data, sha1).hexdigest() == hmac_hash

在上面的内容中被故意忽略的参数allowed_roles，作用是利用角色来控制对资源的访问，要想要预览这效果，需要修改之前存在mongodb中的用户名密码，为其增加roles属性

    db.accounts.update({username:"test1"},{$set:{"roles":"admin"}})

setting中添加全局资源允许的操作角色，也可以在资源中设置覆盖全角的ALLOWED_ROLES设定

ALLOWED_ROLES = ["superadmin","admin"]

之后修改check_auth方法

    def check_auth(self, username, password, allowed_roles, resource, method):
        accounts = app.data.driver.db["accounts"]
        lookup = {"username": username}
        if allowed_roles:
            # 只有角色符合才允许后续操作 
            lookup["roles"] = {"$in": allowed_roles}
        account = accounts.find_one(lookup)
        return account and check_password_hash(account["password"], password)

之后用test1这个角色登录即可看到内容

这是一个仅允许资源创建者对资源进行控制的功能，需要在setting中设置AUTH_FIELD并且在资源中设置auth_field属性，我们假设添加到字段为user_id
1.首先setting.py中添加 AUTH_FIELD = []
2.然后people中添加"auth_field":"user_id"
3.最后将check_auth方法修改为

    def check_auth(self, username, password, allowed_roles, resource, method):
        accounts = app.data.driver.db["accounts"]
        account = accounts.find_one({"username": username})
        if account and "_id" in account:
            self.set_request_auth_value(account["_id"])
        return account and check_password_hash(account["password"], password)

    之后我们插入新的用户test2，用test2创建新的people资源，再用test1去查看，会发现无法获取到内容test2创建的内容