Microsoft SharePoint Online モジュール

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

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 ライセンスを参照してください。

展開すると、Microsoft アカウントを使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続する手順が表示されます。

Microsoft アカウントを使用して、Microsoft SharePoint Onlineへの接続を作成できます。 Sharepoint アカウントをWorkfront Fusionに接続する手順については、Adobe Workfront Fusionへの接続の作成 – 基本手順を参照してください。

詳細な設定を使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続する手順を表示します。

接続に資格情報を含めるには、「詳細設定を表示」オプションを有効にします。 このタイプの接続には、クライアント ID、クライアント秘密鍵、およびテナント IDが必要です。

1. 任意のSharePoint モジュールで、Connection フィールドの近くの​ Add ​をクリックして、Create a connection ボックスを開きます。

2. 「詳細設定を表示」をクリックします。

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

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type	クライアントの資格情報を使用するには、Microsoft 365 Emailを選択します。
   Connection name	接続に名前を入力します。
   Client ID	接続先のSharePoint アプリのクライアント IDを入力します。
   Client secret	接続先のSharePoint アプリのクライアントシークレットを入力します。
   テナント ID	接続先のSharePoint アプリのテナント IDを入力します。

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

展開すると、証明書認証を使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続する手順が表示されます。

証明書認証を使用して、SharePointに接続できます。

note important
IMPORTANT
証明書の認証を使用するには、まずMicrosoft Entraでアプリを作成し、そこに証明書をアップロードする必要があります。
手順については、Microsoft ドキュメントの「Microsoft Entra証明書ベースの認証に対する証明機関の設定方法」を参照してください。

1. 任意のSharePoint モジュールで、Connection フィールドの近くの​ Add ​をクリックして、Create a connection ボックスを開きます。

2. 「詳細設定を表示」をクリックします。

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

   table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header
   Connection type	証明書認証を使用するには、Microsoft SharePoint Online （証明書認証） を選択します。
   Connection name	接続に名前を入力します。
   Client ID	接続先のSharePoint アプリのクライアント IDを入力します。
   Thumbprint	接続先のSharePoint アプリのサムプリントを入力します。
   Private key	資格情報がMicrosoftで作成されたときに生成された証明書または秘密鍵を入力します。 秘密鍵または証明書を抽出するには： Extract をクリックします。 証明書を抽出するか、秘密鍵を抽出するかを選択します。 抽出するファイルのタイプを選択します。 秘密鍵または証明書を含むファイルを選択します。 ファイルのパスワードを入力します。 Save をクリックしてファイルを抽出し、接続設定に戻ります。

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

サービスプリンシパルを使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続する手順を表示するには、を展開します。

個人アカウントの代わりにサービスプリンシパル（アプリケーション API接続）を使用する接続を作成できます。 これは、接続を特定のユーザーではなく、アプリケーションまたはサービス IDとして実行したい場合に便利です。例えば、そのユーザーが会社を辞めたり、パスワードを変更したりしても、統合が壊れることはありません。

note important
IMPORTANT
この接続タイプは、API呼び出しを作成 モジュールでのみ使用できます。 その他のSharePoint モジュールには、この記事で説明したその他の種類の接続が必要です。

• サービスプリンシパルを使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続するための前提条件
• Microsoft Entra IDでアプリ登録を作成する
• クライアントシークレットの作成
• API権限の付与
• 接続の詳細を収集
• 接続の作成

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

アプリを登録して権限を付与するには、Microsoft Entra IDで​グローバル管理者、アプリケーション管理者、または​ 特権ロール管理者 ​のアクセス権が必要です。 このアクセス権をお持ちでない場合は、IT チームまたはID チームの誰かに、これらの手順を完了するように依頼してください。

引き続きMicrosoft Entra IDでアプリ登録を作成します。

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

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

クライアントシークレットの作成（サービスプリンシパル）

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

API権限の付与（サービスプリンシパル）

1. アプリ登録で、API権限​に移動します。
2. 「権限を追加」を選択し、「Microsoft Graph」を選択します。
3. アプリケーション権限​を選択します。
4. API呼び出しに必要な権限または権限を選択し、権限を追加​を選択します。
5. 「組織に管理者の同意を付与する」を選択し、確認します。
6. 引き続き接続の詳細を収集してください。

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

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

table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header
テナント ID	概要ページで、 ディレクトリ （テナント） IDというラベルが付いています。
Client ID	概要ページに「 アプリケーション （クライアント） ID」というラベルが付いています。
Client Secret	でコピーした値は、クライアントシークレットを作成します。

引き続き接続を作成します。

