Azure DevOps モジュール

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

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

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

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

フェデレーション接続を使用してAzure DevOpsをAdobe Workfront Fusionに接続する手順を表示するには、を展開します。

note
NOTE
この接続を設定するには、Microsoft Entra管理センターに2回訪問する必要があります。 まずアプリを登録し、次にWorkfront Fusionで接続を作成します。その後、Microsoft Entra IDに戻ってフェデレーション資格情報を追加します。 これは、フェデレーション資格情報によって1つの特定の接続が識別され、その識別子は接続が作成されるまで存在しないためです。 この接続には、サービス プリンシパル接続と同じ制限が適用されます。 ユーザーライセンスの管理など、少数の管理者レベルのアクションでは、引き続き個人用アカウント接続が必要です。

• フェデレーション接続を使用してAzure DevOpsをWorkfront Fusionに接続するための前提条件
• Microsoft Entra ID （Federated Connection）でのアプリ登録の作成
• 接続の詳細を収集する（フェデレーション接続）
• Workfront Fusion （フェデレーションコネクション）でのコネクションの作成
• Microsoft Entra IDにフェデレーション資格情報を追加する
• 接続の確認（フェデレーション接続）

フェデレーション接続を使用してAzure DevOpsをWorkfront Fusionに接続するための前提条件

この接続を作成するには、次のものが必要です。

• Microsoft Entra IDのグローバル管理者またはアプリケーション管理者アクセス権。アプリを登録し、フェデレーション資格情報を追加します。 このアクセス権をお持ちでない場合は、IT チームまたはID チームの誰かに、これらの手順を完了するように依頼してください。
• Azure DevOps組織のプロジェクトコレクション管理者アクセス権を取得し、サービスプリンシパルをメンバーとして追加します。 これは、多くの場合、Microsoft Entra IDを管理する人とは異なる人物です。
• Azure DevOps組織の名前。 AzureのDevOps URL: dev.azure.com/<your organization name>で確認できます。

Microsoft Entra ID （Federated Connection）でのアプリ登録の作成

1. Microsoft Entra管理センターにログインします。
2. アプリ登録/新規登録に移動します。
3. アプリに明確で認識可能な名前を付けます。 例：Workfront Fusion Azure DevOps Integration
4. リダイレクト URIを空白のままにします。 この接続には、ブラウザーを介したログインは含まれません。
5. 「登録」を選択します。
6. クライアントシークレットを作成しないでください。 フェデレーション接続では1つは使用されません。
7. 引き続き接続の詳細を収集してください。

接続の詳細を収集する（フェデレーション接続）

1. アプリ登録の概要ページで、次の値に注意してください。 モジュールで接続を作成する際に、これらの項目を入力します。

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   テナント ID	概要ページで、 ディレクトリ （テナント） IDというラベルが付いています。
   Client ID	概要ページに「 アプリケーション （クライアント） ID」というラベルが付いています。
   Organization	Azure DevOps組織名。 例えば、URLがdev.azure.com/yourorgの場合は、yourorgと入力します。

2. 引き続きWorkfront Fusionで接続を作成します。

note
NOTE
サービスプリンシパル接続と同様に、アプリ登録のAPI権限領域をスキップできます。 Azure DevOpsへのアクセスは、次の手順でAzure DevOps内で許可されます。

Workfront Fusion （フェデレーションコネクション）でのコネクションの作成

1. モジュールの接続設定画面で、フェデレーション接続タイプを選択します。

2. 以下の情報を入力します。

   • テナント ID
   • クライアント ID
   • 組織

3. 「作成」を選択します。

   Workfront Fusionには3つの値が表示されます。 このページは開いたままにしておきます。接続を作成する過程で、後でこれらの値が必要になるからです。

   table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
   イシュア ​	https://oidc.automations.adobe.com.
   Subject	これはこの接続を識別します。 fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964のようです。 作成する接続ごとに異なります。
   Audience	api://AzureADTokenExchange.

   note important
   IMPORTANT
   パネルを閉じたり、「キャンセル」を選択したりしないでください。 この手順の残りの部分が完了するまで、接続は完了しません。 パネルを閉じた場合は、新しい接続が新しい件名を受信するので、接続を削除して再度開始する必要があります。

4. 件名​の値をコピーします。

5. 引き続きMicrosoft Entra IDでフェデレーション資格情報を追加します。

Microsoft Entra IDにフェデレーション資格情報を追加する

この手順は、クライアントシークレットに代わるものです。 これは、Microsoft Entra IDに対して、Workfront Fusionがこの1つの接続に対して発行するトークンを受け入れるように指示します。

1. 新しいブラウザータブで、Microsoft Entra管理センターに戻り、アプリ登録を開きます。

