配置 Kerberos 和 Active 目录 授权

为运行 MongoDB 的服务器配置 TLS/SSL。

要通过 TLS/SSL 连接到 AD (AD)服务器，mongod 或 mongos 需要访问权限AD 服务器的证书颁发机构 (CA) 证书。

在Linux上，通过 ldap.conf文件中的 TLS_CACERT 或 TLS_CACERTDIR 选项指定 AD 服务器的 CA 证书。

平台的包管理器在安装 MongoDB Enterprise 的libldap 依赖项时创建 ldap.conf 文件。有关配置文件或引用选项的完整文档，请参阅 ldap .conf。

在 Microsoft Windows上，使用平台的档案管理工具加载AD服务器的证书颁发机构 (CA) 证书。 确切的档案管理工具取决于Windows版本。 要使用该工具，请参阅适用于您的Windows版本的文档。

如果mongod或mongos无法访问AD CA 文件，则他们无法创建与 Active Directory 服务器的 TLS/SSL 连接。

或者，将 security.ldap.transportSecurity 设置为 none 以禁用 TLS/SSL。

（仅限 Windows）为 MongoDB Windows 服务分配服务主体名称。

对于在 Windows 操作系统上运行的 MongoDB 服务器，必须使用 setspn.exe 将服务主体名称 (SPN) 分配给运行 MongoDB 服务的帐户。

setspn.exe -S <service>/<fully qualified domain name> <service account name>

setspn.exe -S mongodb/mongodbserver.example.com mongodb_dev@example.com

（仅限 Linux）为 MongoDB 服务器创建密钥表文件。

对于 Linux 平台上运行的 MongoDB 服务器，必须确保服务器具有特定于该服务器上运行的 MongoDB 实例的密钥表文件的副本。

您必须授予运行 MongoDB 服务的 Linux 用户对密钥表文件的读取权限。记下密钥表文件位置的完整路径。

连接到 MongoDB Server。

使用mongosh --host和--port 选项，使用 连接到MongoDB服务器。

mongosh --host <hostname> --port <port>

如果您的MongoDB服务器当前强制执行身份验证，则您必须以具有角色管理特权（例如admin 或userAdminuserAdminAnyDatabase --authenticationMechanism提供的特权）的用户身份在 数据库中进行身份验证。包括适用于MongoDB Server 配置的身份验证机制的相应 。

mongosh --host <hostname> --port <port> --username <user> --password <pass> --authenticationDatabase="admin" --authenticationMechanism="<mechanism>"

创建用户管理角色。

要使用 AD管理MongoDB用户，您需要在可以创建和管理角色的 admin数据库上创建至少一个角色，例如 userAdmin 或 userAdminAnyDatabase 提供的角色。

角色的名称必须与 AD 群组的标识名完全匹配。该组必须至少有一个 AD 用户作为节点。

给定可用的 Active Directory 群组，执行以下操作：

• 创建以 AD群组CN=dba,CN=Users,DC=example,DC=com 命名的角色，并且

• 为其分配 admin 数据库上的 userAdminAnyDatabase 角色。

var admin = db.getSiblingDB("admin")
admin.createRole(
   {
     role: "CN=dba,CN=Users,DC=example,DC=com",
     privileges: [],
     roles: [ "userAdminAnyDatabase" ]
   }
)

您也可以为用户应具有用户管理权限的每个数据库授予 userAdmin 角色。这些角色为角色创建和管理提供必要的权限。

创建 MongoDB 配置文件。

MongoDB 配置文件是具有 .conf 文件扩展名的纯文本 YAML 文件。

• 如果您正在升级现有的 MongoDB 部署，请复制当前配置文件并从该副本开始工作。

• （仅限 Linux）如果这是新部署，并且您使用了平台的包管理器来安装 MongoDB Enterprise，则该安装将包含 /etc/mongod.conf 默认配置文件。使用该默认配置文件，或复制该文件以供使用。

