ドキュメントWorkfrontWorkfront ガイド

Adobe Authenticator モジュール

Last update: Thu Nov 21 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • トピック：

作成対象：

  • ユーザー

Adobe Authenticator モジュールを使用すると、1 回の接続で、任意のAdobeAPI に接続できます。 これにより、まだ専用の Fusion コネクタがないAdobe製品に、より簡単に接続できます。

HTTP モジュールより有利な点は、専用のアプリのように接続を作成できることです。

使用可能なAdobeAPI の一覧については、AdobeAPI を参照してください。 割り当てられている API のみを使用できる場合があります。

アクセス要件

Adobe Workfront プラン*

新規：任意

または

現在：Pro 以上

Adobe Workfront ライセンス

新規：標準

または

現在：計画 ​、作業 ​

Adobe Workfront Fusion ライセンス

現在の Fusion ライセンス要件：Workfront Fusion ライセンス要件はありません。

または

従来の Fusion ライセンス要件：Workfront Fusion for Work Automation and Integration

製品

新しいWorkfront プラン：Select または Prime Adobe Workfront プランがある場合、この記事に記載されている機能を使用するには、組織で Adobe Workfront Fusion の購入 Adobe Workfront 必要です。 Workfront Fusion は、Workfront Ultimate プランに含まれています。

または

現在のWorkfront プラン：この記事に記載されている機能を使用するには、Adobe Workfront Fusion を購入する必要が Adobe Workfront ります。

前提条件

  • モジュールの接続先となるAdobe製品へのアクセス権が必要です。

  • Adobe Developer Consoleにアクセスできる必要があります。

  • Adobe Developer Consoleに、モジュールの接続先となる API を含むプロジェクトがある必要があります。 実行できる操作：

    • API を使用して新しいプロジェクトを作成します。

      または

    • API を既存のプロジェクトに追加します。

    Adobe Developer Consoleを使用したプロジェクトへの API の作成または追加については、Adobeドキュメントの プロジェクトの作成を参照してください。

Adobe Authenticator API の情報

Adobe Authenticator コネクタでは、以下を使用します。

API タグ
v1.1.4

接続の作成

Adobe Authenticator接続は、Adobe Developer Console上の 1 つのプロジェクトに接続します。 複数のAdobeAPI に同じコネクションを使用するには、API を同じプロジェクトに追加して、そのプロジェクトへのコネクションを作成します。

個別のプロジェクトに対して個別の接続を作成できますが、接続を使用して、その接続で指定されたプロジェクトにない API にアクセスすることはできません。

IMPORTANT
Adobe Authenticator コネクタでは、OAuth サーバー間接続を使用するか、サービスアカウント（JWT）接続を使用するかを選択できます。 Adobeでは、JWT 資格情報を廃止しました。この資格情報は 2025 年 1 月 1 日（PT）以降、機能しなくなります。 したがって、OAuth 接続を作成することを強くお勧めします。
これらのAdobeの詳細については、接続ドキュメントの サーバーからサーバーへの認証を参照してください

接続を作成するには：

  1. 任意の Adobe Authenticator モジュールで、接続フィールドの横にある「追加」をクリックします。

  2. 次のフィールドに入力します。

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 layout-auto html-authored no-header
    Connection type OAuth サーバー間接続を作成するか、サービスアカウント（JWT）接続を作成するかを選択します。
    Connection name この接続の名前を入力します。
    Client ID Adobe クライアント ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Client Secret Adobe クライアントの秘密鍵を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Scopes OAuth 接続を選択した場合は、この接続に必要なスコープを入力します。
    Technical account ID Adobe テクニカルアカウント ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Organization ID JWT 接続を選択した場合は、Adobe 組織 ID を入力します。 これは、Adobe Developer Console の Credentials details セクションで確認できます。
    Meta Scopes JWT 接続を選択した場合、この接続に必要なメタ範囲を入力します。
    Private key

    JWT 接続を選択した場合は、資格情報が Adobe Developer Console で作成されたときに生成された秘密鍵を入力します。

    秘密鍵または証明書を抽出するには：

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

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

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

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

    5. Save をクリックしてファイルを抽出し、接続設定に戻ります。
    ベース URL

    この認証を許可するベース URL を追加する必要があります。 シナリオの後半で「カスタム API 呼び出しを行う」モジュールを使用する場合、選択した URL への相対パスを追加します。 ここに URL を入力すると、カスタム API 呼び出しを行うモジュールが何に接続できるかを制御でき、セキュリティが強化されます。

    認証サーバーに追加するベース URL ごとに、「 項目を追加 」をクリックしてベース URL を入力します。
    Authentication URL 標準のAdobe IMS認証 URL https://ims-na1.adobelogin.com を使用する場合は、この値を空白のままにします。 認証にAdobe IMSを使用しない場合は、認証に使用する URL を入力します。
    Environment 実稼動環境と非実稼動環境のどちらに接続するかを選択します。
    Type サービスアカウントと個人アカウントのどちらに接続するかを選択します。

  3. 「続行」をクリックして接続を保存し、モジュールに戻ります。

モジュール

カスタム API 呼び出しの実行

このアクションモジュールを使用すると、任意のAdobe API を呼び出すことができます。 テキストのみの本文ではなく、大きなファイルをサポートします。

このモジュールは、2024 年 11 月 14 日（PT）に使用可能になりました。 この日付より前に設定されたAdobe Authenticator/カスタム API 呼び出しを行では、大きなファイルを処理せず、カスタム API 呼び出しを行う（レガシー） モジュールと見なされるようになりました。

Connection
Adobe Authenticator モジュールへの接続を作成する手順については、この記事の 接続の作成を参照してください。
Base URL
接続先の API ポイントのベース URL を入力します。
URL
ベース URL に対する相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例： {"Content-type":"application/json"}

Workfront Fusion は、認証ヘッダーを自動的に追加します。

Query String
リクエストクエリ文字列を入力します。
Body Type

この API リクエストの本文タイプを選択：

  • application/x-www-form-urlencoded
  • 生
  • multipart/form-data
Fields
APU 要求に追加するファイルごとに、 アイテムを追加 をクリックしてファイルのテキストを入力するか（生データの場合）、キー uploadedFile を入力してファイルのデータをマッピングします。

カスタム API 呼び出しの実行（レガシー）

このアクションモジュールを使用すると、任意のAdobe API を呼び出すことができます。

Connection
Adobe Authenticator モジュールへの接続を作成する手順については、この記事の 接続の作成を参照してください。
Base URL
接続先の API ポイントのベース URL を入力します。
URL
ベース URL に対する相対パスを入力します。
Method
API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、Adobe Workfront Fusionでの HTTP リクエストメソッドを参照してください。
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例： {"Content-type":"application/json"}

Workfront Fusion は、認証ヘッダーを自動的に追加します。

Query String
リクエストクエリ文字列を入力します。
Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ：

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

Limit
モジュールが 1 回の実行サイクルで返す結果の最大数を入力します。
recommendation-more-help
5f00cc6b-2202-40d6-bcd0-3ee0c2316b43