2. 証明書と秘密鍵/フェデレーション認証情報に移動します。

3. 「Add credential」を選択します。

4. 「フェデレーション資格情報シナリオ」で、「その他のイシュア」を選択します。

5. 以下の情報を入力します。

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   イシュア ​	https://oidc.automations.adobe.com
   Subject IDENTIFIER	Workfront Fusionからコピーした被写体。 スペースを追加せずに、正確にペーストします。
   Name	後で見つけられるように、この接続を識別する名前。 例：workfront-fusion-connection-28964
   Audience	api://AzureADTokenExchange. これは通常、あなたのために記入されます。 デフォルト値のままにします。

6. 「追加」をクリックします。

7. 引き続き接続の確認を行います。

note
NOTE
Microsoft Entra IDでは、1つのアプリ登録に対して最大20個のフェデレーション資格情報を使用でき、件名の識別子は正確に一致する必要があります。 ワイルドカードはサポートされていません。 Workfront Fusionの各コネクションには独自のサブジェクトがあるため、各コネクションには独自のフェデレーション資格情報が必要です。 20以上の接続が必要な場合は、複数のアプリを登録し、それらのアプリ間に接続を広げます。

接続の確認（フェデレーション接続）

1. Workfront Fusion ブラウザータブに戻ります。接続パネルはまだ開いています。

2. 「保存」をクリックします。

   • すべてが正しく設定されている場合、接続は正常に検証され、モジュールの設定を続行できます。
   • 検証に失敗した場合、パネルは開いたままになり、エラーが表示されます。 Microsoft Entra IDまたはAzure DevOpsの問題を修正し、「保存」をもう一度選択します。 接続を再作成する必要はなく、被写体は変更されません。

note
NOTE
Microsoft Entra IDに追加したフェデレーション資格情報は、アクティブになるまでに短い時間がかかる場合があります。 資格情報を追加した直後に検証が失敗した場合は、少し待ってから「保存」をもう一度選択してから調査します。

トラブルシューティング

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
接続が無効なクライアントまたは無効な要求エラーで検証に失敗します	Microsoft Entra IDは、トークンとフェデレーション資格情報を一致させることができませんでした。 イシュアが末尾にスラッシュを含まない正確なhttps://oidc.automations.adobe.comであること、および件名IDがWorkfront Fusionに表示されている件名と同じ文字の場合であることを確認してください。 別の接続からコピーされた被写体が最も一般的な原因です。
接続は検証されますが、Azure DevOpsから401または403が返されます	このIDは信頼されていますが、Azure DevOps データにはアクセスできません。 サービスプリンシパルをAzure DevOps組織に追加し、そのサービスプリンシパルがモジュールが使用する特定のプロジェクトに割り当てられていることを確認します。
別のフェデレーション資格情報を追加することはできません	そのアプリ登録のフェデレーション資格情報が20件の上限に達しました。 追加のアプリを登録し、そのアプリに対してさらに接続を作成します。

EntraAppを使用してAzure DevOpsをWorkfront Fusionに接続する手順を表示するには、展開します

1. Azure DevOps モジュールをシナリオに追加します。

2. 「接続」フィールドの横にある「追加」をクリックします。

3. 「接続タイプ ​」フィールドで、使用する接続タイプを選択します。

   note
   NOTE
   Azure DevOps （EntraApp） ​を使用すると、接続のすべてのスコープをリクエストできます。

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

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection name	作成する接続の名前を入力します。
   Organization	Azure DevOps アプリケーションを作成した組織の名前を入力します。
   App ID	接続先のDevOps アプリケーションのIDを入力します。
   Client Secret	接続先のDevOps アプリケーションのクライアントシークレットを入力します。
   すべてのスコープをリクエスト ​	Azure DevOps （EntraApp）接続タイプを使用している場合は、このオプションを有効にして、接続のすべてのスコープを要求します。

5. Azure DevOps アプリ IDまたはクライアントシークレットを入力するには、詳細設定を表示をクリックし、開いているフィールドに入力します。

6. 「続行」をクリックして接続の設定を終了し、シナリオの作成を続けます。

展開すると、サービスプリンシパルを使用してAzure DevOpsをAdobe Workfront Fusionに接続する手順が表示されます。

note
NOTE
サービスプリンシパル認証は、すべてのAzure DevOps機能をサポートしているわけではありません。 ユーザーライセンスの管理など、少数の管理者レベルのアクションでは、引き続き個人用アカウント接続が必要です。 作業項目、ボード、リポジトリ、またはパイプラインに対してのみ必要な場合は、サービスプリンシパル認証を使用します。

