Docs 菜单
Docs 主页
/
MongoDB Manual
/ / / /

使用 x. 509 证书进行自管理 MongoDB 的成员身份验证

在此页面上

  • 成员 x.509 证书
  • 配置副本集/分片集群
  • 更多信息

MongoDB 支持与安全 TLS/SSL 连接一起使用的 x.509 证书身份验证。分片集群节点和副本集节点可以使用 x.509 证书验证其集群或副本集节点身份,而不是使用密钥文件。成员身份验证是一个内部进程。

注意

MongoDB 在支持 TLS 1.1+ 的系统上禁用对 TLS 1.0 加密的支持。

启用内部身份验证还能在自管理部署中实现基于角色的访问控制 。客户端必须通过用户身份验证,才能连接并在部署中执行操作。

重要

TLS/SSL、PKI(公钥基础设施)证书(尤其是 x.509 证书)和证书颁发机构的完整描述已超出本文档的范围。本教程假设您已了解 TLS/SSL 且能访问有效的 x.509 证书。

注意

您必须拥有有效的 x.509 证书。

如果指定 --tlsAllowInvalidCertificatesnet.tls.allowInvalidCertificates: true ,则无效证书仅足以建立 TLS 连接,但不足以进行身份验证。

用于验证分片集群或副本集成员资格的成员证书( net.tls.clusterFile ,如果已指定,则为net.tls.certificateKeyFile )必须具有以下属性:

  • 必须由一个证书颁发机构 (CA) 颁发所有 x.分片集群或副本集节点的509证书。

  • 在成员证书的subject中找到的标识名 ( DN ) 必须为以下至少一个属性指定非空值:

    • 组织 (O)

    • 组织单位 (OU)

    • 域组件 (DC)

  • 组织属性( O )、组织单位属性( OU )和域组件( DC )必须与net.tls.clusterFilenet.tls.certificateKeyFile证书中的属性相匹配,其他集群成员(或tlsX509ClusterAuthDNOverride值,如果已设置)。

    要匹配,证书必须匹配这些属性的所有规范,甚至是这些属性的非规范。 属性的顺序并不重要。

    在以下示例中,两个DN包含OOU的匹配规范以及DC属性的非规范。

    CN=host1,OU=Dept1,O=MongoDB,ST=NY,C=US
    C=US, ST=CA, O=MongoDB, OU=Dept1, CN=host2

    但是,以下两个DN包含不匹配的OU属性,因为一个 包含两个OU规范,而另一个仅包含一个规范。

    CN=host1,OU=Dept1,OU=Sales,O=MongoDB
    CN=host2,OU=Dept1,O=MongoDB
  • 在多集群部署中,每个集群必须使用不同的 X. 509成员证书。 每个证书的OOUDC标识名 (DN) 字段必须具有唯一值。

    如果两个集群的证书具有相同 DN 值,则一个集群上的受感染服务器可以作为另一个集群的成员进行身份验证。

  • 公用名 ( CN ) 或主题备用名称 ( SAN ) 条目之一必须与其他集群成员的服务器主机名匹配。 从 MongoDB 4.2 开始,在比较SAN时,MongoDB 可以比较 DNS 名称或 IP 地址。 在以前的版本中,MongoDB 仅比较 DNS 名称。

    例如,集群的证书可能具有以下主题:

    subject= CN=<myhostname1>,OU=Dept1,O=MongoDB,ST=NY,C=US
    subject= CN=<myhostname2>,OU=Dept1,O=MongoDB,ST=NY,C=US
    subject= CN=<myhostname3>,OU=Dept1,O=MongoDB,ST=NY,C=US
  • 如果用作 certificateKeyFile 的证书包含 extendedKeyUsage,则该值必须同时包含 clientAuth(“TLS Web 客户端身份验证”)和 serverAuth(“TLS Web 服务器身份验证”)。

    extendedKeyUsage = clientAuth, serverAuth
  • 如果用作 clusterFile 的证书包含 extendedKeyUsage,则该值必须包含 clientAuth

    extendedKeyUsage = clientAuth
  • x.509 证书不能过期。

    如果显示的 x.509 证书在 mongod/mongos 主机系统时间后的 30 天内过期,则 mongod / mongos 会在连接时记录警告。

