[CXX-1287] Document how to build mongoc and mongocxx for SSL support Created: 26/Mar/17  Updated: 07/Feb/24

Status: Backlog
Project: C++ Driver
Component/s: Documentation
Affects Version/s: None
Fix Version/s: None

Type: New Feature Priority: Major - P3
Reporter: J Rassi Assignee: Unassigned
Resolution: Unresolved Votes: 0
Labels: None
Remaining Estimate: Not Specified
Time Spent: Not Specified
Original Estimate: Not Specified

Epic Link: Reference Docs Improvements
Quarter: FY24Q3

 Description   

We should answer the following questions in our documentation.

In order to build an application that makes SSL connections to the server:

  • Do users have to explicitly request SSL support when building the C driver? (it depends on whether they have prereqs installed?)
  • Do users have to explicitly request SSL support when building the C++ driver? (no, defaults to on)
  • Do users have to specify "ssl=true" in their connection URI, or ssl_opts() in their client options? (yes)

The C driver documents some of the above in its "Advanced Connections" page: http://mongoc.org/libmongoc/1.6.1/advanced-connections.html#connecting-to-a-server-over-ssl

Where possible, we should also detect whether the user has skipped any of the above steps, and issue a readable diagnostic or error (e.g. when building an SSL C++ driver against a non-SSL C driver).


Generated at Wed Feb 07 22:02:04 UTC 2024 using Jira 9.7.1#970001-sha1:2222b88b221c4928ef0de3161136cc90c8356a66.