Oracle Walletの使用

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

1. 前提条件が満たされていることの確認: 詳細は、ウォレット(mTLS)を使用した接続のための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. 前提条件が満たされていることの確認: 詳細は、ウォレット(mTLS)を使用した接続のための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"

   ノート
   
   Microsoft Active DirectoryをAutonomous Databaseで使用している場合は、Active Directoryユーザー名およびActive Directoryユーザー・パスワードを使用するようにサンプル・ソース・コードを変更してください。詳細は、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. 前提条件が満たされていることの確認: 詳細は、ウォレット(mTLS)を使用した接続のためのJDBC Thinドライバ接続の前提条件を参照してください。

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

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

   ノート
   
   Microsoft Active DirectoryをAutonomous Databaseで使用している場合は、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. 前提条件が満たされていることの確認: 詳細は、ウォレット(mTLS)を使用した接続のための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”

   ノート
   
   Microsoft Active DirectoryをAutonomous Databaseで使用している場合は、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