mTLSを使用したPythonアプリケーションの接続
適用対象: 
Exadata Cloud@Customerのみ
mTLSを使用して、PythonアプリケーションをAutonomous Databaseインスタンスに接続できます。
python-oracledbドライバのデフォルトのThinモードは、Oracle Databaseに直接接続されます。オプションで、いくつかの追加機能のためにOracle Clientライブラリ「Thick mode」を使用できます。Oracle Clientライブラリは、Oracle Instant Client、フルOracle Client、またはOracle Databaseインストールから取得できます。
mTLSを使用してAutonomous DatabaseインスタンスにPythonアプリケーションを接続するには、次のステップに従います:
- Pythonおよびpython-oracledbドライバのインストール
- セキュリティ資格証明(Oracle Wallet)の取得およびネットワーク接続の有効化
- シン・モードでのみ接続する場合は、このステップを実行します: python-oracledbシン・モード(mTLS)を使用したPythonアプリケーションの実行
- Thickモードで接続する場合、このステップを実行します: python-oracledb Thickモード(mTLS)を使用したPythonアプリケーションの実行
Pythonおよびpython-oracledbドライバのインストール
PythonアプリケーションからAutonomous Databaseに接続するには、Pythonおよびpython-oracledbドライバをインストールします。
python-oracledb Thinモード(mTLS)を使用したPythonアプリケーションの実行
デフォルトでは、python-oracledbはThinモードを使用してAutonomous Databaseインスタンスに直接接続します。
Thinモードでは、ウォレットzipの2つのファイルのみが必要です:
-
tnsnames.ora: アプリケーション接続文字列に使用されるネット・サービスをデータベース・サービスにマップします。 -
ewallet.pem: ThinモードでSSL/TLS接続を有効にします。
Thinモードで接続するには:
ファイアウォールの背後にある場合は、接続記述子でHTTPS_PROXYを使用するか、接続属性を設定することで、プロキシを介してTLS/SSL接続をトンネリングできます。成功した接続は、特定のプロキシ構成によって異なります。Oracleでは、パフォーマンスへの影響が考えられるため、本番環境でのプロキシの使用はお薦めしません。詳細は、『Oracle Database 19cデータベース・ネット・サービス・リファレンス』のHTTPS_PROXYまたは『Oracle Database 23aiデータベース・ネット・サービス・リファレンス』を参照してください。
Thinモードでは、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)python-oracledb Thick Mode (mTLS)を使用したPythonアプリケーションの実行
ノート:
Pythonを実行する場所にOracle Clientライブラリがインストールされている必要があります。また、Pythonコードでoracledb.init_oracle_client()をコールする必要があります。
Thickモードでは、ウォレットzipファイルの次の3つのファイルが必要です:
-
tnsnames.ora: アプリケーション接続文字列に使用されるネット・サービス名を含み、その文字列をデータベース・サービスにマップします。 -
sqlnet.ora: SQL*Netクライアント側の構成を指定します。 cwallet.sso: 自動オープンSSOウォレットが含まれます。
Thickモードで接続するには:
ファイアウォールの背後にある場合は、接続記述子でHTTPS_PROXYを使用するか、接続属性を設定することで、プロキシを介してTLS/SSL接続をトンネリングできます。成功した接続は、特定のプロキシ構成によって異なります。Oracleでは、パフォーマンスへの影響が考えられるため、本番環境でのプロキシの使用はお薦めしません。詳細は、『Oracle Database 19cデータベース・ネット・サービス・リファレンス』のHTTPS_PROXYまたは『Oracle Database 23aiデータベース・ネット・サービス・リファレンス』を参照してください。
Thickモードでは、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モードの有効化を参照してください。