GeezerVison is showing github.com — Allow `/@TNS` connections using Oracle Wallet (Secure External Password Store) by jgebal · Pull Request #230 · utPLSQL/utPLSQL-cli
Conversation
jgebal
commented
Sep 27, 2026
•
edited
Loading
Uh oh!
There was an error while loading. Please reload this page.
Closes #225. Partly addresses #172: the password no longer has to appear on the command line.
Summary
utplsql now accepts a connect string with no user or password. The JDBC driver then reads the credentials from an Oracle Wallet, the same way sqlplus /@MYDB and SQLcl do:
utplsql run /@MYDATABASE
utplsql run "/@MYDATABASE?TNS_ADMIN=/path/to/network/admin"
Details
TNS_ADMIN handling (DataSourceProvider)
- The JDBC driver resolves
tnsnames.ora and ojdbc.properties (where the wallet location goes) from the TNS_ADMIN environment variable on its own.
- The CLI now sets
oracle.net.tns_admin to ORACLE_HOME/network/admin only when neither -Doracle.net.tns_admin nor TNS_ADMIN is set. Previously it set the property whenever ORACLE_HOME was set, and because the property takes precedence in the driver, that silently overrode TNS_ADMIN.
- An explicit
-Doracle.net.tns_admin still overrides everything.
Behaviour change
If both TNS_ADMIN and ORACLE_HOME are set and point to different directories, TNS_ADMIN now wins, because the CLI no longer overrides it with the ORACLE_HOME path. This matches how Oracle client tools resolve it. Connect strings that worked before are parsed the same way.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
…d automatically by jdbc driver. So `cli` will only use the ORACLE_HOME resolution when TNS_ADMIN is not defined.
Removed `oraclepki` as pom dependency. It is now delivered together with jdbc as part of java-api 3.2.5.
Sorry, something went wrong.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Uh oh!
There was an error while loading. Please reload this page.
Assignees
No one assigned
Milestone
No milestone
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.