18.7.2 Web資格証明の作成

ワークスペース・ユーティリティまたは共有コンポーネントからWeb資格証明を作成します。

Web資格証明を作成するには:

  1. Web資格証明ページにナビゲートします。
    • 「ワークスペース・ユーティリティ」からの場合:
      1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

      2. 「ワークスペース・ユーティリティ」をクリックします。

      3. 「Web資格証明」をクリックします。

    • 「共有コンポーネント」からの場合:
      1. ワークスペースのホームページで、「アプリケーション・ビルダー」をクリックします。

      2. アプリケーションを選択します。

      3. アプリケーションのホームページで、ページの中央にある「共有コンポーネント」をクリックします。

      4. 「ワークスペース・オブジェクト」で、「資格証明」を選択します。

  2. Web資格証明ページで、「作成」をクリックします。
  3. Web資格証明ページで属性を構成します。
    1. 名前 - 説明的な名前を入力します。静的ID
    2. 静的ID - 静的識別子を使用して、APIコールで資格証明を参照します。
    3. 認証タイプ: 次のいずれかを選択します。
      • 基本認証
      • OAuth2クライアント資格証明
      • OCIネイティブ認証
      • HTTPヘッダー
      • URL問合せ文字列
      • キー・ペア

      使用可能な認証タイプの詳細は、フィールドレベル・ヘルプを参照してください。

      ノート:

      選択した認証タイプによって、次に表示されるオプションが決まります。
  4. データベース資格証明の使用 - このスイッチは、「認証タイプ」が「基本認証」または「OAuth2クライアント資格証明」の場合にのみ表示されます。

    「データベース資格証明の使用」スイッチが有効になっている場合は、データベース資格証明の名前を構成するセクションが表示されます。データベース資格証明はAPEXではなくデータベースによって管理されるため、「クライアントID」「クライアント・シークレット」および「URLに対して有効」の属性は表示されなくなります。

    「データベース資格証明の使用」の詳細は、フィールドレベル・ヘルプを参照してください。

  5. 「認証タイプ」が「基本認証」の場合:
    1. クライアントIDまたはユーザー名 - ユーザー名を入力します。APEXでは、この情報を暗号化して保存しません。
    2. クライアント・シークレットまたはパスワード - パスワードを入力します。
    3. クライアント・シークレットまたはパスワードの確認 - パスワードを再度入力して、入力内容を確認します。
    4. URLに対して有効 - APEXは、Web資格証明が使用するURLがこの属性のURLと一致するかどうかをチェックします。この属性にURLを追加する場合は、次のようにします。
      • 各URLを新しい行に配置します。

      • 使用するURLエンドポイントは、ここで指定するURLのいずれかで始まる必要があります。

      例は、フィールドレベル・ヘルプを参照してください。

    5. インストール時にプロンプトを表示 - アプリケーションを別のAPEXインスタンスにインポートするときに、この資格証明を要求するプロンプトを表示するかどうかを選択します。
    6. コメント - ここにコメントまたはノートを入力します。これらのコメントは、アプリケーションの実行時には表示されません。
  6. 「認証タイプ」が「OAuth2クライアント資格証明」の場合:
    1. OAuthスコープ - OAuth 2.0用語のアクセス・トークンで表される権限は、スコープと呼ばれます。スコープ・パラメータを使用すると、アプリケーションはアクセス・リクエストの目的のスコープを表現できます。

      認証サーバーでアクセス・トークン・リクエストにスコープを指定する必要がある場合は、ここで指定します。OAuth2アクセス・トークンは、次のリクエスト本文でリクエストされます。

      grant_type=client_credentials&scope={scope}
    2. クライアントIDまたはユーザー名 - クライアントIDを入力します。APEXでは、この情報を暗号化して保存しません。
    3. クライアント・シークレットまたはパスワード - パスワードを入力します。
    4. クライアント・シークレットまたはパスワードの確認 - パスワードを再度入力して、入力内容を確認します。
    5. URLに対して有効 - APEXは、Web資格証明が使用するURLがこの属性のURLと一致するかどうかをチェックします。この属性にURLを追加する場合は、次のようにします。
      • 各URLを新しい行に配置します。

      • 使用するURLエンドポイントは、ここで指定するURLのいずれかで始まる必要があります。

      例は、フィールドレベル・ヘルプを参照してください。

    6. インストール時にプロンプトを表示 - アプリケーションを別のAPEXインスタンスにインポートするときに、この資格証明を要求するプロンプトを表示するかどうかを選択します。
    7. コメント - ここにコメントまたはノートを入力します。これらのコメントは、アプリケーションの実行時には表示されません。
  7. 「認証タイプ」が「OCIネイティブ認証」の場合:
    1. OCIユーザーID - Oracle Cloud InfrastructureユーザーOCIDを入力します。APEXでは、この情報を暗号化して保存しません。
    2. OCI秘密キー - OCI認証の秘密キーをPEM形式で入力します。APEXでは、この情報を暗号化してセキュアに保存するため、クリア・テキストで回収できなくなります。
    3. OCIテナンシID - Oracle Cloud InfrastructureテナンシのOCIDを入力します。
    4. OCI公開キー・フィンガープリント - OCI認証の公開RSAキー・フィンガープリントを入力します。
    5. URLに対して有効 - APEXは、Web資格証明が使用するURLがこの属性のURLと一致するかどうかをチェックします。この属性にURLを追加する場合は、次のようにします。
      • 各URLを新しい行に配置します。

      • 使用するURLエンドポイントは、ここで指定するURLのいずれかで始まる必要があります。

      例は、フィールドレベル・ヘルプを参照してください。

    6. インストール時にプロンプトを表示 - アプリケーションを別のAPEXインスタンスにインポートするときに、この資格証明を要求するプロンプトを表示するかどうかを選択します。
    7. コメント - ここにコメントまたはノートを入力します。これらのコメントは、アプリケーションの実行時には表示されません。
  8. 「認証タイプ」が「HTTPヘッダー」の場合:
    1. 資格証明名 - この資格証明に使用するHTTPヘッダーまたはURL問合せ文字列パラメータの名前を入力します。
    2. 資格証明シークレット - 資格証明の値(シークレット)を入力します。
    3. URLに対して有効 - APEXは、Web資格証明が使用するURLがこの属性のURLと一致するかどうかをチェックします。この属性にURLを追加する場合は、次のようにします。
      • 各URLを新しい行に配置します。

      • 使用するURLエンドポイントは、ここで指定するURLのいずれかで始まる必要があります。

      例は、フィールドレベル・ヘルプを参照してください。

    4. インストール時にプロンプトを表示 - アプリケーションを別のAPEXインスタンスにインポートするときに、この資格証明を要求するプロンプトを表示するかどうかを選択します。
    5. コメント - ここにコメントまたはノートを入力します。これらのコメントは、アプリケーションの実行時には表示されません。
  9. 「認証タイプ」が「URL問合せ文字列」の場合:
    1. 資格証明名 - この資格証明に使用するURL問合せ文字列パラメータの名前を入力します。
    2. 資格証明シークレット - 資格証明の値(シークレット)を入力します。
    3. URLに対して有効 - APEXは、Web資格証明が使用するURLがこの属性のURLと一致するかどうかをチェックします。この属性にURLを追加する場合は、次のようにします。
      • 各URLを新しい行に配置します。

      • 使用するURLエンドポイントは、ここで指定するURLのいずれかで始まる必要があります。

      例は、フィールドレベル・ヘルプを参照してください。

    4. インストール時にプロンプトを表示 - アプリケーションを別のAPEXインスタンスにインポートするときに、この資格証明を要求するプロンプトを表示するかどうかを選択します。
    5. コメント - ここにコメントまたはノートを入力します。これらのコメントは、アプリケーションの実行時には表示されません。
  10. 「認証タイプ」が「キー・ペア」の場合:
    1. 公開キー - キー・ペア資格証明の公開キーを入力します。APEXでは、この情報を暗号化して保存しません。
    2. 秘密キー - キー・ペア資格証明の秘密キーを入力します。APEXでは、この情報を暗号化して保存するため、クリア・テキストで回収できなくなります。
    3. 秘密キーの検証 - 秘密キーを再入力して、入力を検証します。
  11. 「変更の適用」をクリックします。