※ 本記事は、Adrian Padilla Duarteによる”WebLogic Server and Oracle AI Database on OCI“を翻訳したものです。
2026年11月17日
はじめに
この記事では、Oracle Base Database Serviceを介してOCI上のOracle AI Databaseに接続する際に、OCI IAMデータベース・トークンを使用するようにWebLogic Server JDBCデータ・ソースを構成する方法を示します。データ・ソースにデータベースのユーザー名またはパスワードがありません。OCI IAMは短期間のデータベース・トークンを発行し、Oracle JDBC Thinはトークンにペア化された秘密キーで署名し、データベースはIAMアイデンティティをグローバル・データベース・ユーザーにマップします。
この構成は、WebLogic Server 14.1.2クラスタ、Oracle JDBC Thin 23.26.0.0.0およびOracle AI Database 26ai Enterprise Edition High Performance on Base Database Service バージョン 23.26.3.0.0で検証されました。互換性のあるOracle JDBC Thinドライバを使用するサポート対象のWebLogic Serverリリースにも同じアプローチが適用されます。
IAMデータベース・トークンは1時間後に期限切れになります。したがって、各管理対象サーバー・ホストには、有効期限前に実行される自動リフレッシュ・ジョブが必要です。
Autonomous Databaseとは異なり、Base Database Serviceでは、データベース側のIAM統合、TCPSサーバー・ウォレットおよびOCI IAMへのネットワーク・アクセスを構成する必要があります。また、JDBC Thinクライアント構成も必要です。
このシリーズ
これは、パスワードレスJDBC with OCI IAM Tokensシリーズのパート2です:
- WebLogic ServerおよびAutonomous Database 26ai (パート1)
- WebLogic ServerおよびOracle AI Database on OCI (この記事)
- WebLogic JDBCデータ・ソースのOCI IAMトークン認証の運用 (パート3)
パート1では、Autonomous Databaseフローについて説明します。この記事では、Base Database Serviceについて説明します。パート3では、共有運用プラクティス(トークンの更新、プールの動作、監視、トラブルシューティング)について説明します。
この記事の設定内容
- OCI IAMは、グループにデータベース接続の使用を認可します。
- Base Database CDBおよびターゲットPDBでOCI IAMを有効にします。
- PDBはIAMグループをグローバル・アプリケーション・スキーマにマップします。
- TCPSおよび必要なBase Database TLSウォレットが構成されています。
- OCI CLIは、各管理対象サーバー・ホスト上のWebLogicオペレーティング・システム・アカウントに、データベース・トークンと対応する秘密キーを作成します。
- ホストローカルのcronジョブが30分ごとにトークンを更新します。
- トークン対応のTNS別名およびクラスタを対象とする汎用データ・ソースは、データベース・パスワードを使用しません。
- 単純なアプリケーションは、クラスタ・データ・ソースを介して行の書込みおよび読取りを行います。
山カッコ内の値を環境の値に置き換えます。
前提条件
次のものが必要です:
- この記事のファイルベースのTOKEN_AUTH=OCI_TOKENフローには、Oracle JDBC Thin 19.16以降が必要です。WebLogic Server 12.2.1.4、14.1.1、14.1.2、および15.1.1には、そのWebLogic Serverリリースに適用可能な最新のOracle JDBC for Fusion Middleware JDBC 23.26.x/19.x Bundle Patchが適用されている場合、サポート対象のOracle JDBC Thinバージョンが含まれます。ご使用の環境にインストールされているドライバの正確なバージョンを確認し、19.16より古い場合は、対応する最新のBundle Patchを適用してください。WebLogic Serverリリース用のパッチを特定するには、(KA1182) Oracle Fusion Middlewareのクリティカル・パッチ・アップデート (CPU)パッチ・アドバイザを参照してください。このパッチは、WebLogic ServerにバンドルされているJDBCドライバをアップグレードされたドライバ・バージョンに更新します。
- Base Database ServiceデータベースおよびターゲットPDB。
- TCPSリスナー、およびクライアントにDNが認識されているサーバー証明書。
- APIキー、IAMグループのメンバーシップ、および
database-connectionsへのアクセス権を付与するポリシーを持つOCI IAMユーザー。 - WebLogicを実行する同じオペレーティング・システム・アカウントの下にOCI CLIがインストールされていること。この記事では、
oracleアカウントを使用します。 - 各管理対象サーバー・ホストにroot管理のcronファイルをインストールする権限。
- データベース・サブネットからOracle Services Networkへのサービス・ゲートウェイ・ルートおよびHTTPSエグレス。データベースはこのパスを使用してOCI IAMと通信します。
IAMトークン・アクセスにはTCPSが必要です。トークン接続にネイティブ・ネットワーク暗号化をTCPSとともに使用しないでください。TLSのみを使用してください。「Base Database ServiceでのIdentity and Access Management認証の使用」を参照してください。
1. Base Database Serviceの準備
ネットワークおよびTLSの前提条件の構成
IAMを有効にする前に、Oracle Services Networkへのサービス・ゲートウェイ・ルートおよびステートフルTCP 443エグレス・ルールを使用して、データベース・サブネットを構成します。データベース・リスナーでTCPSを構成し、発行証明書またはサーバー証明書を含むクライアント・トラスト・ウォレットを使用します。
Base Database Serviceの場合、サーバーTLSウォレットは、次のレイアウトを使用してデータベースWALLET_ROOTの下で使用可能である必要があります:
<wallet_root>/<pdb_guid>/tls
データベース管理者として設定を確認します:
SHOW PARAMETER wallet_root
SHOW PDBS
「Base Database ServiceでIdentity and Access Management認証を使用」を、Base Database固有の前提条件ガイドとして使用します。証明書およびウォレットの作成に関する選択肢については、「Oracle Database Transport Layer Security暗号化の構成」を参照してください。
正確な証明書コマンドは、認証局、および一方向TLSとmTLSのどちらを使用するかによって異なります。この記事で使用される一方向TLS構成の場合、サーバー側のチェックリストは次のとおりです:
- データベース・サーバー証明書および必要な証明書チェーンを取得または作成します。
- サーバーTLSウォレットを作成し、サーバー証明書、その秘密鍵、および必要な信頼できるCA証明書を追加します。
- サーバーTLSウォレットを
<wallet_root>/<pdb_guid>/tlsに格納し、データベースおよびリスナー・プロセスが読み取れる所有権と権限を設定します。 - TCPSリスナーを構成または確認し、そのポートおよびサーバー証明書DNを記録します。
- 必要に応じて関連するデータベース/リスナー・サービスを再起動または再ロードし、その後、PDBサービスがTCPSリスナーに登録されていることを確認します。
- WebLogicホストの発行元CA証明書またはサーバー証明書をエクスポートします。各管理対象サーバー・ホスト上の別個の*client trust wallet*にインポートします。
ダウンロードしたAutonomous Databaseウォレットをベース・データベース・サービスのサーバー・ウォレットとして扱わないでください。クライアント接続マテリアルです。WebLogicクライアントは、一方向TLSのベース・データベース・サーバー証明書のみを信頼する必要があります。mTLSはオプションであり、OCI IAMトークン認証には必要ありません。
CDBおよびターゲットPDBでのOCI IAMの有効化
ALTER SYSTEM SET IDENTITY_PROVIDER_TYPE=OCI_IAM SCOPE=BOTH;
次に、ターゲットPDBで有効にします:
ALTER SESSION SET CONTAINER=<pdb_name>;
ALTER SYSTEM SET IDENTITY_PROVIDER_TYPE=OCI_IAM SCOPE=BOTH;
データベースで以前に別の外部アイデンティティ・プロバイダを使用していた場合は、OCI IAMを有効にする前に古い構成値をリセットします:
ALTER SYSTEM RESET IDENTITY_PROVIDER_CONFIG SCOPE=BOTH;
両方のコンテナで検証します:
SELECT name, value
FROM v$parameter
WHERE name = 'identity_provider_type';
結果はOCI_IAMである必要があります。
PDBスキーマへのIAMグループのマップ
ターゲットPDBに共有グローバル・データベース・ユーザーを作成します。IAMグループの各メンバーは、このアプリケーション・スキーマにマップされます:
ALTER SESSION SET CONTAINER=<pdb_name>;
CREATE USER <hello_app_schema>
IDENTIFIED GLOBALLY AS 'IAM_GROUP_NAME=<iam_group_name>';
GRANT CREATE SESSION TO <hello_app_schema>;
GRANT CREATE TABLE TO <hello_app_schema>;
ALTER USER <hello_app_schema> QUOTA UNLIMITED ON USERS;
小規模なアプリケーション・テストの場合は、そのスキーマが所有する表を作成します:
CREATE TABLE <hello_app_schema>.hello_messages (
id NUMBER GENERATED BY DEFAULT AS IDENTITY PRIMARY KEY,
message VARCHAR2(4000) NOT NULL,
created_at TIMESTAMP DEFAULT SYSTIMESTAMP NOT NULL,
created_by VARCHAR2(128) DEFAULT USER NOT NULL
);
2. IAMの構成およびデータベース・トークンの生成
PDBスキーマにマップされたグループのIAMポリシーを作成します。この例では、コンパートメントへのアクセスを制限します:
Allow group <iam_group_name> to use database-connections in compartment <compartment_name>
target.database.id条件を使用して、ポリシーを1つのデータベース・リソースにさらに制限できます。IAMユーザーは、このグループのメンバーである必要があります。
WebLogicオペレーティング・システム・アカウントでOCI CLIを構成し、IAMユーザーのAPIキーを使用するプロファイルを作成します:
[<oci_profile>]
user=<iam_user_ocid>
fingerprint=<api_key_fingerprint>
key_file=/home/oracle/.oci/<api_key_private_file>
tenancy=<tenancy_ocid>
region=<region>
データベース・トークンをoracleとして生成します:
sudo -u oracle /home/oracle/bin/oci iam db-token get --profile <oci_profile>
OCI CLIは、デフォルトでトークンと所有証明の秘密キーを書き込みます:
/home/oracle/.oci/db-token/token
/home/oracle/.oci/db-token/oci_db_key.pem
WebLogicオペレーティング・システム・アカウントへのアクセスを制限します:
sudo chown -R oracle:oracle /home/oracle/.oci
sudo chmod 700 /home/oracle/.oci /home/oracle/.oci/db-token
sudo chmod 600 /home/oracle/.oci/config
sudo chmod 600 /home/oracle/.oci/<api_key_private_file>
sudo chmod 600 /home/oracle/.oci/db-token/token
sudo chmod 600 /home/oracle/.oci/db-token/oci_db_key.pem
トークンとキーにより、IAMプリンシパルのデータベース・アクセスが許可されます。デプロイメント・アーカイブ、ソース・リポジトリ、診断またはサポート・バンドルには含めないでください。
3. トークンの自動リフレッシュ
データベース・トークンは1時間後に期限切れになります。このスクリプトは、すべての管理対象サーバー・ホストで/home/oracle/bin/refresh-base-db-tokenとして作成します:
#!/usr/bin/env bash
set -euo pipefail
export PATH=/home/oracle/bin:/usr/bin:/bin
exec /home/oracle/bin/oci iam db-token get --profile <oci_profile>
WebLogicオペレーティング・システム・アカウントで実行可能にします:
sudo chown oracle:oracle /home/oracle/bin/refresh-base-db-token
sudo chmod 700 /home/oracle/bin/refresh-base-db-token
強化されたイメージでは、oracleはcrontabを使用できない場合があります。かわりに、/etc/cron.d/base-db-token-refreshという名前のルート管理ファイルを使用します:
*/30 * * * * oracle /usr/bin/flock -n /home/oracle/.oci/db-token/.refresh.lock /home/oracle/bin/refresh-base-db-token >> /home/oracle/.oci/db-token/refresh.log 2>&1
/etc/cron.dに適した権限でファイルをインストールし、OCI CLI診断を含めることができるため、ログを保護します:
sudo chown root:root /etc/cron.d/base-db-token-refresh
sudo chmod 644 /etc/cron.d/base-db-token-refresh
sudo touch /home/oracle/.oci/db-token/refresh.log
sudo chown oracle:oracle /home/oracle/.oci/db-token/refresh.log
sudo chmod 600 /home/oracle/.oci/db-token/refresh.log
ジョブは1時間に2回実行され、トークンの存続期間内で適切に実行されます。flockはリフレッシュの重複を防ぎます。同じオペレーティング・システム・コンテキストで確認します:
sudo -u oracle /bin/bash -lc \
'/usr/bin/flock -n /home/oracle/.oci/db-token/.refresh.lock \
/home/oracle/bin/refresh-base-db-token \
>> /home/oracle/.oci/db-token/refresh.log 2>&1'
sudo -u oracle tail -n 50 /home/oracle/.oci/db-token/refresh.log
4. JDBC Thin TNS別名の構成
すべての管理対象サーバー・ホストに、保護されたクライアント構成ディレクトリを作成します。WebLogicオペレーティング・システム・ユーザーには、TNSファイルおよびトラスト・ウォレットへの読取りアクセス権が必要です:
sudo -u oracle install -d -m 700 \
/home/oracle/wls-base-db/network \
/home/oracle/wls-base-db/trust
自動ログイン信頼ウォレットを作成し、ベース・データベースのTCPSリスナーが使用する証明書チェーンを追加します。正確な証明書ソースは、PKIおよびベース・データベースのTLS構成によって異なります:
<middleware_home>/bin/orapki wallet create \
-wallet /home/oracle/wls-base-db/trust -auto_login_only
<middleware_home>/bin/orapki wallet add \
-wallet /home/oracle/wls-base-db/trust \
-trusted_cert -cert <database_ca_or_server_certificate.pem> \
-auto_login_only
tnsnames.oraを作成します。JDBC ThinのSECURITYセクションには、TOKEN_AUTHとTOKEN_LOCATIONの両方が含まれている必要があります。引用符なしのディレクトリ・パスを使用します。このファイルでは、引用符はJDBC Thinトークン・ローダーのリテラル・パス文字になります。
<base_db_pdb_iam_alias> =
(DESCRIPTION =
(ADDRESS = (PROTOCOL = TCPS)(HOST = <db_private_host_or_ip>)(PORT = 2484))
(CONNECT_DATA = (SERVICE_NAME = <pdb_service_name>))
(SECURITY =
(WALLET_LOCATION = file:/home/oracle/wls-base-db/trust/cwallet.sso)
(SSL_SERVER_DN_MATCH = YES)
(SSL_SERVER_CERT_DN = "CN=<database_certificate_common_name>")
(TOKEN_AUTH = OCI_TOKEN)
(TOKEN_LOCATION = /home/oracle/.oci/db-token))
)
この配置は重要です。トークン設定がSECURITY以外の場合、JDBC Thinはトークンおよび秘密キーをロードせずにトークン・モードに入ることができます。結果として得られるサーバー側の症状は、空のIDを持つORA-01017またはNULLに対するベリファイア参照です。
5. クラスタ・ターゲット・データ・ソースの構成
トークン対応のTNS別名を解決する汎用データ・ソースを作成します。データベースのユーザー名またはパスワードを設定しないでください。データベース・アイデンティティは、すべてOCI IAMトークンから取得されます。
from java.lang import String
from jarray import array
from weblogic.management.configuration import TargetMBean
import os
admin_url = 't3s://<admin_host>:<admin_port>'
cluster_name = '<cluster_name>'
data_source_name = 'HelloBaseDbDataSource'
connect(os.environ['WLS_USER'], os.environ['WLS_PWD'], admin_url)
edit()
startEdit()
if getMBean('/JDBCSystemResources/' + data_source_name) is None:
jdbc = cmo.createJDBCSystemResource(data_source_name)
resource = jdbc.getJDBCResource()
resource.setName(data_source_name)
driver = resource.getJDBCDriverParams()
driver.setDriverName('oracle.jdbc.OracleDriver')
driver.setUrl('jdbc:oracle:thin:@<base_db_pdb_iam_alias>')
driver.getProperties().createProperty('oracle.net.tns_admin').setValue(
'/home/oracle/wls-base-db/network')
resource.getJDBCDataSourceParams().setJNDINames(
array(['jdbc/HelloBaseDbDataSource'], String))
jdbc.setTargets(array([getMBean('/Clusters/' + cluster_name)], TargetMBean))
save()
activate(block='true')
disconnect()
exit()
環境を介して提供される管理者資格証明を使用してWLSTを実行します:
export WLS_USER=<weblogic_administrator>
export WLS_PWD=<weblogic_administrator_password>
<middleware_home>/oracle_common/common/bin/wlst.sh configure_base_db_datasource.py
クラスタの場合、すべての管理対象サーバー・ホストでOCI CLI、トークン・リフレッシュ、トラスト・ウォレットおよびTNS構成を繰り返します。クラスタをターゲットとするデータ・ソースは、任意のクラスタ・メンバーに物理JDBC接続を作成できます。
6. アプリケーションからのデータ・ソースの使用
アプリケーションには、IAMまたはトークン・コードは必要ありません。通常のJNDIルックアップを実行します:
DataSource dataSource = (DataSource) new InitialContext()
.lookup("java:comp/env/jdbc/HelloAppDataSource");
try (Connection connection = dataSource.getConnection()) {
// Use the connection normally.
}
WEB-INF/weblogic.xmlで、アプリケーション・リソース参照をパスワードなしのグローバルJNDI名にマップします:
<resource-description>
<res-ref-name>jdbc/HelloAppDataSource</res-ref-name>
<jndi-name>jdbc/HelloBaseDbDataSource</jndi-name>
</resource-description>
これにより、移植可能なアプリケーション・コードが保持され、別のデプロイメントでベース・データベースのトークン・データ・ソースを使用できるようになります。
7. エンドツーエンド・フローの確認
まず、各管理対象サーバー・ホストに新しいトークンを作成します:
sudo -u oracle /home/oracle/bin/oci iam db-token get --profile <oci_profile>
アプリケーションをクラスタにデプロイし、管理対象サーバーまたはロード・バランサを介してメッセージを書き込みます:
curl -k -X POST \
--data-urlencode 'message=WebLogic Base DB passwordless OCI IAM token POC' \
https://<managed_server_or_load_balancer>/hello-base-db/hello-db
curl -k https://<managed_server_or_load_balancer>/hello-base-db/hello-db
このテストでは、グローバル・データベース・スキーマを持つストアド行が返されます:
1 | WebLogic Base DB passwordless OCI IAM token POC | <timestamp> | HELLO_APP
トークン認証済データベース接続からの認証IDを確認します:
SELECT
USER,
SYS_CONTEXT('USERENV', 'AUTHENTICATED_IDENTITY') AS authenticated_identity,
SYS_CONTEXT('USERENV', 'AUTHENTICATION_METHOD') AS authentication_method
FROM dual;
この共有グローバル・ユーザー・マッピングの値は次のとおりです:
USER HELLO_APP
AUTHENTICATED_IDENTITY <iam_user_name>
AUTHENTICATION_METHOD TOKEN_GLOBAL
トラブルシューティング
ORA-01017またはNULLのIAM参照 (ORA-01017 or an IAM lookup for NULL)
JDBC Thinが実際にトークンとペアの秘密キーをロードしていることを確認します。次のすべてを確認します:
TOKEN_AUTH=OCI_TOKENおよびTOKEN_LOCATIONは、TNSSECURITYセクション内にあります。TOKEN_LOCATIONは、引用符で囲まれていないディレクトリ・パスです。- ディレクトリには
tokenおよびoci_db_key.pemが含まれています。 - 両方のファイルはWebLogicオペレーティング・システム・アカウントで読取り可能です。
oracle.net.tns_adminは、この正確なtnsnames.oraファイルを含むディレクトリを指します。
ORA-18718: トークン構成が無効です(ORA-18718: token configuration is invalid)
これは多くの場合、トークンの場所が、両方の必要なファイルを含む読み取り可能なディレクトリに解決されないことを意味します。引用符で囲まれたTNS値により、JDBC Thinは"/home/oracle/.oci/db-token"/tokenなどのリテラル・パスを検索できます。引用符を削除し、トークン・ディレクトリ権限をWebLogic OSユーザーに制限したままにします。
ORA-12514: リスナー・メンテナンス後 (ORA-12514 after listener maintenance)
PDBサービスがリスナーに登録されていません。サービスを確認し、必要に応じて動的登録を強制します:
ALTER SYSTEM REGISTER;
トークンは1時間後に期限切れになります
リフレッシュ・ジョブがインストールされ、すべての管理対象サーバー・ホストで実行されていることを確認します。有効期限が切れた後に行われた新しい物理JDBC接続は失敗します。既存のプール済接続は、WebLogicが物理接続を作成または置換する必要があるまで使用可能です。
sudo cat /etc/cron.d/base-db-token-refresh
sudo systemctl status crond
sudo -u oracle tail -n 50 /home/oracle/.oci/db-token/refresh.log
概要
WebLogic Serverは、データベース・パスワードをデータ・ソースに格納せずに、Base Database Serviceを介してOCI上のOracle AI Databaseに接続できます。重要な部分は、Base Database IAMおよびTCPSの前提条件、すべての管理対象サーバー・ホスト上の保護されたOCIトークンおよび秘密キー、およびTOKEN_AUTHおよびTOKEN_LOCATIONをSECURITY内に配置するJDBC Thin TNS記述子です。構成後、アプリケーションは通常のWebLogicデータ・ソースを使用し、データベースはIAM認証済セッションをTOKEN_GLOBALとして記録します。アプリケーションにサービスを提供できるすべてのホストでリフレッシュ・ジョブを使用して、トークンを最新の状態に保ちます。
