Uploaded image for project: 'Documentation'
  1. Documentation
  2. DOCS-11426

Docs for SERVER-32980: Add certificate selector for Apple for SecureTransport

XMLWordPrintableJSON

    • Type: Icon: Task Task
    • Resolution: Fixed
    • Priority: Icon: Major - P3 Major - P3
    • 3.7.2, 3.7.3
    • Affects Version/s: None
    • Component/s: manual
    • Labels:
      None

      Documentation Request Summary:

      This implements the user-facing piece of PM-305's certificate selector specification. Apple and Windows implementations still need to handle the values which will come in later commits.

      Engineering Ticket Description:

      The new option will be called a “Certificate Selector” for each option used to read a PEM file today. No new options will be used to read CA certs or CRL lists as these will be retrieved from the system certificate store by the native SSL library automatically. Both platforms will check OCSP for CRLs.

      Existing Option New Option Config Name
      sslPEMKeyFile sslCertificateSelector net.ssl.CertificateSelector
      sslClusterFile sslClusterCertificateSelector net.ssl.ClusterCertificateSelector
      kmipClientCertificateFile kmipClientCertificateSelector security.kmip.ClientCertificateSelector

      It is a startup error to specify a certificate selector and file for the same parameter.

      The format of the certificate selector is:

      <certificate property>=<value>

      The following certificate properties are supported:

      Property Value Description
      subject An ASCII string Matches Subject Name
      thumbprint Hex string Matches Thumbprint
      serial Hex string Matches Serial Number

      The property names are case-sensitive. For subject name, the match is exact, case-sensitive string match. Only one property may be specified in a search. In the case of two or more certificates matching the same search criteria, the certificate returned is undefined, and depends on the OS behavior.

      Scope of changes:

       

      The approach will be to add a reference to the Apple/Windows options everytime we reference configuring a .pem file. Possible implicated files are:

      https://docs.mongodb.com/manual/tutorial/configure-ssl/

      https://docs.mongodb.com/manual/tutorial/configure-ssl-clients/index.html

      https://docs.mongodb.com/manual/tutorial/upgrade-cluster-to-ssl/index.html

       

      Impact to other docs outside of this product:

      MVP:

      Resources:

            Assignee:
            sue.kerschbaumer@mongodb.com Susan Kerschbaumer (Inactive)
            Reporter:
            kay.kim@mongodb.com Kay Kim (Inactive)
            Votes:
            0 Vote for this issue
            Watchers:
            3 Start watching this issue

              Created:
              Updated:
              Resolved:
              5 years, 12 weeks ago