dolmen.app.authentication 1.1.1

Cookies凭证

Cookie凭证插件从cookie中提取凭证。此插件基于Philipp von Weitershausen的工作（wc.cookiecredentials）。它已被重新实现，以避免使用 zope.app 包，并允许在长期内具有更大的灵活性。

此插件提供以下功能

• 通过登录表单挑战用户输入用户名和密码；

• 将这些凭证保存到cookie中，稍后可以从中读取它们。

要检查凭证是否可以正确提取，我们可以在测试请求中伪造cookie

>>> import base64
>>> from zope.publisher.browser import TestRequest

>>> cookie = base64.encodestring('mgr:mgrpw')
>>> request = TestRequest()
>>> request._cookies = {'dolmen.authcookie': cookie}

调用插件凭证提取器将给出我们继续认证所需的确切信息

>>> from zope.interface.verify import verifyObject
>>> from dolmen.app.authentication.plugins import CookiesCredentials

>>> plugin = CookiesCredentials()
>>> verifyObject(ICredentialsPlugin, plugin)
True

>>> print plugin.extractCredentials(request)
{'login': u'mgr', 'password': u'mgrpw'}

全局注册表认证

为了注册主体，zope.principalregistry 包提供了一个全局注册表，该注册表在每次启动时都不是持久的，并重新构建。全局注册表认证器旨在在该全局注册表中查找主体。

我们验证我们的实现是否符合要求

>>> from dolmen.app.authentication import plugins
>>> IAuthenticatorPlugin.implementedBy(plugins.GlobalRegistryAuth)
True

>>> plugin = plugins.GlobalRegistryAuth()
>>> verifyObject(IAuthenticatorPlugin, plugin)
True

为了测试此插件，我们在全局注册表中注册了一个用户，称为“mgr”。我们将使用“mgr”凭据进行查找测试

>>> user = plugin.authenticateCredentials(
...            {'login': u"mgr", "password": u"mgrpw"})
>>> print user
<GlobalRegistryPrincipal "zope.mgr">

错误的凭据将使认证返回 None

>>> user = plugin.authenticateCredentials(
...            {'login': u"mgr", "password": u"wrongpass"})
>>> user is None
True

>>> user = plugin.authenticateCredentials(
...            {'login': u"anon", "password": u"wrongpass"})
>>> user is None
True

无法单独获取主体信息

>>> print plugin.principalInfo('zope.mgr')
None

>>> print plugin.principalInfo('zorglub')
None

主体文件夹认证

dolmen.app.authentication 引入了一个新的认证插件，用于存储和检索持久主体。此插件是一个容器，可以存储 IPrincipal 对象并按照 IAuthenticatorPlugin 的规定检索它们。

我们验证我们的实现是否符合要求

>>> from dolmen.app.authentication import plugins
>>> IAuthenticatorPlugin.implementedBy(plugins.PrincipalFolderPlugin)
True

>>> plugin = plugins.PrincipalFolderPlugin()
>>> verifyObject(IAuthenticatorPlugin, plugin)
True

为了测试此插件，我们必须创建一个 IPrincipal 对象并将其存储在插件中。然后，我们可以进行查找测试。

为了使认证可插件化，主体认证插件依赖于 3 个接口

• IAccountStatus：如果从 IPrincipal 对象存在到该接口的适配器，则使用它来确定主体是否可以登录。它允许禁用用户帐户并计算该禁用。

• IPasswordChecker：此适配器用于检查凭据。如果不存在（或如果 IPrincipal 对象不提供此接口），则终止认证并返回 None。

• IPrincipalInfo：与上一个插件不同，主体文件夹认证器不直接返回 PrincipalInfo 对象，而是使用适配器检索适当的主体信息对象。这是将特定行为插入我们的认证系统所必需的。

让我们首先实现一个基本的 IPrincipalObject。一旦存储，我们就可以开始查找和适配器实现

>>> from dolmen.app.authentication.tests import User

请参阅以下实现

from dolmen.authentication import IPrincipal
from zope.interface import implements

class User(object):
    implements(IPrincipal)

    def __init__(self, id, title=u"", desc=u""):
        self.id = id
        self.title = title or id
        self.description = desc
        self.groups = []

我们可以验证我们的实现是否符合接口

>>> from dolmen.authentication import IPrincipal
>>> stilgar = User(u"stilgar")
>>> verifyObject(IPrincipal, stilgar)
True

我们可以为我们的 User 类设置一个简单的视图

>>> from grokcore.layout import Page

>>> class UserView(Page):
...     grok.name('index')
...     grok.context(User)
...
...     def render(self):
...         return "<User %s>" % self.context.id

>>> grok_component('index', UserView)
True

实现是一致的。我们现在可以在插件容器中持久化主体

