Oracle Wallet verwenden

So verwenden Sie Java und den 18.3 JDBC Thin-Treiber für die Verbindung mit Autonomous Database mit Oracle Wallet:

1. Sicherstellen, dass die Voraussetzungen erfüllt sind: Weitere Informationen finden Sie unter Voraussetzungen für JDBC Thin-Treiberverbindungen mit Wallets (mTLS).

2. Verbindung prüfen: Sie können die Verbindung zur Datenbank entweder mit einem Java-Programm, einem Servlet oder mit IDEs prüfen. Ein einfacher Test ist es, DataSourceSample.java oder UCPSample.java aus JDBC-Codebeispielen herunterzuladen und die Verbindungs-URL mit dem erforderlichen TNS-Alias zu aktualisieren und TNS_ADMIN zu übergeben. Dabei werden der Pfad für tnsnames.ora und die Wallet-Dateien angegeben. Aktualisieren Sie außerdem im Beispielquellcode den Datenbanknamen und das Kennwort. Beispiele:

   DB_URL="jdbc:oracle:thin:@dbname_high?TNS_ADMIN=/Users/test/wallet_dbname"

   Hinweis
   
   Wenn Sie Microsoft Active Directory mit einer Datenbank verwenden, aktualisieren Sie im Beispielquellcode den Benutzernamen mit dem Active Directory-Benutzernamen und das Kennwort mit dem Active Directory-Benutzerpasswort. Weitere Informationen finden Sie unter Microsoft Active Directory mit Autonomous Database verwenden.

3. Wallet-Speicherort festlegen: Die Eigenschaftendatei ojdbc.properties wird vorab mit der walletbezogenen Verbindungseigenschaft geladen.

   oracle.net.wallet_location=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=${TNS_ADMIN})))

   Hinweis
   
   Sie ändern dabei nicht die Datei ojdbc.properties. Der Wert TNS_ADMIN bestimmt den Wallet-Verzeichnis.

4. Kompilieren und ausführen: Kompilieren Sie das Beispiel, und führen Sie es aus, um eine erfolgreiche Verbindung herzustellen. Stellen Sie sicher, dass oraclepki.jar, osdt_core.jar und osdt_cert.jar unter classpath vorhanden sind. Beispiele:

   java –classpath
         ./lib/ojdbc8.jar:./lib/ucp.jar:./lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar:. UCPSample

Java KeyStore verwenden

So verwenden Sie Java und den 18.3 JDBC Thin-Treiber für die Verbindung mit Autonomous Database mit Java KeyStore (JKS):

1. Sicherstellen, dass die Voraussetzungen erfüllt sind: Weitere Informationen finden Sie unter Voraussetzungen für JDBC Thin-Treiberverbindungen mit Wallets (mTLS).

2. Datenbankdetails vorbereiten: Sie können die Verbindung zur Datenbank entweder mit einem Java-Programm, einem Servlet oder mit IDEs prüfen. Ein einfacher Test ist das Herunterladen von DataSourceSample.java oder UCPSample.java aus JDBC-Codebeispielen. Verwenden Sie in diesem Beispiel die angezeigte Verbindungs-URL. Beachten Sie, dass die DB_URL-Verbindung den TNS-Alias enthält, z.B. dbname_high in tnsnames.ora. Sie können den Pfad für die Datei tnsnames.ora über die Eigenschaft TNS_ADMIN angeben, wie in der URL dargestellt. Stellen Sie sicher, dass Sie den Datenbanknamen und das Kennwort für Ihre Datenbank verwenden.

   DB_URL="jdbc:oracle:thin:@dbname_high?TNS_ADMIN=/Users/test/wallet_dbname"

   Hinweis
   
   Wenn Sie Microsoft Active Directory mit Autonomous Database verwenden, müssen Sie den Beispielquellencode so ändern, dass der Active Directory-Benutzername und das Active Directory-Benutzerkennwort verwendet werden. Weitere Informationen finden Sie unter Microsoft Active Directory mit Autonomous Database verwenden.

3. JKS-bezogene Verbindungseigenschaften festlegen: Fügen Sie die JKS-bezogenen Verbindungseigenschaften der Datei ojdbc.properties hinzu. Das keyStore- und das Truststore-Kennwort sind das Kennwort, das beim Herunterladen der .zip-Datei mit den Clientzugangsdaten angegeben wird.

   Um die SSL-Verbindung anstelle von Oracle Wallet zu verwenden, geben Sie die Keystore- und Truststore-Dateien und das entsprechende Kennwort in der Datei ojdbc.properties an:

   
   # Properties for using Java KeyStore (JKS)
   oracle.net.ssl_server_dn_match=true
   javax.net.ssl.trustStore==${TNS_ADMIN}/truststore.jks
   javax.net.ssl.trustStorePassword=password
   javax.net.ssl.keyStore==${TNS_ADMIN}/keystore.jks
   javax.net.ssl.keyStorePassword=password

   Hinweis
   
   Kommentieren Sie die walletbezogene Eigenschaft in ojdbc.properties. Beispiele:

   
   # Property for using Oracle Wallets
   # oracle.net.wallet_location=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=${TNS_ADMIN})))

4. Kompilieren und ausführen: Kompilieren Sie das Beispiel, und führen Sie es aus, um eine erfolgreiche Verbindung herzustellen. Beispiele:

   java –classpath ./lib/ojdbc8.jar:./lib/ucp.jar UCPSample

