Apache模块mod_authz_dbd

需求指令

Require 在授权阶段使用Apache的指令，以确保允许用户访问资源。mod_authz_dbd延长授权类型的dbd-group，dbd-login和 dbd-logout。

从v2.4.8开始，DBD require指令支持表达式。

需要dbd-group

该指令指定用户获得访问权限所需的组成员身份。

Require dbd-group team
AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"

需要dbd登录

该指令指定要运行的查询，指示用户已登录。

Require dbd-login
AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"

需要dbd注销

该伪指令指定要运行的查询，指示用户已注销。

Require dbd-logout
AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"

数据库登录

除了检查组成员资格的标准授权功能之外，该模块还可以通过数据库支持的登录/注销功能提供服务器端用户会话管理。具体来说，每当用户访问指定的URL时，它就可以更新数据库中用户的会话状态（当然，这取决于提供必要凭据的用户）。

这通过定义两种特殊Require类型来起作用 ： Require dbd-login和Require dbd-logout。有关用法的详细信息，请参见下面的配置示例。

客户端登录集成

一些管理员可能希望实现与该模块提供的服务器端登录/注销功能协同工作的客户端会话管理，例如，通过在用户登录或注销时设置或取消设置HTTP cookie或其他此类令牌， 。

为了支持这种集成，请mod_authz_dbd导出一个可选的挂钩，该挂钩将在数据库中更新用户状态时运行。然后，其他会话管理模块可以使用该钩子来实现启动和结束客户端会话的功能。

配置示例

# mod_dbd configuration
DBDriver pgsql
DBDParams "dbname=apacheauth user=apache pass=xxxxxx"

DBDMin  4
DBDKeep 8
DBDMax  20
DBDExptime 300

<Directory "/usr/www/my.site/team-private/">
  # mod_authn_core and mod_auth_basic configuration
  # for mod_authn_dbd
  AuthType Basic
  AuthName Team
  AuthBasicProvider dbd

  # mod_authn_dbd SQL query to authenticate a logged-in user
  AuthDBDUserPWQuery \
    "SELECT password FROM authn WHERE user = %s AND login = 'true'"

  # mod_authz_core configuration for mod_authz_dbd
  Require dbd-group team

  # mod_authz_dbd configuration
  AuthzDBDQuery "SELECT group FROM authz WHERE user = %s"

  # when a user fails to be authenticated or authorized,
  # invite them to login; this page should provide a link
  # to /team-private/login.html
  ErrorDocument 401 "/login-info.html"

  <Files "login.html">
    # don't require user to already be logged in!
    AuthDBDUserPWQuery "SELECT password FROM authn WHERE user = %s"

    # dbd-login action executes a statement to log user in
    Require dbd-login
    AuthzDBDQuery "UPDATE authn SET login = 'true' WHERE user = %s"

    # return user to referring page (if any) after
    # successful login
    AuthzDBDLoginToReferer On
  </Files>

  <Files "logout.html">
    # dbd-logout action executes a statement to log user out
    Require dbd-logout
    AuthzDBDQuery "UPDATE authn SET login = 'false' WHERE user = %s"
  </Files>
</Directory>