ウォレットを使用したJDBC Thin接続(mTLS)

Oracle Walletの使用

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

1. 前提条件が満たされていることを確認します: 詳細は、「JDBC Thinドライバ接続のウォレット接続の前提条件」を参照してください。

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. 前提条件が満たされていることを確認します: 詳細は、「JDBC Thinドライバ接続のウォレット接続の前提条件」を参照してください。

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

最新の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. 前提条件が満たされていることを確認します: 詳細は、「JDBC Thinドライバ接続のウォレット接続の前提条件」を参照してください。

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. ウォレット・ロケーションの設定: ファイルjava.security内のプロバイダ・リストの最後に、通常は次のようなOraclePKIProviderを追加します(このファイルは、$JRE_HOME/jre/lib/security/java.securityにあるJREインストールの一部です)。

   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. 前提条件が満たされていることを確認します: 詳細は、「JDBC Thinドライバ接続のウォレット接続の前提条件」を参照してください。

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