>>> plugin['stilgar'] = stilgar
>>> print [user for user in plugin.keys()]
[u'stilgar']

我们现在可以使用认证 API 尝试查找主体

>>> found = plugin.authenticateCredentials(
...            {'login': 'stilgar', 'password': 'boo'})
>>> found is None
True

主体未找到：我们没有可用的 IPasswordChecker 到 IPasswordChecker 的适配器，因此已终止认证过程。

提供适配器将使我们能够成功检索主体

>>> from dolmen.authentication import IPasswordChecker

>>> class GrantingAccessOnBoo(grok.Adapter):
...     grok.context(IPrincipal)
...     grok.provides(IPasswordChecker)
...
...     def checkPassword(self, pwd):
...         if pwd == 'boo':
...             return True

>>> grok_component('booing', GrantingAccessOnBoo)
True

>>> found = plugin.authenticateCredentials(
...            {'login': 'stilgar', 'password': 'boo'})
>>> found is not None
True

当然，提供错误的密码将返回 None

>>> found = plugin.authenticateCredentials(
...            {'login': 'stilgar', 'password': 'not boo'})
>>> found is None
True

我们还可以通过其 ID 查找主体

>>> print plugin.principalInfo('stilgar')
<dolmen.authentication.principal.LocatablePrincipalInfo ...>

>>> print plugin.principalInfo("unknown")
None

如前所述，可以通过 IAccountStatus 接口打开和关闭特定用户的登录能力

>>> from dolmen.authentication import IAccountStatus

>>> class AllowLogin(grok.Adapter):
...     grok.context(IPrincipal)
...     grok.provides(IAccountStatus)
...
...     @property
...     def status(self):
...         return "No status information available"
...
...     def check(self):
...         if self.context.id != "stilgar":
...             return True
...         return False

>>> grok_component('allow', AllowLogin)
True

在此示例中，我们明确禁止使用标识符“stilgar”的用户通过登录检索

>>> found = plugin.authenticateCredentials(
...            {'login': 'stilgar', 'password': 'boo'})
>>> found is None
True

未授权

想象一下，你访问了一个匿名用户无法访问的页面

>>> from zope.app.wsgi.testlayer import Browser
>>> browser = Browser()
>>> browser.handleErrors = False

>>> browser.open("http://localhost/site/@@edit")
Traceback (most recent call last):
...
Unauthorized: ...

登录页面

为了获取正确的凭据，我们可以简单地使用 dolmen.app.authentication 提供的登录表单登录

>>> browser.open('http://localhost/site/@@login')
>>> loginpage = browser.contents
>>> 'id="login"' in loginpage
True
>>> 'id="password"' in loginpage
True

>>> browser.getControl('Username').value = 'mgr'
>>> browser.getControl('Password').value = 'mgrpw'
>>> browser.getControl('Log in').click()

>>> browser.url
'http://localhost/site'

1.1.1 (2013-11-11)

• 修复了cookie编码错误。

1.1 (2013-11-06)

• 移除了所有dolmen.app依赖项，以便从无用的绑定中解放包。这是通过删除菜单条目和基本模式的集成来实现的。

1.0b4（2013-10-31）

• PrincipalFolderPlugin需要标题。

• 修正了cookie值的解码。

1.0b3（2010-11-18）

• 在管理视图中修正了词汇表的声明方式（角色授权和用户文件夹选择。存在可插拔性，但如果找不到组件，则不会返回基本词汇表。

1.0b2（2010-11-16）

• IChangePassword的变化。密码现在可以是普通字符串或unicode值（通过IProtected）。IChangePassword随后为表单提供模式。请参阅dolmen.authentication中的相应更改。

• GlobalRegistry插件已被修复。它将不再触发AuthenticatedPrincipalCreated事件。这解决了重要错误：事件的处理器曾经认为GlobalRegistry中的所有主体都是认证的，即使是未认证的。

1.0b1（2010-07-28）

• 国际化代码并添加了法语翻译。

• 修正了角色授权UI并通过上下文标签公开。

• 改进了测试覆盖率。

1.0a3（2010-06-25）

• GlobalRegistry插件在principalInfo未找到时不再引发错误。相反，它返回None，如IAuthentication所指定。已添加测试以修复该行为和PrincipalFolder的行为。

1.0a2（2010-06-25）

• 当principalInfo未找到时，PrincipalFolder不再引发错误。相反，它返回None，如IAuthentication所指定。

1.0a1（2010-06-04）

• 删除了未使用和不合理的权限：“CanLogin”和“CanLogout”。

• dolmen.app.authentication现在使用dolmen.menu创建菜单和注册条目。

• 我们现在使用zeam.form表单库而不是z3c.form。

0.1.1 (2010-05-31)

• 更新了翻译。

0.1 (2010-05-30)

• 初始发布。