MS Graph REST API の呼び出し
多くのMicrosoft web サービスには、Microsoft Graph APIを介してアクセスします。 Microsoft Graph APIへの接続は、Workfront Fusion HTTP/OAuth 2.0 リクエストモジュールを使用して作成できます。
アクセス要件
| 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 ライセンスを参照してください。
Microsoft Application Registration PortalへのWorkfront Fusionの登録
Microsoft Graph REST APIへの接続を作成するには、まずAdobe Workfront Fusionを登録する必要があります。
-
新しいアプリケーションの登録を開始します(Microsoft ID プラットフォームへのアプリケーションの登録)。詳しくは、Microsoft ドキュメントを参照してください。
Microsoftを導入する際は、次の情報が必要です。
table 0-row-2 1-row-2 layout-auto html-authored no-header アプリケーション名 「My Workfront Fusion application」など、アプリケーションの名前を入力します。 リダイレクト URL https://app.workfrontfusion.com/oauth/cb/oauth2 -
アプリの登録が完了したら、アプリケーション IDをメモします。
note important IMPORTANT Workfront Fusionで接続を設定するには、アプリケーション IDが必要です。 -
クライアントシークレットを生成します。 このシークレットをメモしておいてください。
手順については、Microsoft ドキュメントの「Microsoft ID プラットフォームにアプリケーションを登録する」を参照してください。
note important IMPORTANT Workfront Fusionで接続を設定するには、クライアントシークレットが必要です。 -
アプリケーションの権限を設定します。
これらのフィールドの検索と設定について詳しくは、Microsoft ドキュメントの「Microsoft Graphに対する権限の設定」セクション「ユーザーなしでアクセスする」を参照してください。
table 0-row-2 1-row-2 layout-auto html-authored no-header アプリケーションにはどのような種類の権限が必要ですか? 「 Delegated permissions」を選択します。権限の選択 次の権限を選択します。
-
offline_access -
openid -
統合に必要なその他の権限(例:
User.Read)
重要: Workfront Fusionで接続を設定するには、選択した権限が必要です。
-
Workfront FusionでのMS Graph API接続の設定
「Workfront Application Registration PortalへのWorkfront Fusionの登録」で説明されているようにMicrosoft Fusionを登録した後、HTTP/Oauth 2.0 リクエストモジュールを作成で接続を設定できます。
-
HTTP/OAuth 2.0 コールモジュールをシナリオに追加します。
-
接続フィールドの横にある「追加」をクリックします。
-
接続フィールドを次のように設定します。
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 13-row-2 14-row-2 layout-auto html-authored no-header 接続名 接続に名前を入力します。 環境 実稼動用アカウントと非実稼動用アカウントのどちらに接続するかを選択します。 タイプ サービスアカウントと個人アカウントのどちらに接続するかを選択します。 フロータイプ 「 Authorization Code」を選択します。URIを認証 https://login.microsoftonline.com/common/oauth2/v2.0/authorizeと入力します。トークン URI https://login.microsoftonline.com/common/oauth2/v2.0/tokenと入力します。範囲 Microsoft Application Registration PortalへのWorkfront Fusionの登録で説明されているように、登録時に選択した権限を入力します。
各スコープについて、Addをクリックし、権限を入力します。
例:
offline_access。スコープ区切り記号 「 SPACE」を選択します。クライアント ID Microsoft Application Registration PortalへのWorkfront Fusionの登録の手順2のアプリケーション IDを入力します。 クライアントシークレット Microsoft Application Registration PortalへのWorkfront Fusionの登録の手順3で生成したクライアント秘密鍵を入力します。 パラメーターを承認 次の認証パラメーターを追加します。 追加する各パラメーターについて、「項目を追加」をクリックし、次の項目を入力します。
-
キー:
response_mode値:query -
キー:
prompt値:consent
アクセストークン パラメーター このフィールドには何も入力する必要はありません。 トークンパラメーターの更新 -
「項目を追加」をクリックします。
-
「 キー」フィールドに「
scope」と入力します。 -
「値」フィールドに、スコープフィールドに入力したすべてのスコープをスペースで区切って入力します。
例:
offline_access openid User.Read
カスタムヘッダー このフィールドには何も入力する必要はありません。 トークンの配置 In the header -
-
「続行」をクリックします。
-
表示されるウィンドウで、「確定」をクリックして接続を完了し、モジュールに戻ります。