• 如果不存在此类文件，请创建一个扩展名为 .conf 的空文件，然后从该新配置文件进行操作。

配置 MongoDB 以连接到 Active Directory。

在MongoDB配置文件中，将 security.ldap.servers设立为 AD服务器的托管和端口。如果您的 AD 基础架构包含多个用于复制的AD 服务器，请将服务器的托管和端口指定为 security.ldap.servers 的逗号分隔列表。

security:
  ldap:
    servers: "activedirectory.example.net"

MongoDB 必须绑定到AD服务器才能执行查询。 默认情况下，MongoDB 使用简单身份验证机制将自身绑定到AD服务器。

或者，您可以在配置文件中配置以下设置，以使用 SASL 绑定到 AD服务器：

• 将 security.ldap.bind.method 设置为 sasl。

• security.ldap.bind.saslMechanisms，指定一个字符串，表示 AD 服务器支持的以逗号分隔的 SASL 机制。

本教程使用默认的 simple LDAP 身份验证机制。

配置 MongoDB 进行 Kerberos 身份验证。

在 MongoDB 配置文件中，将 security.authorization 设置为enabled，并将 setParameter authenticationMechanisms 设置为 GSSAPI

要启用通过 Kerberos 进行身份验证，请在配置文件中包含以下内容：

security:
  authorization: "enabled"
setParameter:
  authenticationMechanisms: "GSSAPI"

为授权配置 LDAP 查询模板。

在MongoDB配置文件中，将security.ldap.authz.queryTemplate 设立为 RFC4516 格式的LDAP查询URL模板。

在模板中，您可以使用以下任一项：

• {USER} 占位符，用于将通过身份验证的用户名替换到 LDAP 查询 URL 中。

• {PROVIDED_USER} 占位符可在 LDAP 查询中替换为提供的用户名（即在身份验证或 LDAP 转换之前）。

设计查询模板以检索用户的群组。

security:
  ldap:
    authz:
      queryTemplate:
        "DC=example,DC=com??sub?(&(objectClass=group)(member:1.2.840.113556.1.4.1941:={USER}))"

MongoDB将每个返回的群组DN 映射到 admin数据库上的一个角色。对于每个映射的群组DN，如果 admin数据库上存在其名称与 DN 完全匹配的现有角色，MongoDB将向用户授予分配给该角色的角色和特权。

匹配规则 LDAP_MATCHING_RULE_IN_CHAIN 要求提供身份验证用户的完整 DN。由于Kerberos要求使用用户的 userPrincipalName 进行身份验证，因此您必须使用security.ldap.userToDNMapping 将传入的用户名转换为 DN。下一步将提供有关转换传入用户名以支持queryTemplate 的指导。

转换传入的用户名，以便通过 Active Directory 进行身份验证。

在MongoDB配置文件中，设立userToDNMapping 以将身份验证用户提供的用户名转换为 AD DN，以支持queryTemplate。

security:
  ldap:
    userToDNMapping:
      '[
         {
            match : "(.+)",
            ldapQuery: "DC=example,DC=com??sub?(userPrincipalName={0})"
         }
    ]'

您必须修改给定的示例配置以匹配您的部署。例如，ldapQuery 基本标识名 必须与包含用户实体的基本标识名匹配。可能需要进行其他修改才能支持您的 AD 部署。

DC=example,DC=com??sub?(userPrincipalName=alice@ENGINEERING.EXAMPLE.COM)

配置查询凭证。

MongoDB 需要凭证才能在 AD 服务器上执行查询。

在配置文件中配置以下设置：

• security.ldap.bind.queryUser，为 Kerberos 用户指定 mongod 或 mongos 绑定，以便在 AD 服务器上执行查询。

• security.ldap.bind.queryPassword，为指定的 queryUser 指定密码。

security:
  ldap:
    bind:
      queryUser: "mongodbadmin@dba.example.com"
      queryPassword: "secret123"

在Windows MongoDB服务器上，您可以将 security.ldap.bind.useOSDefaults设立为 true，以使用操作系统用户的凭证，而不是 queryUser 和 queryPassword。

