zope.app.security 5.0.0

验证实用程序的查询视图

常规身份验证服务不会提供 接口，但它本身是可查询的，因为它提供了 获取主体（名称） 方法：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

>>> class MyAuthUtility:
...     data = {'jim': Principal(42), 'don': Principal(0),
...             'stephan': Principal(1)}
...
...     def getPrincipals(self, name):
...         return [principal
...                 for id, principal in self.data.items()
...                 if name in id]

现在我们有了可查询的文件，我们为它创建视图：

>>> from zope.app.security.browser.auth import AuthUtilitySearchView
>>> from zope.publisher.browser import TestRequest
>>> request = TestRequest()
>>> view = AuthUtilitySearchView(MyAuthUtility(), request)

这允许我们呈现搜索表单。

>>> print(view.render('test')) # doctest: +NORMALIZE_WHITESPACE
<h4>principals.zcml</h4>
<div class="row">
<div class="label">
Search String
</div>
<div class="field">
<input type="text" name="test.searchstring" />
</div>
</div>
<div class="row">
<div class="field">
<input type="submit" name="test.search" value="Search" />
</div>
</div>

如果我们要求结果：

>>> view.results('test')

我们没有，因为我们没有提供。但如果我们输入：

>>> request.form['test.searchstring'] = 'n'

我们仍然没有任何消息：

>>> view.results('test')

因为我们没有按按钮。所以让我们按下按钮：

>>> request.form['test.search'] = 'Search'

这样我们就可以得到结果了（！）

>>> ids = list(view.results('test'))
>>> ids.sort()
>>> ids
[0, 1]

登录/注销片段

课程登录信息：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

用作视图以生成适合登录或 基于当前主体是否经过身份验证而注销。

当当前主体未经身份验证时，它提供 IunauthenticatedPrincipal:

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

当loginlogout用于具有未经身份验证主体的请求时， 它为用户提供"登录"链接：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

此时尝试登录将失败，因为没有 已授权委托人：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

有一个故障保护将尝试请求HTTP基本身份验证：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

当然，未经授权的主体会被确认注销：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

但是，注销的行为不同。并非所有的身份验证协议（即 凭据提取程序/挑战者）支持"注销"。而且，我们没有 知道管理员如何配置zope的身份验证。我们的解决方案是 依赖管理员明确告诉我们站点支持注销。

默认情况下，loginlogout片段不会为 未经认证的委托人。为了说明这一点，我们首先用 未经验证的主体：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

在这种情况下，默认行为是不返回代码段：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

此时，登录将正确地指向下一个url，或者 到确认页：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

同样，对于http基本身份验证：

>>> class Principal:
...     def __init__(self, id):
...         self.id = id

要显示注销提示，管理员必须注册一个标记适配器，该适配器提供 界面：

>>> class MyAuthUtility:
...     data = {'jim': Principal(42), 'don': Principal(0),
...             'stephan': Principal(1)}
...
...     def getPrincipals(self, name):
...         return [principal
...                 for id, principal in self.data.items()
...                 if name in id]

此标志指向该站点支持注销的loginlogout。有个"禁止操作" 适配器可以是R为此注册：

>>> class MyAuthUtility:
...     data = {'jim': Principal(42), 'don': Principal(0),
...             'stephan': Principal(1)}
...
...     def getPrincipals(self, name):
...         return [principal
...                 for id, principal in self.data.items()
...                 if name in id]

现在，当我们将loginlogout与未经验证的主体一起使用时，会得到一个注销 提示：

>>> class MyAuthUtility:
...     data = {'jim': Principal(42), 'don': Principal(0),
...             'stephan': Principal(1)}
...
...     def getPrincipals(self, name):
...         return [principal
...                 for id, principal in self.data.items()
...                 if name in id]

我们可以注销此主体，传递一个URL以重定向到：

>>> class MyAuthUtility:
...     data = {'jim': Principal(42), 'don': Principal(0),
...             'stephan': Principal(1)}
...
...     def getPrincipals(self, name):
...         return [principal
...                 for id, principal in self.data.items()
...                 if name in id]

更改