使用 x. 509 证书进行自管理 MongoDB 的成员身份验证
MongoDB 支持与安全 TLS/SSL 连接一起使用的 x.509 证书身份验证。分片集群节点和副本集节点可以使用 x.509 证书验证其集群或副本集节点身份,而不是使用密钥文件。成员身份验证是一个内部进程。
注意
MongoDB 在支持 TLS 1.1+ 的系统上禁用对 TLS 1.0 加密的支持。
启用内部身份验证还能在自管理部署中实现基于角色的访问控制 。客户端必须通过用户身份验证,才能连接并在部署中执行操作。
有关向部署中添加用户的说明,请参阅“在托管部署中管理用户和角色”教程。
有关使用 x.509 证书对用户进行身份验证的说明,请参阅使用 x.509 证书对客户端进行身份验证教程。
重要
TLS/SSL、PKI(公钥基础设施)证书(尤其是 x.509 证书)和证书颁发机构的完整描述已超出本文档的范围。本教程假设您已了解 TLS/SSL 且能访问有效的 x.509 证书。
成员 x.509 证书
注意
您必须拥有有效的 x.509 证书。
如果指定 --tlsAllowInvalidCertificates
或net.tls.allowInvalidCertificates: true
,则无效证书仅足以建立 TLS 连接,但不足以进行身份验证。
证书要求
用于验证分片集群或副本集成员资格的成员证书( net.tls.clusterFile
,如果已指定,则为net.tls.certificateKeyFile
)必须具有以下属性:
必须由一个证书颁发机构 (CA) 颁发所有 x.分片集群或副本集节点的509证书。
在成员证书的
subject
中找到的标识名 (DN
) 必须为以下至少一个属性指定非空值:组织 (
O
)组织单位 (
OU
)域组件 (
DC
)
组织属性(
O
)、组织单位属性(OU
)和域组件(DC
)必须与net.tls.clusterFile
和net.tls.certificateKeyFile
证书中的属性相匹配,其他集群成员(或tlsX509ClusterAuthDNOverride
值,如果已设置)。要匹配,证书必须匹配这些属性的所有规范,甚至是这些属性的非规范。 属性的顺序并不重要。
在以下示例中,两个
DN
包含O
和OU
的匹配规范以及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成员证书。 每个证书的
O
、OU
和DC
标识名 (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
或 mongos
实例。
注意
leafygreen-ui-tqgtui 和 leafygreen-ui-tqgtui,默认绑定到本地主机。如果部署的成员在不同的主机上运行,或者希望远程客户端连接到部署,则必须指定 --bind_ip
或 net.bindIp
。
使用命令行选项(tls
)
注意
本部分中的过程使用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 身份验证,则必须指定 --tlsCAFile
或 net.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 身份验证,则必须指定 --tlsCAFile
或 net.tls.CAFile
,除非使用 --tlsCertificateSelector
或 --net.tls.certificateSelector
。
包括特定配置所需的任何其他选项(TLS/SSL 或其他)。
如需了解更多信息,请参阅为 TLS/SSL 配置 mongod
和 mongos
。
使用命令行选项(ssl
)
注意
本部分中的过程使用已弃用的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 身份验证,则必须指定 --tlsCAFile
或 net.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 身份验证,则必须指定 --tlsCAFile
或 net.tls.CAFile
,除非使用 --tlsCertificateSelector
或 --net.tls.certificateSelector
。
包括特定配置所需的任何其他选项(TLS/SSL 或其他)。
如需了解更多信息,请参阅为 TLS/SSL 配置 mongod
和 mongos
。
更多信息
要从密钥文件内部身份验证升级到 x. 509内部身份验证,请参阅将自管理MongoDB从密钥文件身份验证升级到 x。 509身份验证。
如需将证书滚动更新为 DN
不同的新证书,请参阅“在自管集群上滚动更新包含新 DN 的 x.509 证书”。