Skip to content

Commit 51fda29

Browse files
committed
Update mTLS sections in documentation to reflect the latest ADB certificate changes with syntactical corrections
1 parent 4b4715b commit 51fda29

File tree

2 files changed

+16
-10
lines changed

2 files changed

+16
-10
lines changed

doc/src/release_notes.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -15,7 +15,7 @@ Thin Mode Changes
1515

1616
#) Fixed bug when a break occurs in the middle of processing a database
1717
response that spans multiple packets. This break could occur due to a
18-
server error, the session being killed or a call to `breakExecution()`.
18+
server error, the session being killed or a call to ``breakExecution()``.
1919

2020
#) Improve error message when an internal error handler fails and a connection
2121
is no longer usable.

doc/src/user_guide/connection_handling.rst

Lines changed: 15 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -2219,7 +2219,7 @@ The connect descriptor parameter ``TOKEN_AUTH`` must be set to
22192219
(CONNECT_DATA=(SERVICE_NAME=db_low.adb.oraclecloud.com))
22202220
(SECURITY=
22212221
(SSL_SERVER_DN_MATCH=ON)
2222-
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
2222+
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
22232223
(TOKEN_AUTH=OAUTH)
22242224
(TOKEN_LOCATION='/opt/oracle/token')
22252225
))
@@ -2443,7 +2443,7 @@ your :ref:`tnsnames.ora <tnsnames>` file might contain:
24432443
(CONNECT_DATA=(SERVICE_NAME=db_low.adb.oraclecloud.com))
24442444
(SECURITY=
24452445
(SSL_SERVER_DN_MATCH=ON)
2446-
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
2446+
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
24472447
(TOKEN_AUTH=OCI_TOKEN)
24482448
))
24492449
@@ -2461,7 +2461,7 @@ For example in a ``tnsnames.ora`` file:
24612461
(CONNECT_DATA=(SERVICE_NAME=db_low.adb.oraclecloud.com))
24622462
(SECURITY=
24632463
(SSL_SERVER_DN_MATCH=ON)
2464-
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, OU=Oracle BMCS US, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
2464+
(SSL_SERVER_CERT_DN="CN=efg.oraclecloud.com, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
24652465
(TOKEN_AUTH=OCI_TOKEN)
24662466
(TOKEN_LOCATION='/opt/oracle/token')
24672467
))
@@ -3169,8 +3169,8 @@ keep connections strings out of application code, see :ref:`tnsnames`.
31693169
31703170
.. _connectionadbmtls:
31713171
3172-
Mutal TLS connections to Oracle Cloud Autonomous Database
3173-
---------------------------------------------------------
3172+
Mutual TLS connections to Oracle Cloud Autonomous Database
3173+
----------------------------------------------------------
31743174
31753175
To enable connections from node-oracledb to Oracle Autonomous Database in
31763176
Oracle Cloud using mTLS, a wallet needs to be downloaded from the cloud
@@ -3384,15 +3384,15 @@ For example, if your ``tnsnames.ora`` file had an entry::
33843384
33853385
cjjson_high = (description=(retry_count=20)(retry_delay=3)
33863386
(address=(protocol=tcps)(port=1522)
3387-
(host=adb.ap-sydney-1.oraclecloud.com))
3387+
(host=efg.oraclecloud.com))
33883388
(connect_data=(service_name=abc_cjjson_high.adb.oraclecloud.com))
3389-
(security=(ssl_server_cert_dn="CN=adb.ap-sydney-1.oraclecloud.com,OU=Oracle ADB SYDNEY,O=Oracle Corporation,L=Redwood City,ST=California,C=US")))
3389+
(security=(ssl_server_cert_dn="CN=efg.oraclecloud.com, O=Oracle Corporation, L=Redwood City, ST=California, C=US")))
33903390
33913391
Then your applications can connect using the connection string:
33923392
33933393
.. code-block:: javascript
33943394
3395-
cs = "tcps://adb.ap-sydney-1.oraclecloud.com:1522/abc_cjjson_high.adb.oraclecloud.com?wallet_location=/Users/cjones/Cloud/CJJSON&retry_count=20&retry_delay=3"
3395+
cs = "tcps://efg.oraclecloud.com:1522/abc_cjjson_high.adb.oraclecloud.com?wallet_location=/Users/cjones/Cloud/CJJSON&retry_count=20&retry_delay=3"
33963396
connection = await oracledb.getConnection({
33973397
user : "hr",
33983398
password : mypw,
@@ -3468,7 +3468,13 @@ Database, both of these paths are typically the same directory where the
34683468
**In node-oracledb Thick mode**
34693469
34703470
To use multiple wallets in node-oracledb Thick mode, a TCPS connection string
3471-
containing the ``MY_WALLET_DIRECTORY`` option needs to be created:
3471+
containing the ``MY_WALLET_DIRECTORY`` option needs to be created::
3472+
3473+
ocidbdemo_high = (description=(retry_count=1)(retry_delay=3)
3474+
(address=(protocol=tcps)(port=1522)(host=efg.oraclecloud.com))
3475+
(connect_data=(service_name=abc_ocidbdemo_high.adb.oraclecloud.com))
3476+
(security=(ssl_server_cert_dn="CN=ijk.oraclecloud.com, O=Oracle Corporation, L=Redwood City, ST=California, C=US")
3477+
(my_wallet_directory="/home/user1/Wallet_OCIDBDemo")))
34723478
34733479
.. note::
34743480

0 commit comments

Comments
 (0)