1. 管理ガイド
  2. Oracle Application Express管理サービス
  3. インスタンス設定の管理
  4. REST管理インタフェースの使用

3.3.5 REST管理インタフェースの使用

REST管理インタフェースを使用して、REST管理インタフェースの有効化または無効化、RESTクライアント・アプリケーションの登録、RESTクライアントの詳細の表示、またはRESTクライアントの削除を行います。

ノート:

開発環境のセキュリティとパフォーマンスを確保するために、この機能はOracle Cloudで実行されているApplication Expressインスタンスでは使用できません。

ヒント:

REST管理インタフェースには、Oracle REST Data Services (ORDS)リリース3.0.5以上が必要です。

  • REST管理インタフェースについて
    REST管理インタフェースを使用するには、まず、RESTクライアント・アプリケーションを登録してから、クライアントの詳細を確認し、OAuthクライアント資格証明認証フローに従って、アクセス・トークンを取得します。
  • REST管理インタフェースの有効化
    インストール後、REST管理インタフェースは無効化されています。有効にするには、インスタンス管理者はOracle Application Express管理サービスにサインインする必要があります。
  • RESTクライアント・アプリケーションの登録
    RESTクライアントの接続を確立するためには、内部管理者はRESTクライアント・アプリケーションを登録する必要があります。
  • RESTクライアントの詳細の表示
    RESTクライアントの詳細は、「REST管理インタフェース」ダイアログで表示します。
  • RESTクライアントの削除
    「ORDSクライアントの詳細」ダイアログが表示されている間にRESTクライアントを削除します。
  • REST管理インタフェースの無効化
    「REST管理インタフェース」ダイアログでREST管理インタフェースを無効にします。

参照:

親トピック: インスタンス設定の管理

3.3.5.1 REST管理インタフェースについて

REST管理インタフェースを使用するには、まず、RESTクライアント・アプリケーションを登録してから、クライアントの詳細を確認し、OAuthクライアント資格証明認証フローに従って、アクセス・トークンを取得します。

REST管理インタフェースを提供するために、Oracle Application Expressはインストール時にデータベース・ユーザーAPEX_INSTANCE_ADMIN_USERを作成します。権限の低いこのスキーマは、CREATE SESSIONシステム権限のみを付与されており、インストール後にロックされます。「REST管理インタフェース」を使用するには、まずAPEX_INSTANCE_ADMIN_USERユーザーのロックを解除する必要があります。REST管理インタフェースのサービス・モジュールはAPEX_INSTANCE_ADMIN_USERスキーマに格納されています。Oracleでは、APEX_INSTANCE_ADMIN_USERへの直接ログインは要求または推奨されません。

親トピック: REST管理インタフェースの使用

3.3.5.2 REST管理インタフェースの有効化

インストール後、REST管理インタフェースは無効になっています。有効にするには、インスタンス管理者はOracle Application Express管理サービスにサインインする必要があります。

「REST管理インタフェース」を有効にするには:

  1. APEXデータベース内のAPEX_INSTANCE_ADMIN_USERデータベース・ユーザーのロックを解除します。
  2. Oracle Application Express管理サービスにサインインします。
  3. 「インスタンスの管理」をクリックします。
  4. 「インスタンスの設定」で、「REST管理インタフェース」をクリックします。
  5. 「REST管理インタフェース」ダイアログで、「サービスの有効化」をクリックします。

親トピック: REST管理インタフェースの使用

3.3.5.3 RESTクライアント・アプリケーションの登録

RESTクライアントの接続を確立するためには、内部管理者はRESTクライアント・アプリケーションを登録する必要があります。

RESTクライアント・アプリケーションを登録するには:

  1. Oracle Application Express管理サービスにサインインします。
  2. 「インスタンスの管理」をクリックします。
  3. 「インスタンスの設定」で、「REST管理インタフェース」をクリックします。
  4. 「REST管理インタフェース」ダイアログで、「OAuthクライアントの作成」をクリックします。
  5. 「新規OAuthクライアントの作成」ダイアログで、次を入力します。

    • クライアント名

    • 連絡先の電子メール・アドレス

    • クライアント・ロール

    OAuthクライアント資格証明フロー用の資格証明(クライアントIDおよびクライアントの秘密)は、自動的に作成されます。これらの資格証明により、RESTクライアントはREST管理インタフェースに接続し、サービスを実行できます。

  6. 「OAuthクライアントの作成」をクリックします。

    クライアントが「OAuthクライアント」リストに表示されます。

親トピック: REST管理インタフェースの使用

3.3.5.4 RESTクライアントの詳細の表示

RESTクライアントの詳細は、「REST管理インタフェース」ダイアログで表示します。

開発者は、OAuthクライアント資格証明認証フローに従って、RESTクライアントの詳細を使用してアクセス・トークンを取得できます。

ヒント:

OAuthフロー機能についてさらに学習するには、チュートリアル: リソースの保護およびアクセス in Oracle REST Data Servicesインストレーション、構成および開発ガイドを参照してください。

RESTクライアントの詳細を表示するには:

  1. Oracle Application Express管理サービスにサインインします。
  2. 「インスタンスの管理」をクリックします。
  3. 「インスタンスの設定」で、「REST管理インタフェース」をクリックします。

    「REST管理インタフェース」ダイアログが表示されます。

  4. 「REST管理インタフェース」ダイアログで、クライアント名をクリックします。

    「ORDSクライアントの詳細」ダイアログには、クライアント名、連絡先の電子メール・アドレス、OauthクライアントIDおよびOauthクライアントの秘密が表示されます。
    client_details.pngの説明が続きます
    図client_details.pngの説明

    参照:

    現在のクライアントを削除するには、「クライアントの削除」をクリックします。

  5. 前の画面に戻るには、「戻る」をクリックします。

    参照:

    Oracle Application Express APIリファレンスのREST管理インタフェースAPIの使用

親トピック: REST管理インタフェースの使用

3.3.5.5 RESTクライアントの削除

「ORDSクライアントの詳細」ダイアログが表示されている間にRESTクライアントを削除します。

RESTクライアントを削除するには:

  1. Oracle Application Express管理サービスにサインインします。
  2. 「インスタンスの管理」をクリックします。
  3. 「インスタンスの設定」で、「REST管理インタフェース」をクリックします。

    「REST管理インタフェース」ダイアログが表示されます。

  4. 「REST管理インタフェース」ダイアログで、クライアント名をクリックします。

    「ORDSクライアントの詳細」ダイアログが表示されます。


    client_details.pngの説明が続きます
    図client_details.pngの説明
  5. 「クライアントの削除」をクリックします。
  6. 前の画面に戻るには、「戻る」をクリックします。

親トピック: REST管理インタフェースの使用

3.3.5.6 REST管理インタフェースの無効化

「REST管理インタフェース」ダイアログでREST管理インタフェースを無効にします。

REST管理インタフェースを無効にするには:

  1. Oracle Application Express管理サービスにサインインします。
  2. 「インスタンスの管理」をクリックします。
  3. 「インスタンスの設定」で、「REST管理インタフェース」をクリックします。
  4. 「REST管理インタフェース」ダイアログで、「サービスの無効化」または「サービスの無効化とクライアントの削除」をクリックします。

親トピック: REST管理インタフェースの使用