queryUser 必须具有代表 MongoDB 执行所有 LDAP 查询的权限。

可选：添加其他配置设置。

根据配置要求包括其他选项。例如，如果您希望远程客户端连接到部署，或者部署节点运行在不同的主机上，请指定 net.bindIp 设置。

使用 Kerberos 身份验证和 Active Directory 授权启动 MongoDB 服务器。

使用 --config 选项启动 MongoDB 服务器，并指定在此过程中创建的配置文件的路径。如果 MongoDB 服务器当前正在运行，请做好适当的准备以停止服务器。

Linux MongoDB Servers

在 Linux 上，您必须指定 KRB5_KTNAME 环境变量，从而指定用于 MongoDB 服务器的密钥表文件路径。

env KRB5_KTNAME <path-to-keytab> mongod --config <path-to-config-file>

Microsoft Windows MongoDB Servers

在Windows上，您必须按照此过程前面的配置以服务主体帐户身份启动 MongoDB Server：

mongod.exe --config <path-to-config-file>

连接到 MongoDB Server。

连接到 MongoDB 服务器，以特定用户身份进行身份验证，该用户的直接或可传递群组成员身份对应于 admin 数据库上具有 userAdmin、userAdminAnyDatabase 的 MongoDB 角色或具有同等特权的自定义角色。

使用 对MongoDBmongosh 服务器进行身份验证，设立以下选项：

• --host 使用 MongoDB Server 的主机名

• --port 使用 MongoDB 服务器的端口

• --username 到用户的 userPrincipalName

• --password替换为用户的密码（或省略以让mongosh 提示输入密码）

• --authenticationMechanism to "GSSAPI"

• --authenticationDatabase to "$external"

mongosh --username sam@DBA.EXAMPLE.COM --password  --authenticationMechanisms="GSSAPI" --authenticationDatabase "$external" --host <hostname> --port <port>

Windows MongoDB部署必须使用 mongo.exe 而不是 mongosh。

根据已配置 Active Directory 用户，用户可成功通过身份验证并获得相应权限。

创建用于映射返回的 AD 群组的角色。

对于 AD服务器上要用于MongoDB授权的每个群组，必须在MongoDB服务器的 admin数据库上创建一个匹配的角色。

db.getSiblingDB("admin").createRole(
   {
     role: "CN=PrimaryApplication,CN=Users,DC=example,DC=com",
     privileges: [],
     roles: [
       { role: "readWrite", db: "PrimaryApplication" }
     ]
   }
)

可选：将现有用户从$external 转换到 Active Directory服务器。

如果使用在$external数据库上配置的用户升级现有安装，则必须满足每个用户的以下要求，以确保在为 Kerberos 身份验证和AD授权配置 MongoDB 后具有访问权限：

• 用户在AD服务器上有相应的用户对象。

• 用户具有AD服务器上相应群组的成员资格。

• MongoDB 包含以用户的 AD 组命名的 admin 数据库上的角色，以便授权用户保留其权限。

{
  user : "joe@ANALYTICS.EXAMPLE.COM",
  roles: [
    { role : "read", db : "web_analytics" },
    { role : "read", db : "PrimaryApplication" }
  ]
}

db.getSiblingDB("admin").createRole(
   {
     role: "CN=marketing,CN=Users,DC=example,DC=com",
     privileges: [],
     roles: [
       { role: "read", db: "web_analytics" }
       { role: "read", db: "PrimaryApplication" }
     ]
   }
)

如果想要继续允许非 $external 数据库上的用户访问 MongoDB，则必须将 SCRAM 身份验证机制（例如 SCRAM-SHA-1和/或 SCRAM-SHA-256）纳入 setParameter authenticationMechanisms 配置选项中。

setParameter:
  authenticationMechanisms: "GSSAPI,SCRAM-SHA-1,SCRAM-SHA-256"

或者，按照上述过程将非$external用户转换到AD 。