HTTP > API キー認証リクエストを行う

このAdobe Workfront Fusion アクションモジュールは、API キー認証の認証を必要とする指定されたURLにHTTPS リクエストを送信し、応答を処理します。

NOTE
現在、専用コネクタがないAdobe製品に接続する場合は、Adobe Authenticator モジュールを使用することをお勧めします。
詳しくは、Adobe Authenticator モジュールを参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

アクセス要件

accordion
展開すると、この記事の機能のアクセス要件が表示されます。
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ

任意の Adobe Workfront Workflow パッケージと任意の Adobe Workfront Automation および Integration パッケージ

Workfront Ultimate

Workfront Fusion を追加購入した Workfront Prime および Select パッケージ。

Adobe Workfront ライセンス

標準

Work またはそれ以上

Adobe Workfront Fusion ライセンス

オペレーションベース:Workfront Fusion ライセンス要件なし

コネクターベース(レガシー):Workfront Fusion for Work Automation および Integration

製品 組織が Workfront Automation および Integration を含まない Select またはPrime Workfront パッケージを持っている場合は、Adobe Workfront Fusion を購入する必要があります。

この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

この表の情報について詳しくは、ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

+++

HTTP > API キー認証リクエストを作成 モジュール設定

HTTP > API Key Authorization Request モジュールを設定すると、Adobe Workfront Fusionに次のフィールドが表示されます。 モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。 詳しくは、Adobe Workfront Fusion でのモジュール間の情報のマッピングを参照してください。

マップ切り替え

Credentials

API キー認証資格情報を含むキーを選択します。 新しいキーを追加するには、Add をクリックして、次の情報を設定します。

  • Key name

    この API 資格情報セットの名前を入力します。

  • Key

    API キーを入力します。

  • API Key placement

    API キーをヘッダーに配置するか、API 呼び出しのクエリに配置するかを選択します。

  • API Key parameter name

    API 呼び出しで API キーを識別する名前(「apiKey」や「X-API-Key」など)を入力します。 この情報は、モジュールが接続する web サービスのドキュメントに記載されています。

Evaluate all states as errors (except for 2xx and 3xx)

エラー処理を設定するには、このオプションを使用します。

詳しくは、 エラー処理を参照してください。

URL
API エンドポイント、ウェブサイトなど、リクエストの送信先 URL を入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。 詳しくは、HTTP リクエスト方法を参照してください。
Headers
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。 例: {"Content-type":"application/json"}
Query String
目的のクエリのキーと値のペアを入力します。
Body type

HTTP 本文は、使用するヘッダーがある場合、そのヘッダーの直後に HTTP トランザクションメッセージで送信されるデータバイトです。

  • Raw

    Raw 本文タイプは、開発者向けドキュメントで送信するデータが指定されていない場合でも、通常、ほとんどの HTTP 本文リクエストに適しています。

    データを解析する形式を Content type フィールドに指定します。

    選択したコンテンツタイプにもかかわらず、モジュールは開発者ドキュメントで規定されているか必要とされている任意の形式でデータを入力します。

  • Application/x-www-form-urlencoded

    この本文タイプは、application/x-www-form-urlencoded を使用してデータを POST します。

    application/x-www-form-urlencoded の場合、サーバーに送信される HTTP メッセージの本文は基本的に 1 つのクエリ文字列になります。 キーと値は、& で区切られ、キーと値の間に = を持つキーと値のペアでエンコードされています。

    バイナリデータの場合は、代わりに multipart/form-data を使用します。

    例:

    結果の HTTP リクエスト形式の例は、次のようになります。

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data は、ファイルとデータの送信に使用される HTTP マルチパートリクエストです。 通常、ファイルをサーバーにアップロードする際に使用されます。

    リクエストで送信するフィールドを追加します。 各フィールドには、キーと値のペアが含まれている必要があります。

    • Text

      リクエスト本文内で送信するキーと値を入力します。

    • File

      キーを入力し、リクエスト本文で送信するソースファイルを指定します。

      前のモジュールからアップロードするファイル(HTTP > Get a FileまたはGoogle Drive >Download a Fileなど)をマッピングするか、ファイル名とファイルデータを手動で入力します。

Parse response

このオプションを有効にすると、応答を自動的に解析し、JSON および XML 応答を変換するので、JSON/Parse JSON または XML/Parse XML モジュールを使用する必要がなくなります。

解析された JSON または XML コンテンツを使用する前に、モジュールを手動で 1 回実行して、モジュールが応答コンテンツを認識し、後続のモジュールにマッピングできるようにします。

Timeout
リクエストのタイムアウトを秒単位で指定します(1~300)。 デフォルトは 40 秒です。
Share cookies with other HTTP modules
このオプションを有効にすると、シナリオ内のすべての HTTP モジュールとサーバーから Cookie を共有できます。
Self-signed certificate

自己署名証明書を追加するには:

  1. Extract をクリックします。

  2. 抽出するファイルのタイプを選択します。

  3. またはの証明書を含むファイルを選択します。

  4. ファイルのパスワードを入力します。

  5. Saveをクリックしてファイルを抽出し、モジュール設定に戻ります。

Reject connections that are using unverified (self-signed) certificates
このオプションを有効にすると、未検証の TLS 証明書を使用している接続を拒否できます。
Follow redirect
このオプションを有効にすると、3xx 応答で URL リダイレクトに従います。
Follow all redirects
このオプションを有効にすると、すべての応答コードで URL リダイレクトに従います。
Disable serialization of multiple same query string keys as arrays
デフォルトでは、Workfront Fusionは、同じURL クエリ文字列パラメーターキーの複数の値を配列として処理します。 例えば、www.test.com?foo=bar&foo=bazwww.test.com?foo[0]=bar&foo[1]=baz に変換されます。 このオプションをアクティブ化すると、この機能は無効になります。
Request compressed content

このオプションを有効にすると、web サイトの圧縮バージョンを要求できます。

圧縮コンテンツをリクエストするヘッダーに、Accept-Encoding を追加します。

Use Mutual TLS

このオプションを有効にすると、HTTP リクエストで相互 TLS を使用できます。

相互TLSについて詳しくは、Adobe Workfront FusionでのHTTP モジュールでの相互TLSの使用を参照してください。

recommendation-more-help
workfront-fusion-help-workfront-fusion