Wenn Sie die neuesten JDBC-Treiber nicht verwenden können, können Sie mit 12.2.0.2 oder anderen älteren JDBC-Treibern eine Verbindung zu Autonomous Database herstellen. Die JDBC-Treiber der Version 12.2 oder älter unterstützen die Datei ojdbc.properties nicht. Bei älteren JDBC-Treiberversionen müssen Sie Wallets oder JKS-bezogene Eigenschaften entweder als Systemeigenschaften oder als Verbindungseigenschaften übergeben, um eine Verbindung herzustellen.

Oracle Wallet verwenden

So verwenden Sie Java und JDBC-Treiber der Version 12.2 oder früher für die Verbindung mit Autonomous Database mit Oracle Wallet:

1. Sicherstellen, dass die Voraussetzungen erfüllt sind: Weitere Informationen finden Sie unter Voraussetzungen für JDBC Thin-Treiberverbindungen mit Wallets (mTLS).

2. Verbindung prüfen: Sie können die Verbindung zur Datenbank entweder mit einem Java-Programm, einem Servlet oder mit IDEs prüfen. Ein einfacher Test ist das Herunterladen von DataSourceSample.java oder UCPSample.java von JDBC-Codebeispielen und das Aktualisieren der Verbindungs-URL mit dem erforderlichen TNS-Alias. Außerdem aktualisieren Sie den Beispielquellcode so, dass der Datenbankbenutzername und das Kennwort verwendet werden. Beispiele:

   DB_URL="jdbc:oracle:thin:@dbname_high”

   Hinweis
   
   Wenn Sie Microsoft Active Directory mit Autonomous Database verwenden, aktualisieren Sie den Beispielquellcode so, dass der Active Directory-Benutzername und das Active Directory-Benutzerpasswort verwendet werden. Weitere Informationen finden Sie unter Microsoft Active Directory mit Autonomous Database verwenden.

3. Wallet-Speicherort festlegen: Fügen Sie OraclePKIProvider am Ende der Providerliste in der Datei java.security hinzu (diese Datei gehört zur JRE-Installation unter $JRE_HOME/jre/lib/security/java.security), die in der Regel wie folgt aussieht:

   security.provider.14=oracle.security.pki.OraclePKIProvider

4. Kompilieren und ausführen: Kompilieren Sie das Beispiel, und führen Sie es aus, um eine erfolgreiche Verbindung herzustellen. Stellen Sie sicher, dass oraclepki.jar, osdt_core.jar und osdt_cert.jar unter classpath enthalten sind. Außerdem müssen Sie die Verbindungseigenschaften übergeben. Aktualisieren Sie die Eigenschaften mit dem Speicherort, in dem sich tnsnames.ora und Wallet-Dateien befinden.

   java –classpath 
   ./lib/ojdbc8.jar:./lib/ucp.jar:./lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar:.
   -Doracle.net.tns_admin=/users/test/wallet_dbname  
   -Doracle.net.ssl_server_dn_match=true  
   -Doracle.net.ssl_version=1.2  (Not required for 12.2)
   -Doracle.net.wallet_location= “(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/users/test/wallet_dbname)))” 
   UCPSample

Java KeyStore verwenden

So verwenden Sie Java und JDBC Thin-Treiber der Version 12.2 oder früher für die Verbindung mit Autonomous Database mit Java KeyStore (JKS):

1. Sicherstellen, dass die Voraussetzungen erfüllt sind: Weitere Informationen finden Sie unter Voraussetzungen für JDBC Thin-Treiberverbindungen mit Wallets (mTLS).

2. Verbindung prüfen: Sie können die Verbindung zur Datenbank entweder mit einem Java-Programm, einem Servlet oder mit IDEs prüfen. Ein einfacher Test ist das Herunterladen von DataSourceSample.java oder UCPSample.java aus JDBC-Codebeispielen, das Aktualisieren der Verbindungs-URL mit dem erforderlichen TNS-Alias und das Übergeben von TNS_ADMIN, das Bereitstellen des Pfads für tnsnames.ora und das Aktualisieren der Verbindungs-URL mit dem erforderlichen TNS-Alias. Aktualisieren Sie außerdem im Beispielquellcode den Datenbanknamen und das Kennwort. Beispiele:

   DB_URL="jdbc:oracle:thin:@dbname_high”

   Hinweis
   
   Wenn Sie Microsoft Active Directory mit Autonomous Database verwenden, aktualisieren Sie den Beispielquellcode so, dass der Active Directory-Benutzername und das Active Directory-Benutzerpasswort verwendet werden. Weitere Informationen finden Sie unter Microsoft Active Directory mit Autonomous Database verwenden.

3. Kompilieren und ausführen: Kompilieren Sie das Beispiel, und führen Sie es aus, um eine erfolgreiche Verbindung herzustellen. Sie müssen die Verbindungseigenschaften wie dargestellt übergeben. Aktualisieren Sie die Eigenschaften mit dem Speicherort, in dem tnsnames.ora und JKS-Dateien gespeichert sind. Wenn Sie diese Verbindungseigenschaften programmatisch übergeben möchten, finden Sie entsprechende Informationen unter DataSourceForJKS.java. Beispiele:

   java 
   -Doracle.net.tns_admin=/users/test/wallet_dbname
   -Djavax.net.ssl.trustStore=truststore.jks
   -Djavax.net.ssl.trustStorePassword=**********
   -Djavax.net.ssl.keyStore=keystore.jks    
   -Djavax.net.ssl.keyStorePassword=************   
   -Doracle.net.ssl_server_dn_match=true    
   -Doracle.net.ssl_version=1.2 // Not required for 12.2