ウォレット(mTLS)を使用したPythonアプリケーションの接続
ウォレットを使用して、PythonアプリケーションをAutonomous Databaseインスタンスに接続できます。
python-oracledbドライバのデフォルトのシン・モードは、Oracle Databaseに直接接続します。ドライバは、追加機能のために、オプションでOracle Clientライブラリ「Thick mode」を使用できます。Oracle Clientライブラリは、Oracle Instant Clientから、完全なOracle Clientから、またはOracle Databaseインストールから使用できます。
次のステップに従って、ウォレット(mTLS)を使用してPythonアプリケーションをAutonomous Databaseインスタンスに接続します:
- Pythonおよびpython-oracledbドライバのインストール
- セキュリティ資格証明(Oracle Wallet)の取得およびネットワーク接続の有効化
- シン・モードでのみ接続する場合は、このステップを実行します: Wallet (mTLS)を使用したpython-oracledbシン・モードでのPythonアプリケーションの実行
- Thickモードで接続する場合は、このステップを実行します: Wallet (mTLS)を使用したpython-oracledb ThickモードでのPythonアプリケーションの実行
トピック
- セキュリティ資格証明(Oracle Wallet)の取得およびネットワーク接続の有効化
クライアント・セキュリティ資格証明を取得して、Autonomous Databaseインスタンスに接続します。 - Wallet (mTLS)を使用したpython-oracledbシン・モードでのPythonアプリケーションの実行
デフォルトでは、python-oracledbはシン・モードを使用してAutonomous Databaseインスタンスに直接接続します。 - Wallet (mTLS)を使用したpython-oracledb ThickモードでのPythonアプリケーションの実行
デフォルトでは、python-oracledbはOracle Databaseに直接接続されるThinモードで実行されます。python-oracledbの追加機能は、ドライバがThickモードで実行されている場合に使用できます。
Wallet (mTLS)を使用したpython-oracledbシン・モードでのPythonアプリケーションの実行
デフォルトでは、python-oracledbはシン・モードを使用してAutonomous Databaseインスタンスに直接接続します。
シン・モードでは、ウォレットzipの2つのファイルのみが必要です。
-
tnsnames.ora
: アプリケーション接続文字列に使用されるネット・サービス名をデータベース・サービスにマップします。 -
ewallet.pem
: シン・モードでSSL/TLS接続を有効にします。
シン・モードで接続するには:
ファイアウォールの背後にある場合は、接続記述子のHTTPS_PROXYを使用するか、接続属性を設定して、プロキシを介してTLS/SSL接続をトンネリングできます。正常な接続は、特定のプロキシ構成によって決まります。Oracleでは、パフォーマンスに影響する可能性があるため、本番環境でプロキシを使用することはお薦めしません。
シン・モードでは、https_proxy
およびhttp_proxy_port
パラメータを追加して、プロキシを指定できます。
たとえば、Linuxでは、次のように指定します。
connection=oracledb.connect(
config_dir="/opt/OracleCloud/MYDB",
user="admin",
password=password,
dsn="db2024_low",
wallet_location="/opt/OracleCloud/MYDB",
wallet_password=wallet_pw,
https_proxy='myproxy.example.com',
https_proxy_port=80)
たとえば、Windowsでは次のように指定します。
connection=oracledb.connect(
config_dir=r"C:\opt\OracleCloud\MYDB",
user="admin",
password=password,
dsn="db2024_low",
wallet_location=r"C:\opt\OracleCloud\MYDB",
wallet_password=wallet_pw,
https_proxy='myproxy.example.com',
https_proxy_port=80)
Wallet (mTLS)を使用したpython-oracledb ThickモードでのPythonアプリケーションの実行
太いモードでは、Pythonを実行する場所にOracle Clientライブラリがインストールされている必要があります。また、Pythonコードで
oracledb.init_oracle_client()
をコールする必要があります。
Thickモードでは、ウォレットzipファイルの次の3つのファイルが必要です。
-
tnsnames.ora
: アプリケーション接続文字列に使用されるネット・サービス名を含み、文字列をデータベース・サービスにマップします。 -
sqlnet.ora
: SQL*Netクライアント側の構成を指定します。 cwallet.sso
: 自動オープンSSOウォレットが含まれます。
厚いモードで接続するには:
ファイアウォールの背後にある場合は、接続記述子のHTTPS_PROXYを使用するか、接続属性を設定して、プロキシを介してTLS/SSL接続をトンネリングできます。正常な接続は、特定のプロキシ構成によって決まります。Oracleでは、パフォーマンスに影響する可能性があるため、本番環境でプロキシを使用することはお薦めしません。
太いモードでは、sqlnet.ora
ファイルを編集して行を追加することで、プロキシを指定できます。
SQLNET.USE_HTTPS_PROXY=on
さらに、tnsnames.ora
を編集し、使用する予定のサービス名の接続記述子アドレス・リストにHTTPS_PROXY
プロキシ名およびHTTPS_PROXY_PORT
ポートを追加します。
たとえば:
mydb_high=(description=
(address=(https_proxy=myproxy.example.com)
(https_proxy_port=80)
(protocol=tcps)(port=1522)(host=...)
Thickモードの詳細は、「python-oracledb Thickモードの有効化」を参照してください。