在滚动升级程序之外,副本集分片集群的每个组件都应使用相同的 --clusterAuthMode 设置,以确保能安全地连接到部署中的所有其他组件。

对于副本集部署,其中包括副本集的所有 mongod 节点。

对于分片集群部署,其中包括所有 mongodmongos 实例。

注意

leafygreen-ui-tqgtuileafygreen-ui-tqgtui,默认绑定到本地主机。如果部署的成员在不同的主机上运行,或者希望远程客户端连接到部署,则必须指定 --bind_ipnet.bindIp

注意

本部分中的过程使用tls设置/选项。 有关使用已弃用的ssl别名的过程,请参阅使用命令行选项 ( ssl )。

由于 MongoDB 始终支持 TLS 1.0 及更高版本,因此 tls 设置/选项可提供与 ssl 选项相同的功能。

mongod --replSet <name> --tlsMode requireTLS --clusterAuthMode x509 --tlsClusterFile <path to membership certificate and key PEM file> --tlsCertificateKeyFile <path to TLS/SSL certificate and key file> --sslCAFile <path to root CA file> --bind_ip localhost,<hostname(s)|ip address(es)>

重要

如果使用 x.509 身份验证,则必须指定 --tlsCAFilenet.tls.CAFile,除非使用 --tlsCertificateSelector--net.tls.certificateSelector

包括特定配置所需的任何其他选项(TLS/SSL 或其他)。对于

security:
clusterAuthMode: x509
net:
tls:
mode: requireTLS
certificateKeyFile: <path to its TLS/SSL certificate and key file>
CAFile: <path to root CA PEM file to verify received certificate>
clusterFile: <path to its certificate key file for membership authentication>
bindIp: localhost,<hostname(s)|ip address(es)>

重要

如果使用 x.509 身份验证,则必须指定 --tlsCAFilenet.tls.CAFile,除非使用 --tlsCertificateSelector--net.tls.certificateSelector

包括特定配置所需的任何其他选项(TLS/SSL 或其他)。

如需了解更多信息,请参阅为 TLS/SSL 配置 mongodmongos

注意

本部分中的过程使用已弃用的ssl设置/选项。 有关使用tls别名的过程,请参阅使用命令行选项 ( tls )。

由于 MongoDB 始终支持 TLS 1.0 及更高版本,因此 tls 设置/选项可提供与 ssl 选项相同的功能。

要指定用于内部集群节点身份验证的 x.509 证书,请附加额外的 TLS/SSL 选项 --clusterAuthMode--sslClusterFile,如以下针对副本集节点的示例所示:

mongod --replSet <name> --sslMode requireSSL --clusterAuthMode x509 --sslClusterFile <path to membership certificate and key PEM file> --sslPEMKeyFile <path to TLS/SSL certificate and key PEM file> --sslCAFile <path to root CA PEM file> --bind_ip localhost,<hostname(s)|ip address(es)>

重要

如果使用 x.509 身份验证,则必须指定 --tlsCAFilenet.tls.CAFile,除非使用 --tlsCertificateSelector--net.tls.certificateSelector

包括特定配置所需的任何其他选项(TLS/SSL 或其他)。

security:
clusterAuthMode: x509
net:
ssl:
mode: requireSSL
PEMKeyFile: <path to TLS/SSL certificate and key PEM file>
CAFile: <path to root CA PEM file>
clusterFile: <path to x.509 membership certificate and key PEM file>
bindIp: localhost,<hostname(s)|ip address(es)>

重要

如果使用 x.509 身份验证,则必须指定 --tlsCAFilenet.tls.CAFile,除非使用 --tlsCertificateSelector--net.tls.certificateSelector

包括特定配置所需的任何其他选项(TLS/SSL 或其他)。

如需了解更多信息,请参阅为 TLS/SSL 配置 mongodmongos

要从密钥文件内部身份验证升级到 x. 509内部身份验证,请参阅将自管理MongoDB从密钥文件身份验证升级到 x。 509身份验证。

如需将证书滚动更新为 DN 不同的新证书,请参阅“在自管集群上滚动更新包含新 DN 的 x.509 证书”。

后退

轮换分片集群密钥