Oracle Cloud Infrastructureドキュメント

Node.jsとその他のスクリプト言語の接続(mTLS)

Python、Node.js、PHP、Ruby、R、Go、Perlなど、様々な言語でプログラムを使用して、mTLS (ウォレットを使用)を使用してAutonomous AI Databaseインスタンスに接続できます。セキュリティはクライアント資格証明を使用して適用されます。

これらのスクリプト言語には、Oracle Call Interfaceライブラリを使用するデータベース・アクセスAPIまたはドライバが含まれます。

ノート

注意:

Oracle Instant Client/Oracle AI Database Client (18.19以上)、19.2以上または21 (ベース・リリース以上)を使用して接続している場合、Oracle Call Interface (OCI)クライアントはウォレットを使用したmTLS認証をサポートします。

ウォレットを使用しないNode.jsまたはその他のスクリプト言語の接続の詳細は、Walletを使用しないNode.jsおよびその他のスクリプト言語の接続を参照してください

詳細については、次のビデオを参照してください。

言語ドライバとクライアント・ライブラリのインストール

スクリプト言語からAutonomous AI Databaseに接続するには、まず次のように言語ドライバとクライアント・ライブラリをインストールします:

  1. Oracle Instant Client/Oracle AI Database Client: 18.19 (以上)、19.2 (以上)、または21 (ベース・リリース以上)をインストールします。

    ほとんどのアプリケーションでは、Instant Clientで問題ありません。Instant Clientをインストールするには、次を実行します:

    1. Instant Clientのダウンロード・ページから目的のアーキテクチャを選択し、(ダウンロード・ページで入手可能な) Basicパッケージをダウンロードします: Oracle Instant Client Downloads。

      または、Basic Lightのグローバリゼーション制限が用途に合っていれば、目的のアーキテクチャのダウンロード・ページからBasic Lightパッケージをダウンロードします。

    2. ソース・コードから言語APIまたはドライバを構築する場合は、Instant Client SDKもダウンロードする必要があります: Oracle Instant Client

    3. 選択したベース・パッケージを解凍します。たとえば、C:\instantclient_12_2または/home/myuser/instantclient_18_5.に解凍します。SDKもダウンロードする場合は、それを同じディレクトリに解凍します。

    4. Windowsでは、「環境変数」ペインの「システム変数」セクションで、PATH変数にパスを追加します(たとえば、C:\instantclient_12_2を追加します)。Windows 8では、「コントロール パネル」→「システム」→「システムの詳細設定」→「環境変数」に移動して、PATH変数設定領域にアクセスします。複数のバージョンのOracleライブラリがインストールされている場合は、必ず新しいディレクトリをパスの最初に配置してください。

    5. Windows以外のプラットフォームでは、シンボリック・リンクが存在していなければ作成します。たとえば:

      cd /home/myuser/instantclient_18_5
ln -s libclntsh.so.18.1 libclntsh.so

      システムに影響を受けるOracleソフトウェアが他になければ、Instant Clientをランタイム・リンク・パスに追加します。たとえば:

      sudo sh -c "echo /home/myuser/instantclient_18_5 > /etc/ld.so.conf.d/oic.conf"
sudo ldconfig

      または、アプリケーションを実行する各シェル内にライブラリ・パスを設定します。たとえば:

      export LD_LIBRARY_PATH=/home/myuser/instantclient_18_5:$LD_LIBRARY_PATH

      ノート

      ノート: Linux Instant Clientのダウンロード・ファイルは、.zipファイルまたは.rpmファイルとして入手できます。いずれのバージョンも使用できます。

  2. Oracle AI Databaseに関連する言語ドライバをインストールします:

Oracle Network Connectivityの有効化およびセキュリティ資格証明(Oracle Wallet)の取得

  1. Autonomous AI Databaseに接続するためのクライアント・セキュリティ資格証明を取得します。データベースにアクセスするために必要なクライアント・セキュリティ資格証明とネットワーク構成設定が含まれる圧縮ファイルを取得します。不正なデータベース・アクセスを防ぐために、このファイルとそのコンテンツを保護する必要があります。次のようにして、クライアント・セキュリティ資格証明ファイルを取得します:

  2. クライアント資格証明(ウォレット)ファイルを抽出します:

    • クライアント資格証明圧縮ファイルを解凍します。

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

      C:\instantclient_12_2\network\admin

      または

      /home/myuser/instantclient_18_5/network/admin

      または

      /usr/lib/oracle/18.5/client64/lib/network/admin
      • フルOracle Clientを使用している場合は、ファイルを$ORACLE_HOME/network/adminに移動します。

    • または、解凍したウォレット・ファイルを安全なディレクトリに配置し、TNS_ADMIN環境変数をそのディレクトリ名に設定します。

      ノート

      ノート: zipファイルの中で必要なファイルは、tnsnames.ora、sqlnet.ora、cwallet.ssoおよびewallet.p12のみです。

  3. プロキシの内側にいる場合は、「Oracle Call Interface、ODBCおよびJDBC OCI接続とウォレット(mTLS)の準備」の「HTTPプロキシを使用した接続」のステップを実行します。

アプリケーションの実行

  1. データベース・ユーザー名、パスワード、および解凍したtnsnames.oraファイルで指定されているOracle Net接続名を使用して、接続するようにアプリケーションを更新します。たとえば、ユーザー、adb_user、passwordおよびdb2022adb_lowを接続文字列として指定します。

  2. または、tnsnames.oraの接続文字列をアプリケーションで使用される文字列と一致するように変更します。

  3. アプリケーションを実行します。