アプリケーションにアクセスするための認証を有効にして、Control Room がアプリケーション データにアクセスできるようにします。

コネクター ビルダーで、認証トグルスイッチを使用して、アプリのセッションを認証します。 このオプションは、Control Room により管理されているセッション内で認証トークンを維持し、パッケージ内のすべてのアクションに自動的に渡します。 このアプローチにより、各アクションの認証ヘッダーまたはクエリ パラメーターを手動で処理する必要がなくなり、認証プロセスが簡素化されます。

前提条件

カスタム コネクターを作成したことを確認してください。 「カスタム コネクターの作成」を参照してください。

手順

  1. Control Room にログインします。
  2. [マネージ] > [パッケージ] の順に移動します。
  3. [パッケージ] ページで、[コネクター] タブをクリックします。
  4. コネクターをクリックするか、新しいコネクターを作成します。
  5. [認証] トグル スイッチをオンにします。
  6. ドロップダウンから次のいずれかの認証タイプを選択します。
    認証タイプ 説明
    基本 パッケージ アクションを使用する場合、ユーザー名とパスワードを入力して、ターゲット アプリケーションを認証する必要があります。 Control Room は、API リクエスト内の「Basic <base-64 encoded>」形式の認証ヘッダーで base-64 エンコードされた資格情報を自動的に送信します。
    Oauth 2.0 パッケージ アクションを使用する場合、オートメーションを使用する際に、Control Room から既存の OAuth2 接続を選択する必要があります。 Control Room は、API リクエストに Control Room から取得したアクセス トークンを含めます。
    1. ヘッダーまたはクエリ パラメーターとして API プロバイダーに送信する適切な場所タイプを選択します。
    2. ヘッダー パラメーターには名前と接頭辞1を、クエリ パラメーターには名前を入力します。
    API キー パッケージ アクションを使用する場合、API キーを入力して認証する必要があります。 Control Room は、API リクエストにヘッダーやパラメーターと一緒に API キーを自動的に送信します。
    1. ヘッダーまたはクエリ パラメーターとして API プロバイダーに送信する適切な場所タイプを選択します。
    2. ヘッダーには名前と接頭辞1を入力してください。
      注:
      • APIキー認証を有効にするには、少なくとも1つのヘッダーが必要です。
      • 認証アクションに追加情報を含めるために、複数のヘッダーを追加できます。

        複数のヘッダーは追加のセキュリティ層を提供します。 ヘッダーにはコンテキストのメタデータも含めることができます。

      • 既存のヘッダーのキーとプレフィックスは、編集ボタンを使用して変更できます。
      • 既存のヘッダーを個別またはまとめて削除ボタンを使用して削除できます。
    3. クエリパラメータには、リクエストに含める適切な名前を入力してください。
    カスタム パッケージ アクションを使用する場合、情報を入力して接続を確立する必要があります。 作成するセッションの構成方法に応じて、Control Room は API リクエストにセッション情報を含めます。 認証で使用する設定を構成するには、「コネクター エディターのアクションの構成」を参照してください。

    1プレフィックスの後にスペースを追加しないでください。 例えば、接頭辞が Bearer の場合、後にスペースを入れずに Bearer と入力してください。