接続の作成（サービスプリンシパル）

1. API呼び出しを行う モジュールで、接続フィールドの近くの​ 追加 ​をクリックして、接続を作成 ボックスを開きます。

2. 「詳細設定を表示」をクリックします。

3. 「接続タイプ ​」フィールドで、「サービスプリンシパル」を選択します。

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

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

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

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

フェデレーション接続を使用してMicrosoft SharePoint OnlineをAdobe Workfront Fusionに接続する手順を表示するには、こちらを参照してください。

フェデレーション接続は、クライアントシークレットを使用しない場合を除き、サービスプリンシパル接続と同様に機能します。
秘密鍵を保存する代わりに、Microsoft Entra IDに、Workfront Fusionが1つの特定の接続に対して問題を発生させるトークンを信頼するように指示します。 接続が実行されると、Fusionは短時間のみ有効なID証明を表示し、Microsoft Entra IDはアクセストークンを返します。 クライアントのシークレットはないので、有効期限が切れるものも、ローテーションや保存のためのシークレットもありません。

note
NOTE
この接続を設定するには、Microsoft Entra管理センターに2回訪問する必要があります。 最初にアプリを登録してから、Workfront Fusionで接続を作成し、次にMicrosoft Entra IDに戻ってフェデレーション資格情報を追加します。 これは、フェデレーション資格情報によって1つの特定の接続が識別され、その識別子は接続が作成されるまで存在しないためです。

• フェデレーション接続を使用してMicrosoft SharePoint OnlineをWorkfront Fusionに接続するための前提条件
• Microsoft Entra ID （Federated Connection）でのアプリ登録の作成
• API権限の付与（フェデレーション接続）
• 接続の詳細を収集する（フェデレーション接続）
• Workfront Fusion （フェデレーションコネクション）でのコネクションの作成
• Microsoft Entra IDにフェデレーション資格情報を追加する（フェデレーション接続）
• 接続の確認（フェデレーション接続）
• トラブルシューティング

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

アプリを登録し、権限を付与し、フェデレーション資格情報を追加するには、Microsoft Entra IDのグローバル管理者、アプリケーション管理者、または特権ロール管理者のアクセス権が必要です。 このアクセス権をお持ちでない場合は、IT チームまたはID チームの誰かに、これらの手順を完了するように依頼してください。

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

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

API権限の付与（フェデレーション接続）

1. アプリ登録で、API権限​に移動します。
2. 「権限を追加」を選択し、「Microsoft Graph」を選択します。
3. アプリケーション権限​を選択します。
4. API呼び出しに必要な権限または権限を選択し、権限を追加​を選択します。
5. 組織に対して​ 管理者の同意を付与 ​を選択し、確認します。
6. 引き続き接続の詳細を収集してください。

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

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

   table 0-row-2 1-row-2 layout-auto html-authored no-header
   テナント ID	概要ページで、 ディレクトリ （テナント） IDというラベルが付いています。
   Client ID	概要ページに「 アプリケーション （クライアント） ID」というラベルが付いています。

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

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

1. 「API呼び出しを作成」モジュールで、「接続」フィールドの近くにある「b」をクリックして、「接続を作成」ボックスを開きます。

2. （Federated connection）をクリックします。

3. 「接続タイプ」フィールドで、フェデレーション接続タイプを選択します。

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

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

5. 「作成」を選択します。
   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	この1つの接続を識別します。 fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964のようです。 作成する接続ごとに異なります。
   Audience	常にapi://AzureADTokenExchange。

6. このパネルを開いたままにして、件名​の値をコピーします。

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

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

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

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

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

2. 証明書と秘密鍵 > Federated credentials​に移動します。

3. 「資格情報を追加」を選択します。

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. 引き続き接続の確認を行います。

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

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

2. 「保存」を選択します。

   • すべてが正しく設定されている場合、接続は正常に検証され、モジュールの設定を続行できます。
   • 検証に失敗した場合、パネルは開いたままになり、エラーが表示されます。 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に表示されている件名と同じ文字の場合であることを確認してください。 別の接続からコピーされた被写体が最も一般的な原因です。
接続は検証されますが、API呼び出しは403を返します	IDは信頼されますが、アプリには呼び出しに必要なMicrosoft Graph権限がありません。 「API権限の付与」、「必要なアプリケーション権限の追加」、「管理者の同意の付与」に戻ります。
別のフェデレーション資格情報を追加することはできません	そのアプリ登録のフェデレーション資格情報が20件の上限に達しました。 追加のアプリを登録し、そのアプリに対してさらに接続を作成します。