Skip to content

Commit c6aec4a

Browse files
mdb-ashleyAshley Brown
andauthored
Incorporating internal review comments (#734)
Co-authored-by: Ashley Brown <[email protected]>
1 parent 9f84a92 commit c6aec4a

File tree

1 file changed

+24
-19
lines changed

1 file changed

+24
-19
lines changed

source/includes/extracts-x509-certificate.yaml

Lines changed: 24 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -15,20 +15,26 @@ content: |
1515
1616
- Each unique MongoDB user must have a unique certificate.
1717
18-
- A client x.509 certificate's subject, which contains the
19-
Distinguished Name (``DN``), must **differ** from that of a
20-
:ref:`x509-member-certificate`.
21-
22-
At least one of the Organization (``O``), Organizational Unit
23-
(``OU``), or Domain Component (``DC``) attributes in the client
24-
certificate must differ from those in the
25-
:setting:`net.tls.clusterFile` and
26-
:setting:`net.tls.certificateKeyFile` server certificates.
27-
28-
If the MongoDB deployment has
29-
:parameter:`tlsX509ClusterAuthDNOverride` set (available starting
30-
in MongoDB 4.2), the client x.509 certificate's subject must also
31-
differ from that value.
18+
- The ``subject`` of a client x.509 certificate, which contains the
19+
Distinguished Name (``DN``), must be **different** than the ``subject``\s
20+
of :ref:`member x.509 certificates <x509-member-certificate>`.
21+
22+
.. important::
23+
24+
If a client x.509 certificate's subject matches the ``O``, ``OU``, and
25+
``DC`` attributes of the :ref:`x509-member-certificate` (or
26+
:parameter:`tlsX509ClusterAuthDNOverride`, if set) exactly, the client
27+
connection is accepted, full permissions are granted, and a warning
28+
message appears in the log.
29+
30+
Only :ref:`cluster member x509 certificates <x509-member-certificate>`
31+
should use the same ``O``, ``OU``, and ``DC`` attribute combinations.
32+
33+
34+
.. versionadded:: 4.2
35+
36+
If the MongoDB deployment has :parameter:`tlsX509ClusterAuthDNOverride`
37+
set, the client x.509 certificate's subject must not match that value.
3238
3339
.. warning::
3440
@@ -88,11 +94,10 @@ content: |
8894
CN=host2,OU=Dept1,O=MongoDB
8995
9096
- Either the Common Name (``CN``) or one of the Subject Alternative
91-
Name (``SAN``) entries must match the hostname of the server, used
92-
by the other members of the cluster. Starting in MongoDB 4.2, when
93-
performing comparison of SAN, MongoDB supports comparison of DNS
94-
names or IP addresses. In previous versions, MongoDB only supports
95-
comparisons of DNS names.
97+
Name (``SAN``) entries must match the server hostname for other cluster
98+
members. Starting in MongoDB 4.2, when comparing ``SAN``\s, MongoDB can
99+
compare either DNS names or IP addresses. In previous versions, MongoDB
100+
only compares DNS names.
96101
97102
For example, the certificates for a cluster could have the following
98103
subjects:

0 commit comments

Comments
 (0)