Oracle Walletの使用

Javaおよび18.3 JDBC Thinドライバを使用してOracle WalletでAutonomous Databaseに接続するには、次を実行します:

1. Make sure that the prerequisites are met: See JDBC Thin Driver Connection Prerequisites Connections with Wallets (mTLS) for more information.

2. 接続の検証: Javaプログラム、サーブレットまたはIDEを使用して、データベースへの接続を検証できます。簡単なテストとして、DataSourceSample.javaまたはUCPSample.javaをJDBCコード・サンプルからダウンロードし、必要なTNS別名を持つように接続URLを更新し、tnsnames.oraおよびウォレット・ファイルのパスを指定してTNS_ADMINを渡します。また、サンプル・ソース・コードでは、データベース・ユーザー名とパスワードを更新します。たとえば、次のとおりです。

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

   ノート
   
   データベースでMicrosoft Active Directoryを使用している場合、サンプル・ソース・コードでは、Active Directoryユーザー名でユーザー名を更新し、Active Directoryユーザー・パスワードでパスワードを更新します。詳細は、Autonomous DatabaseでのMicrosoft Active Directoryの使用を参照してください。

3. ウォレットの場所の設定: プロパティ・ファイルojdbc.propertiesには、ウォレット関連の接続プロパティが事前にロードされています。

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

   ノート
   
   ファイルojdbc.propertiesは変更できません。TNS_ADMINの値によって、ウォレットの場所が決まります。

4. コンパイルして実行:サンプルをコンパイルして実行し、正常な接続を取得します。oraclepki.jar、osdt_core.jarおよびosdt_cert.jarがclasspathにあることを確認します。たとえば、次のとおりです。

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

Java KeyStoreの使用

Javaおよび18.3 JDBC Thinドライバを使用してJava KeyStore (JKS)でAutonomous Databaseに接続するには、次の手順を実行します:

1. Make sure that the prerequisites are met: See JDBC Thin Driver Connection Prerequisites Connections with Wallets (mTLS) for more information.

2. データベースの詳細の準備: Javaプログラム、サーブレットまたはIDEを使用して、データベースへの接続を確認できます。簡単なテストとして、DataSourceSample.javaまたはUCPSample.javaをJDBCコード・サンプルからダウンロードできます。このサンプルでは、次のように接続URLを使用します。接続DB_URLには、TNS別名(tnsnames.oraに存在するdbname_highなど)が含まれていることに注意してください。URLに示すように、TNS_ADMINプロパティを介してtnsnames.oraファイルのパスを指定できます。データベースに関連するデータベース・ユーザー名とパスワードを使用してください。

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

   Note
   
   If you are using Microsoft Active Directory with Autonomous Database, then make sure to change the sample source code to use the Active Directory username and the Active Directory user password.詳細は、Autonomous DatabaseでのMicrosoft Active Directoryの使用を参照してください。

3. JKS関連の接続プロパティの設定: JKS関連の接続プロパティをojdbc.propertiesファイルに追加します。keyStoreおよび信頼ストアのパスワードは、クライアント資格証明.zipファイルのダウンロード時に指定したパスワードです。

   Oracle WalletのかわりにSSL接続を使用するには、キーストア・ファイル、信頼ストア・ファイル、およびそれぞれのパスワードをojdbc.propertiesファイルで次のように指定します:

   
   # 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

   ノート
   
   ojdbc.propertiesのウォレット関連のプロパティはコメント化してください。たとえば、次のとおりです。

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

4. コンパイルして実行:サンプルをコンパイルして実行し、正常な接続を取得します。次に例を示します。

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

最新の18.3 JDBCドライバを使用できない場合は、12.2.0.2またはその他の古いJDBCドライバを使用してAutonomous Databaseに接続できます。12.2 以前のJDBCドライバは、ojdbc.propertiesファイルをサポートしていません。古いバージョンのJDBCドライバでは、接続を確立するには、ウォレットまたはJKS関連プロパティをシステム・プロパティまたは接続プロパティとして渡す必要があります。

Oracle Walletの使用

Javaおよび12.2以前のJDBCドライバを使用してOracle WalletでAutonomous Databaseに接続するには、次を実行します:

1. Make sure that the prerequisites are met: See JDBC Thin Driver Connection Prerequisites Connections with Wallets (mTLS) for more information.

2. 接続の検証: Javaプログラム、サーブレットまたはIDEを使用して、データベースへの接続を検証できます。簡単なテストとして、DataSourceSample.javaまたはUCPSample.javaをJDBCコード・サンプルからダウンロードし、必要なTNS別名を持つように接続URLを更新します。また、データベース・ユーザー名とパスワードを使用するようにサンプル・ソース・コードを更新します。次に例を示します。

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

   ノート
   
   Autonomous DatabaseでMicrosoft Active Directoryを使用している場合、Active Directoryユーザー名およびActive Directoryユーザー・パスワードを使用するようにサンプル・ソース・コードを更新してください。詳細は、Autonomous DatabaseでのMicrosoft Active Directoryの使用を参照してください。

3. Set the wallet location: Add the OraclePKIProvider at the end of the provider list in the file java.security (this file is part of your JRE install located at $JRE_HOME/jre/lib/security/java.security) which typically looks like:

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

4. コンパイルして実行:サンプルをコンパイルして実行し、正常な接続を取得します。oraclepki.jar、osdt_core.jarおよびosdt_cert.jarがclasspathにあることを確認します。また、接続プロパティを渡す必要があります。 tnsnames.oraおよびウォレット・ファイルが存在する場所でプロパティを更新します。

   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の使用

Javaおよび12.2以前のJDBC Thinドライバを使用してJava KeyStore (JKS)でAutonomous Databaseに接続するには、次の手順を実行します:

1. Make sure that the prerequisites are met: See JDBC Thin Driver Connection Prerequisites Connections with Wallets (mTLS) for more information.

2. 接続の検証: Javaプログラム、サーブレットまたはIDEを使用して、データベースへの接続を検証できます。簡単なテストとして、DataSourceSample.javaまたはUCPSample.javaをJDBCコード・サンプルからダウンロードし、必要なTNS別名を持つように接続URLを更新し、tnsnames.oraのパスを指定してTNS_ADMINを渡し、必要なTNS別名を持つように接続URLを更新できます。また、サンプル・ソース・コードでは、データベース・ユーザー名とパスワードを更新します。たとえば:

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

   ノート
   
   Autonomous DatabaseでMicrosoft Active Directoryを使用している場合、Active Directoryユーザー名およびActive Directoryユーザー・パスワードを使用するようにサンプル・ソース・コードを更新してください。詳細は、Autonomous DatabaseでのMicrosoft Active Directoryの使用を参照してください。

3. コンパイルして実行: サンプルをコンパイルして実行し、正常な接続を取得します。次のように接続プロパティを渡す必要があります。 tnsnames.oraおよびJKSファイルが存在する場所でプロパティを更新します。これらの接続プロパティをプログラムで渡す場合は、DataSourceForJKS.javaを参照してください。たとえば:

   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