4.6 Oracle REST Data Servicesの構成

Oracle REST Data Servicesの構成には、imagesディレクトリのコピー、構成の実行によるOracle REST Data Servicesの構成の構成、静的ファイル・サポートの構成およびOracle REST Data Serviceの保護が必要です。

新規インストールでRESTful Servicesを設定する方法は、次のセクションで説明しています。

• imagesディレクトリのコピー
  新規インストールをロードしているか、以前のリリースをアップグレードしているかにかかわらず、トップ・レベルのapex\imagesディレクトリ(例: C:\TEMP)から、インストールされているOracle REST Data Servicesが使用している場所に、imagesディレクトリをコピーする必要があります。
• Oracle REST Data Servicesインストールの検証
  Oracle Application Expressの新規インストールまたはアップグレードでは、Oracle REST Data Servicesインストールを検証する必要があります。
• RESTfulサービスの構成
  Oracle Application Expressを新規インストールまたはアップグレードする場合は、構成スクリプトapex_rest_config.sqlを実行してRESTfulサービスを構成します。
• 静的ファイル・サポートの構成
  静的ファイルを構成するために、Oracle Application Expressの新規インストールまたはアップグレード後にはapex_rest_config.sqlを実行する必要があります。
• Oracle REST Data Serviceの保護
  Oracle Application Expressの構成では、パラメータsecurity.requestValidationFunctionをwwv_flow_epg_include_modules.authorizeに設定することをお薦めします。

4.6.1 imagesディレクトリのコピー

新規インストールをロードしているか、以前のリリースをアップグレードしているかにかかわらず、トップ・レベルのapex\imagesディレクトリ(例: C:\TEMP)から、インストールされているOracle REST Data Servicesが使用している場所に、imagesディレクトリをコピーする必要があります。

アップグレード中に、既存のimagesディレクトリを上書きします。以前のバージョンに戻すことができるように、アップグレードの開始前に、Oracle Application Express用の既存のimagesディレクトリのコピーを作成して、imagesのリリース番号(images_5_1など)を示しておくことをお薦めします。

参照:

『Oracle REST Data Servicesインストレーション、構成および開発ガイド』

4.6.2 Oracle REST Data Servicesインストールの検証

Oracle Application Expressの新規インストールまたはアップグレードでは、Oracle REST Data Servicesインストールを検証する必要があります。

Oracle Application Expressの新規インストールまたはアップグレードでOracle REST Data Servicesインストールを検証するには、次の手順を実行します。

java -jar ords.war validate [--database <dbname>]

参照:

『Oracle REST Data Servicesインストレーション、構成および開発ガイド』

4.6.3 RESTfulサービスの構成

Oracle Application Expressを新規インストールまたはアップグレードする場合は、構成スクリプトapex_rest_config.sqlを実行してRESTfulサービスを構成します。

構成すると、インスタンス管理者がこの機能の可用性を制御できます。インスタンス管理者がこのApplication ExpressインスタンスのRESTfulサービスを無効にした場合、このインスタンスではRESTfulサービスを使用できず、RESTfulサービスのアイコンも表示されません。

Oracle Application ExpressでRESTfulサービスを構成するには、次のステップを実行します。

1. 作業ディレクトリを、インストール・ソフトウェアを解凍したapexディレクトリに変更します。
2. SQL*Plusを起動し、Oracle Application Expressをインストールするデータベースに、SYSDBAロールが指定されているSYSとして接続します。次に例を示します。

   • Windowsの場合:

     SYSTEM_DRIVE:\ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

   • UNIXおよびLinuxの場合:

     $ sqlplus /nolog
     SQL> CONNECT SYS as SYSDBA
     Enter password: SYS_password
     

3. apex_rest_config.sqlを実行します。次に例を示します。

   @apex_rest_config.sql
   

   プロンプトが表示されたら、APEX_LISTENERアカウントおよびAPEX_REST_PUBLIC_USERアカウントのパスワードを入力します。

   Oracle Application ExpressでRESTfulサービスを構成する際は、2つのデータベース・アカウントが新しく作成されます。

   • APEX_LISTENER - Oracle Application Expressに格納されているRESTfulサービスの定義を照会するために使用されるアカウント。

   • APEX_REST_PUBLIC_USER -Oracle Application Expressに格納されているRESTfulサービスの定義を呼び出す際に使用されるアカウント。

参照:

『Oracle Application Express管理ガイド』のインスタンスのRESTfulサービスの制御に関する項

4.6.4 静的ファイル・サポートの構成

静的ファイルを構成するために、Oracle Application Expressの新規インストールまたはアップグレード後にはapex_rest_config.sqlを実行する必要があります。

Oracle Application Expressを使用すると、アプリケーション開発者はアプリケーションに静的ファイルを含めることができます。静的ファイルは、ワークスペース、アプリケーション、プラグインまたはアプリケーション・テーマに関連付けることができます。Oracle REST Data ServicesをWebリスナーとして使用する場合、静的ファイルは、Oracle Application Expressに組み込まれたRESTfulサービス・モジュールを使用して提供されます。このため、Oracle Application Expressの新規インストールまたはアップグレード後にはapex_rest_config.sqlを実行する必要があります。

参照:

"Oracle REST Data Servicesの構成"

4.6.5 Oracle REST Data Serviceの保護

Oracle Application Expressの構成では、パラメータsecurity.requestValidationFunctionをwwv_flow_epg_include_modules.authorizeに設定することをお薦めします。

パラメータwwv_flow_epg_include_modules.authorizeをsecurity.requestValidationFunctionに設定すると、Oracle Application Expressに組込まれている呼出し可能なプロシージャのホワイトリストがアクティブ化され、他のプロシージャの呼出しが禁止されます。

参照:

『Oracle Application Expressアプリケーション・ビルダー・ユーザーズ・ガイド』