• サービスプリンシパルを使用してAzure DevOpsをWorkfront Fusionに接続するための前提条件
• Microsoft Entra IDでアプリ登録を作成する
• クライアントシークレットの作成
• 接続の詳細を収集
• Azure DevOps組織にサービスプリンシパルを追加します
• 接続の作成

サービスプリンシパルを使用してAzure DevOpsをWorkfront Fusionに接続するための前提条件

この接続を作成するには、次のものが必要です。

• グローバル管理者​または​ アプリケーション管理者 ​がMicrosoft Entra IDでアクセスし、アプリを登録します。 このアクセス権をお持ちでない場合は、IT チームまたはID チームの誰かにその手順を完了するように依頼してください。
• Project Collection Administrator​は、Azure DevOps組織でアクセスし、サービスプリンシパルをメンバーとして追加します。 これは、多くの場合、Microsoft Entra IDを管理する人とは異なる人物です。
• Azure DevOps組織の名前。 AzureのDevOps URL: dev.azure.com/<your organization name>で確認できます。

Microsoft Entra ID （サービスプリンシパル）でのアプリ登録の作成

1. Microsoft Entra管理センターにログインします。
2. アプリ登録 > 新規登録​に移動します。
3. アプリに明確で認識可能な名前を付けます。 例：Workfront Fusion Azure DevOps Integration
4. リダイレクト URI​を空白のままにします。 この接続には、ブラウザーを介したログインは含まれません。
5. 登録​を選択します。
6. 引き続き​ クライアントシークレットの作成を続行します。

クライアントシークレットの作成

1. 新しいアプリの登録で、証明書とシークレット​に移動します。
2. 新しいクライアントシークレット​を選択し、説明を追加して、有効期限を選択します。
3. 「追加」を選択します。
4. 秘密鍵の​ 値 ​をすぐにコピーします。 1回だけ表示されます。 コピーする前に移動する場合は、新しいコピーを作成する必要があります。
5. 引き続き接続の詳細を収集してください。

接続の詳細を収集する（サービスプリンシパル）

1. アプリ登録の​概要 ページから、次の値に注意してください。 モジュールで接続を作成する際に、これらの項目を入力します。

   table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
   テナント ID	概要ページで、 ディレクトリ （テナント） IDというラベルが付いています。
   Client ID	概要ページに「 アプリケーション （クライアント） ID」というラベルが付いています。
   Client Secret	でコピーした値は、クライアントシークレットを作成します。
   Organization	Azure DevOps組織名。 例えば、URLがdev.azure.com/yourorgの場合は、yourorgと入力します。

   note
   NOTE
   アプリ登録の​ API権限 ​領域をスキップできます。 そこにAzure DevOpsを追加した場合、委任された権限​のみが使用できます。 アプリケーション権限​がグレー表示されます。 Azure DevOpsでは、この方法でのアクセス許可はサポートされていないため、これは予想されます。 代わりに、次のパートでAzure DevOps内で直接アクセスが許可されます。

2. 引き続きAzure DevOps組織にサービスプリンシパルを追加。

Azure DevOps組織にサービスプリンシパルを追加します

Microsoft Entra IDにアプリを登録すると、そのIDのみが作成されます。 Azure DevOps データへのアクセス権はまだアプリに付与されません。 この手順により、そのアクセス権が付与されます。

1. Azure DevOps組織（dev.azure.com/<your organization name>）にログインします。

2. 左下の「組織の設定」を選択し、「ユーザー」を選択します。

3. 「ユーザーを追加」を選択します。

4. 検索ボックスで、アプリの表示名（アプリ登録時に指定した名前）で検索します。 クライアント IDで検索しないでください。

5. アクセスレベルを選択します。

   • Basic​は、通常、作業項目、ボード、リポジトリの読み取りと書き込みに十分です。
   • ワークフローで、セットアップの一環としてアジャイル、スクラム、カスタムテンプレートなどの利用可能なプロセスを参照する必要がある場合は、代わりに​プロジェクトコレクション管理者 グループにサービスプリンシパルを追加します。 より幅広いレベルのアクセス権を持つため、その機能が必要な場合にのみ許可してください。

6. 組織の通常のアクセス方法に従って、必要な特定のプロジェクトまたはプロジェクトにサービスプリンシパルを割り当てます。

7. 「追加」を選択します。

8. 引き続きWorkfront Fusionで接続を作成します。

Workfront Fusion （サービスプリンシパル）でコネクションを作成する

1. モジュールの接続設定画面で、サービスプリンシパル​接続タイプを選択します。

2. 以下の情報を入力します。

   • ​ テナント ID
   • クライアント ID
   • クライアント秘密鍵
   • 組織

3. 接続を保存します。

   すべてが正しく設定されていれば、接続は正常に検証されます。