ウォレット(mTLS)を使用したPythonアプリケーションの接続

クライアント・セキュリティ資格証明を取得して、Autonomous Databaseインスタンスに接続します。

1. Autonomous Databaseインスタンスからウォレット・ファイルをダウンロードして、Autonomous Databaseインスタンスへのアクセスに必要なクライアント・セキュリティ資格証明およびネットワーク構成設定を含むzipファイルを取得します。

   クライアント・セキュリティ資格証明(wallet.zipファイル)を取得します。

   • ADMINユーザー: Oracle Cloud Infrastructure Consoleで、「データベース接続」をクリックします。「クライアント資格証明(ウォレット)のダウンロード」を参照してください。

   • 他のユーザー(管理者以外): Autonomous Databaseインスタンスの管理者からOracle Walletを取得します。

   ノート
   
   権限のないデータベースへのアクセスを防ぐために、wallet.zipファイルとそのコンテンツを保護します。
2. クライアント資格証明ファイル(wallet.zip)を解凍します。

デフォルトでは、python-oracledbはシン・モードを使用してAutonomous Databaseインスタンスに直接接続します。

1. tnsnames.oraおよびewallet.pemファイルをシステム上の場所に移動します。
   • Linux
   • Windows

   • たとえば、Linuxでは次のようにします。

     /opt/OracleCloud/MYDB

   • たとえば、Windowsの場合:

     C:\opt\OracleCloud\MYDB

2. Pythonアプリケーションで、次の接続パラメータを設定してAutonomous Databaseインスタンスに接続します:
   • config_dir: tnsnames.oraを含むディレクトリを指定します。
   • dsn: tnsnames.oraファイルから目的のネットワーク別名を指定するために使用します。
   • password: データベース・ユーザー・パスワードを指定します。
   • user: データベース・ユーザーを指定します。
   • wallet_location: PEMファイル(ewallet.pem)を含むディレクトリを指定します。
   • wallet_password: PEMファイル(ewallet.pem)のパスワードを指定します。このパスワードは、wallet.zipファイルのダウンロード時に設定します。
   • Linux
   • Windows

   • たとえば、Linuxでは、db2024_lowネットワーク・サービス名でoracledb.connectを使用してADMINユーザーとして接続します(サービス名はtnsnames.oraにあります)。

     connection=oracledb.connect(
          config_dir="/opt/OracleCloud/MYDB",
          user="admin",
          password=password,
          dsn="db2024_low",
          wallet_location="/opt/OracleCloud/MYDB",
          wallet_password=wallet_pw)

   • たとえば、Windowsでは、db2024_lowネットワーク・サービス名でoracledb.connectを使用してADMINユーザーとして接続します(サービス名はtnsnames.oraにあります)。

     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)

     'raw'文字列r"..."を使用すると、バックスラッシュはディレクトリ・セパレータとして扱われます。

   この例に示すように、wallet_locationとconfig_dirは同じディレクトリに設定されます(このディレクトリにはtnsnames.oraとewallet.pemが含まれます)。これらのファイルに同じディレクトリを指定する必要はありません。

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)

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)

1. ファイルtnsnames.ora、sqlnet.oraおよびcwallet.ssoをシステムに配置します。

   次の2つのオプションのいずれかを使用して、これらのファイルをシステムに配置します。

   • Instant Clientを使用している場合は、Instant Clientディレクトリの下にnetwork/adminサブディレクトリ階層にファイルを移動します。たとえば、アーキテクチャやクライアント・システム、Instant Clientのインストール場所によっては、ファイルは次のようにディレクトリの場所に配置する必要があります。

     /home/myuser/instantclient_19_21/network/admin

     または

     /usr/lib/oracle/19.21/client64/lib/network/admin

     たとえば、Linuxでは、完全なOracle Clientを使用している場合は、ファイルを$ORACLE_HOME/network/adminに移動します。

   • または、アクセス可能な任意のディレクトリにファイルを移動します。

     たとえば、Linuxでは、ファイルをディレクトリ/opt/OracleCloud/MYDBに移動し、sqlnet.oraを編集して、ウォレット・ロケーション・ディレクトリをcwallet.ssoファイルを含むディレクトリに変更します。

     たとえば、Linuxでは、次のようにsqlnet.oraを編集します。

     WALLET_LOCATION = (SOURCE = (METHOD=file) (METHOD_DATA = (DIRECTORY="/opt/OracleCloud/MYDB")))
     SSL_SERVER_DN_MATCH=yes

     構成ファイルがデフォルトの場所に存在しない場合、アプリケーションは、コールoracledb.init_oracle_client()のconfig_dirパラメータを使用するか、TNS_ADMIN環境変数を設定して、その場所を指定する必要があります。

     ノート
     
     これらの設定はいずれも必要ありません。すべての構成ファイルをnetwork/adminディレクトリに配置する場合は、sqlnet.oraを編集する必要はありません。
2. Pythonアプリケーションで、次の初期化パラメータおよび接続パラメータを設定して、Autonomous Databaseインスタンスに接続します:
   • config_dir: 構成ファイルを配置するときの構成ディレクトリを指定します。これは、構成ファイルがインスタント・クライアント構成ディレクトリnetwork/adminの外部のディレクトリに配置されている場合にのみ必要です。
   • dsn: tnsnames.oraファイルから目的のネットワーク別名を指定します。
   • password: データベース・ユーザー・パスワードを指定します。
   • user: データベース・ユーザーを指定します。

   構成ファイルの配置の最初のケースでは、dsnパラメータをtnsnames.oraから目的のネットワーク別名に設定して、データベース資格証明を使用してAutonomous Databaseインスタンスに接続します。

   たとえば、oracledb.init_oracle_clientを使用してADMINユーザーとして接続し、db2024_lowネットワーク・サービス名(サービス名はtnsnames.oraにあります)で接続するには:

   oracledb.init_oracle_client()
      connection=oracledb.connect(
          user="admin",
          password=password,
          dsn="db2024_low")

   構成ファイルがインスタント・クライアント構成ディレクトリの外部にあるディレクトリにある場合は、oracledb.init_oracle_clientをコールするときにconfig_dirパラメータを設定します。

   • Linux
   • Windows

   • たとえば、Linuxでは、db2024_lowネットワーク・サービス名を使用してADMINユーザーとして接続します。

     oracledb.init_oracle_client(config_dir="/opt/OracleCloud/MYDB")
        connection=oracledb.connect(
           user="admin",
           password=password,
           dsn="db2024_low")

   • たとえば、Windowsでは、db2024_lowネットワーク・サービス名を使用してADMINユーザーとして接続します。

     oracledb.init_oracle_client(config_dir=r"C:\opt\OracleCloud\MYDB")
        connection=oracledb.connect(
           user="admin",
           password=password,
           dsn="db2024_low")

     'raw'文字列r"..."を使用すると、バックスラッシュはディレクトリ・セパレータとして扱われます。

SQLNET.USE_HTTPS_PROXY=on

mydb_high=(description=
(address=(https_proxy=myproxy.example.com)
(https_proxy_port=80)
(protocol=tcps)(port=1522)(host=...)