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

Oracle Walletの使用

Javaおよび18.3 JDBC Thinドライバを使用してOracle WalletでAutonomous AI 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 AI 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 AI 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"

   ノート
   
   Microsoft Active DirectoryをAutonomous AI Databaseとともに使用している場合は、必ずActive Directoryユーザー名およびActive Directoryユーザー・パスワードを使用するようにサンプル・ソース・コードを変更してください。詳細は、Autonomous AI 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 AI Databaseに接続できます。12.2以前のJDBCドライバは、ojdbc.propertiesファイルをサポートしていません。古いバージョンのJDBCドライバでは、接続を確立するには、ウォレットまたはJKS関連プロパティをシステム・プロパティまたは接続プロパティとして渡す必要があります。

Oracle Walletの使用

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

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

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

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

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