[JAVA-3420] Java driver doc on setting CA and client certificates confusing Created: 30/Aug/19  Updated: 28/Oct/23  Resolved: 19/Jan/21

Status: Closed
Project: Java Driver
Component/s: Documentation
Affects Version/s: None
Fix Version/s: 4.2.0

Type: Improvement Priority: Major - P3
Reporter: Nic Cottrell Assignee: Valentin Kavalenka
Resolution: Fixed Votes: 1
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Case:

 Description   

I find the presentation of the JVM system properties section confusing.

I think it would be more discoverable and grokable if:

  1. the heading "JVM system properties" was changed to something like "Certificates" 
  2. there was an immediate sub-title "Certificate authority"
  3. there was another sub-title "Client certificates" above "A typical application will also ... the client presents an SSL certificate to the MongoDB server"
  4. we provide an example for the keyStore prepare, like 2. openssl pkcs12 -export -out mongodb.pkcs12 -in client.pem
  5. we link to the server docs about setting up client certificate validation 


 Comments   
Comment by Githook User [ 19/Jan/21 ]

Author:

{'name': 'Valentin Kovalenko', 'email': 'valentin.kovalenko@mongodb.com', 'username': 'stIncMale'}

Message: Improve TLS docs, add javaseref shortcode (#637)

JAVA-3420
Branch: master
https://github.com/mongodb/mongo-java-driver/commit/858d743e6b9f69173438e3f163dd46463b486401

Comment by Nic Cottrell [ 05/Jan/21 ]

jeff.yemin I've updated the PR after updating my fork: https://github.com/mongodb/mongo-java-driver/pull/622

Comment by Nic Cottrell [ 21/Jan/20 ]

jeff.yemin I created a PR: https://github.com/mongodb/mongo-java-driver/pull/534 

Comment by Nic Cottrell [ 04/Nov/19 ]

Note to self: include example of the JVM command line e.g. -Djavax.net.ssl.keyStore=c:\secure\mongodb.pkcs12

Generated at Thu Feb 08 08:59:34 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.