Skip to content

Commit 0bf7e12

Browse files
authored
Docs-14584 add 509 certificate warning (#268)
* Docs-14584 add 509 certificate warning * DOCS-14584 init * update include verbiage * names -> name * Addressing Jason Edits #1 * Glossary update * ** * *** * Change glossary link * Use term decorator for Subject Alternative Name * Remove extra line in glossary.txt * Address Sergey comments #1 * Added ref to mongod and mongos * correct 5.0 release notes placement * Updated starting in MongoDB 5.0 * update fact-5.0-x509 ref to fact-x509... * add blank line to security-x.509.txt * update starting in version
1 parent 4b18287 commit 0bf7e12

File tree

4 files changed

+28
-0
lines changed

4 files changed

+28
-0
lines changed

source/core/security-x.509.txt

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -102,6 +102,11 @@ You can also make the TLS/SSL connection first, and then use
102102
For examples of both cases, see the :ref:`authenticate-with-x509-cert`
103103
section in :doc:`/tutorial/configure-x509-client-authentication`
104104

105+
TLS Connection X509 Certificate Startup Warning
106+
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
107+
108+
.. include:: /includes/fact-x509-certificate-client-warning.rst
109+
105110
Member x.509 Certificates
106111
--------------------------
107112

Lines changed: 15 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,15 @@
1+
Starting in MongoDB 4.4.7, :binary:`mongod` and :binary:`mongos` now
2+
issue a startup warning when their certificates do not include a
3+
:term:`Subject Alternative Name` attribute.
4+
5+
The following platforms do not support common name validation:
6+
7+
- iOS 13 and higher
8+
- MacOS 10.15 and higher
9+
- Go 1.15 and higher
10+
11+
Clients using these platforms will not
12+
:ref:`authenticate <x509-client-authentication>` to
13+
MongoDB servers which use X.509 certificate whose hostnames are
14+
:ref:`specified by CommonName attributes
15+
<KMIP-subject-alternative-name-CN>`.

source/reference/glossary.txt

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -936,6 +936,12 @@ Glossary
936936
always reflect the latest changes to the system. In a database
937937
system, this means that any system that can provide data must
938938
reflect the latest writes at all times.
939+
940+
Subject Alternative Name
941+
Subject Alternative Name (SAN) is an extension of the X.509
942+
certificate which allows an array of values such as IP addresses
943+
and domain names that specify which resources a single security
944+
certificate may secure.
939945

940946
sync
941947
The :term:`replica set` operation where members replicate data

source/reference/program/mongod.txt

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -3278,6 +3278,8 @@ Encryption Key Management Options
32783278
which it can successfully establish a connection. KMIP server
32793279
selection occurs only at startup.
32803280

3281+
.. _KMIP-subject-alternative-name-CN:
3282+
32813283
When connecting to a KMIP server, the :binary:`~bin.mongod`
32823284
verifies that the specified :option:`--kmipServerName` matches the
32833285
Subject Alternative Name ``SAN`` (or, if ``SAN`` is not present, the

0 commit comments

Comments
 (0)