Skip to content

Commit b947326

Browse files
committed
Mention setting WALLET_LOCATION for cwallet.sso
1 parent 8583496 commit b947326

File tree

1 file changed

+14
-1
lines changed

1 file changed

+14
-1
lines changed

doc/api.md

Lines changed: 14 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -7115,6 +7115,12 @@ Then set the environment variable [`TNS_ADMIN`][8] to that directory
71157115
name. For example, if the file `/etc/my-oracle-config/tnsnames.ora`
71167116
is being used, set `TNS_ADMIN` to `/etc/my-oracle-config`.
71177117

7118+
The wallet configuration file `cwallet.sso` can be located with, or separately
7119+
from, the `tnsnames.ora` and `sqlnet.ora` files. It should be securely stored.
7120+
The `sqlnet.ora` file's `WALLET_LOCATION` path should be set to the directory
7121+
containing `cwallet.sso`. For Oracle Autonomous Database use of wallets, see
7122+
[Connecting to Oracle Autonomous Database](#connectionadb).
7123+
71187124
#### <a name="oraaccess"></a> 14.1.3. Optional Oracle Client Configuration
71197125

71207126
If the Oracle Client Libraries used by node-oracledb are version 12,
@@ -8887,11 +8893,18 @@ For node-oracledb, only these files from the zip are needed:
88878893

88888894
- `tnsnames.ora` - Maps net service names used for application connection strings to your database services
88898895
- `sqlnet.ora` - Configures Oracle Network settings
8890-
- `cwallet.sso` - Enables SSL/TLS connections
8896+
- `cwallet.sso` - Enables SSL/TLS connections. Note the cloud wallet does not contain a database username or password.
88918897

88928898
The other files and the wallet password are not needed.
88938899

88948900
Place these files as shown in [Optional Oracle Net Configuration](#tnsadmin).
8901+
The `sqlnet.ora` file contains a `WALLET_LOCATION` path to the directory where
8902+
`cwallet.sso` will be read from. By default this path is `"?/network/admin"`.
8903+
This path maps to the `network/admin` subdirectory of Oracle Instant Client , or
8904+
to the `$ORACLE_HOME/network/admin` subdirectory (when node-oracledb is linked
8905+
with the client libraries from a full client or database installation). If
8906+
`cwallet.sso` is in a different location, then you will need to edit the path in
8907+
`sqlnet.ora` and set it to the directory containing `cwallet.sso`.
88958908

88968909
##### Run Your Application
88978910

0 commit comments

Comments
 (0)