Apache通过mod_authn_dbd实现数据库认证需搭配mod_dbd，先加载两模块并配置DBDriver与DBDParams连接数据库，AuthDBDUserPWQuery必须返回别名为password的单列密文（如bcrypt），配合AuthBasicProvider dbd和Require valid-user完成Basic认证。
Apache 本身不直接支持基于数据库（如 MySQL、PostgreSQL）的原生访问控制，它没有内置模块能实时查询数据库来验证用户身份或权限。但可以通过 mod_authn_dbd（配合 mod_dbd）实现基于数据库的用户认证——这是 Apache 官方支持的标准方式，适用于 Basic 认证场景。
启用 mod_authn_dbd 和 mod_dbd
确保以下两个模块已启用：
- mod_dbd：提供数据库连接池管理
- mod_authn_dbd：提供基于数据库的用户认证后端
在 Debian/Ubuntu 系统中运行：
a2enmod dbd authn_dbd
然后重启 Apache：systemctl restart apache2
配置数据库连接
在 Apache 主配置文件（如 /etc/apache2/apache2.conf）或虚拟主机配置中添加：
<IfModule mod_dbd.c>
DBDriver mysql
DBDParams "dbname=authdb user=apacheuser pass=apachepass host=localhost"
DBDMin 1
DBDKeep 2
DBDMax 10
DBDExptime 300
</IfModule>
注意：
– DBDriver 支持 mysql、pgsql、sqlite3（取决于编译时支持）；
– DBDParams 中的数据库账号需仅拥有 SELECT 权限（例如只查 users 表）；
– 建议使用 Unix socket 或限制 host 为 127.0.0.1 提升安全性。
定义认证查询语句
Apache 需要一条 SQL 查询来校验用户名和密码。假设用户表结构如下：
Apache Superset 是一个广泛采用的开源 BI 平台，用于 SQL 探索、图表构建和仪表板交付。当代理需要查询仓库数据、组装仪表板或使用成熟的分析界面解释指标而不是临时笔记本代码时，此技能非常有用。
CREATE TABLE users (
username VARCHAR(64) PRIMARY KEY,
password CHAR(60) NOT NULL /* 推荐 bcrypt 存储 */
);
在对应目录或位置块中配置：
<Directory "/var/www/restricted">
AuthType Basic
AuthName "DB-Protected Area"
AuthBasicProvider dbd
Require valid-user
# 查询语句：返回单行，含 password 字段
AuthDBDUserPWQuery "SELECT password FROM users WHERE username = %s"
</Directory>
✅ 关键点：
– AuthBasicProvider dbd 指明使用数据库后端；
– AuthDBDUserPWQuery 必须返回一个 password 字段，值应为 bcrypt 或 SHA1 加密后的密文（Apache 支持 bcrypt、sha1、md5，推荐 bcrypt）；
– 不支持明文比对，也不支持动态权限字段（如 role、active 等），如需扩展，需结合 mod_authz_dbd 或自定义逻辑。
可选：基于数据库的角色/权限控制
若还需按角色授权（如 require group admin），可启用 mod_authz_dbd（Apache 2.4.10+）：
AuthDBDUserToGroupQuery "SELECT groupname FROM user_groups WHERE username = %s"
Require group admin editors
对应表结构示例：
CREATE TABLE user_groups (
username VARCHAR(64),
groupname VARCHAR(64),
PRIMARY KEY (username, groupname)
);
⚠️ 注意：该功能依赖较新版本 Apache，且需确保查询结果严格匹配组名，无多余空格或换行。
