NoSQL 与搜索 / 系统课时

启用认证并管理 SCRAM 用户

启用认证并管理 SCRAM 用户

本课完成一个自管理 MongoDB 实例的最小安全闭环:先建立可继续管理用户的管理员,再启用 authorization,随后为应用创建只具备业务库读写权限的 SCRAM-SHA-256 用户,并验证 authenticationDatabase 配置。

学习目标

  • 能启用 security.authorization 并完成首次管理员切换
  • 能创建管理用户与最小权限应用用户,并显式使用 SCRAM-SHA-256
  • 能正确区分业务数据库与 authenticationDatabase,避免认证失败

先理解用户属于哪个认证数据库

MongoDB 的 SCRAM 校验同时使用用户名、密码和认证数据库。用户记录创建在哪个数据库,那个数据库就是它的 authenticationDatabase;角色可以授权到其他数据库,因此“认证数据库”和“有权限访问的数据库”不是同一个概念。:contentReference[oaicite:8]{index=8}

例如,管理员创建在 admin,连接时应使用 authSource=admin;应用用户创建在 appdb,就应使用 authSource=appdb。把两者混用时,即使用户名和密码完全正确,也会得到认证失败。

创建首个用户管理员

在尚未启用访问控制时,只应从受控主机完成首次用户创建。首个用户至少要能继续管理其他用户,否则启用认证后可能把自己锁在系统外。这里给管理员 userAdminAnyDatabase 负责用户管理,再给 clusterAdmin 负责集群级运维;不授予业务库读写权限。

javascript
db.getSiblingDB("admin").createUser({
  user: "securityAdmin",
  pwd: passwordPrompt(),
  roles: [
    { role: "userAdminAnyDatabase", db: "admin" },
    { role: "clusterAdmin", db: "admin" }
  ],
  mechanisms: [ "SCRAM-SHA-256" ]
})

预期输出

text
{ ok: 1 }

passwordPrompt() 让密码通过交互输入,不会把明文密码直接写进命令历史。创建在 admin 的 securityAdmin 后续必须以 admin 作为认证数据库。MongoDB 的 SCRAM 支持 SCRAM-SHA-1 与 SCRAM-SHA-256,这里显式限制为后者,便于统一客户端配置。:contentReference[oaicite:10]{index=10}

打开 authorization 并重启

编辑 mongod.conf,加入或确认以下配置。YAML 本身不是命令,保存后需要重启 mongod 才会生效。

yaml
security:
  authorization: enabled

启用后,未认证客户端不能再按默认方式读写数据;已认证用户也只能执行角色允许的操作。security.authorization 的默认状态是 disabled,设置为 enabled 后由 RBAC 强制授权。:contentReference[oaicite:11]{index=11}

以下以 Linux 的 systemd 服务安装为例执行重启并验证服务状态;其他部署方式使用等价的重启操作。

bash
sudo systemctl restart mongod
systemctl is-active mongod

预期输出

text
active

如果服务没有变为 active,先检查 mongod.conf 的 YAML 缩进和服务日志,而不是反复改密码。认证配置解析失败属于启动问题,用户凭据尚未参与。

认证管理员并创建应用用户

重新连接时显式指定管理员的认证数据库。-p 不跟明文值,mongosh 会提示输入密码。

bash
mongosh "mongodb://<HOST>:<PORT>/?authSource=admin&authMechanism=SCRAM-SHA-256" -u securityAdmin -p --quiet --eval 'printjson(db.runCommand({connectionStatus:1,showPrivileges:false}))'

预期输出

text
{
  authInfo: {
    authenticatedUsers: [
      { user: 'securityAdmin', db: 'admin' }
    ],
    authenticatedUserRoles: [
      { role: 'userAdminAnyDatabase', db: 'admin' },
      { role: 'clusterAdmin', db: 'admin' }
    ]
  },
  ok: 1
}

<HOST>、<PORT> 会随环境变化。authenticatedUsers 中出现 securityAdmin 且数据库为 admin,说明认证数据库配置正确;connectionStatus 用于报告当前连接的认证状态。:contentReference[oaicite:12]{index=12}

随后在管理员会话中把应用用户创建在真正的业务数据库 appdb,只授予该库的 readWrite。

javascript
db.getSiblingDB("appdb").createUser({
  user: "app_rw",
  pwd: passwordPrompt(),
  roles: [
    { role: "readWrite", db: "appdb" }
  ],
  mechanisms: [ "SCRAM-SHA-256" ]
})

预期输出

text
{ ok: 1 }

这个用户的认证数据库是 appdb,不是 admin。应用连接字符串可以把业务默认数据库和认证数据库都指向 appdb,避免在驱动升级或连接池配置中依赖隐式推断。

用最小权限做验收

退出管理员会话后,用应用用户重新连接,避免在同一个 mongosh 会话中叠加多个已认证用户的权限。MongoDB 文档明确指出,切换用户应退出并重新启动 mongosh。:contentReference[oaicite:13]{index=13}

bash
mongosh "mongodb://<HOST>:<PORT>/appdb?authSource=appdb&authMechanism=SCRAM-SHA-256" -u app_rw -p --eval 'db.auth_probe.insertOne({status:"ok"}); printjson(db.auth_probe.findOne({status:"ok"}))'

预期输出

text
{
  _id: ObjectId('<ID>'),
  status: 'ok'
}

能写入并读回 appdb,说明 SCRAM 凭据、authSource 与 readWrite 角色都已生效。生产环境还应把管理员凭据与应用凭据分开保管、定期轮换,并让应用用户只获得实际需要的角色;不要为了“省事”把应用连接账号设成 root 或 readWriteAnyDatabase。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

启用认证并管理 SCRAM 用户

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通