View a markdown version of this page

Microsoft SharePoint - Amazon Bedrock
サポートされている機能ユースケースと必要なアクセス許可認証方法前提条件SharePoint データソースをセットアップする方法

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Microsoft SharePoint

Microsoft SharePoint は、ドキュメント、ウェブページ、ウェブサイト、リストなどの作業をするための共同のウェブベースサービスです。SharePoint Online インスタンスをマネージドナレッジベースのデータソースとして接続して、1 つ以上の SharePoint サイトからファイルとページをクロールできます。

サポートされている機能

  • 複数の SharePoint サイトからファイルとページをクロールする

  • 一般的なドキュメントフィールド (タイトル、作成者、作成または変更された日付など) の自動検出

  • 項目パスと日付範囲を使用した包含コンテンツフィルター

  • 追加、更新、削除されたコンテンツの増分コンテンツ同期

  • Microsoft Entra ID App-Only および OAuth 2.0 認証

  • Microsoft Entra ID App-Only 認証を使用したドキュメントレベルのアクセスコントロール (ACLs)

ユースケースと必要なアクセス許可

コネクタに必要な Microsoft アクセス許可は、ユースケースによって異なります。ユースケースで呼び出されない限り、テナント全体の広範なアクセスを許可する必要はありません。コネクタは、選択したサイトのみへのアクセスを制限する最小特権設定をサポートしています。割り当てるアクセス許可は、次の 2 つの選択肢によって決まります。

  • クロールするサイト — 明示的に選択したサイト (Sites.Selected、最小特権オプション) またはテナント内のすべての SharePoint サイト (すべてのサイト) へのアクセスを許可します。

  • ドキュメントレベルのアクセスコントロール (ACLs) を有効にするかどうか — データソースがクエリ結果を各ユーザーの SharePoint アクセス許可でフィルタリングするかどうかを決定します。ACL クローリングには、追加の Microsoft Graph および SharePoint アクセス許可が必要です。

これらの選択肢は 4 つの一般的なユースケースにまとめられています。以下のアクセス許可は、推奨される Microsoft Entra ID App-Only 認証方法に適用されます。ユースケースにリストされているアクセス許可のみを付与します。コネクタは、Microsoft Graph (サイトを列挙するため、ACLs の場合はユーザーとグループを解決するため) と SharePoint REST API (サイトコンテンツを読み取るため、ACLsの場合は項目レベルのアクセス許可) の 2 つの Microsoft リソースを認証します。完全なセットアップ手順については、「」を参照してくださいSharePoint の Microsoft Entra ID アプリ専用認証を設定する。

ユースケースのタブを選択すると、割り当てる Microsoft Graph と SharePoint の正確なアクセス許可が表示されます。

Sites.Selected, no ACLs

各ユーザーの SharePoint アクセス許可でクエリ結果をフィルタリングせずに、選択した特定のサイトのみをクロールする場合に使用します。 SharePoint これは最小特権の設定です。

Sites.Selected、コンテンツのみ
API アクセス許可 目的
Microsoft Graph Sites.Selected 明示的に付与したサイトにのみアクセスします (Microsoft Graph)。
SharePoint Sites.Selected 明示的に付与するサイト (SharePoint REST) にのみアクセスします。サイトごとに readロールを付与します。
Sites.Selected, with ACLs

これは、選択した特定のサイトのみをクロールし、各ユーザーの SharePoint アクセス許可でクエリ結果をフィルタリングする場合に使用します。 SharePoint

Sites.Selected、ACLs付き
API アクセス許可 目的
Microsoft Graph Sites.Selected 明示的に付与したサイトにのみアクセスします (Microsoft Graph)。
Microsoft Graph User.Read.All ドキュメントレベルの ACLs。
Microsoft Graph GroupMember.Read.All ドキュメントレベルの ACLs。
SharePoint Sites.Selected 明示的に付与したサイトにのみアクセスします。サイトごとにfullcontrolロールを付与します (ACLs の項目レベルのアクセス許可を読み取るために必要です）。
All sites, no ACLs

これは、各ユーザーの SharePoint アクセス許可でクエリ結果をフィルタリングせずに、テナント内のすべての SharePoint サイトをクロールする場合に使用します。 SharePoint

すべてのサイト、コンテンツのみ
API アクセス許可 目的
Microsoft Graph Sites.Read.All すべての SharePoint サイトを列挙して読み取ります。
SharePoint Sites.Read.All SharePoint REST API を使用してサイトコンテンツを読み取ります。
All sites, with ACLs

これは、テナント内のすべての SharePoint サイトをクロールし、各ユーザーの SharePoint アクセス許可でクエリ結果をフィルタリングする場合に使用します。

ACLsを使用するすべてのサイト
API アクセス許可 目的
Microsoft Graph Sites.Read.All すべての SharePoint サイトを列挙して読み取ります。
Microsoft Graph User.Read.All ドキュメントレベルの ACLs。
Microsoft Graph GroupMember.Read.All ドキュメントレベルの ACLs。
SharePoint Sites.FullControl.All ACL クロールの項目レベルのアクセス許可を読み取り、クエリ時にアクセスを検証します。 Sites.Read.Allはこのチェックには不十分です。
注記

Sites.FullControl.All は、テナント内のすべてのサイトへの広範なアクセスを許可します。組織で最小特権が必要な場合は、 を使用しSites.Selected、サイトごとのアクセスを許可します。サイトごとの付与手順については、「」を参照してくださいSharePoint の Microsoft Entra ID アプリ専用認証を設定する。

認証方法

SharePoint データソースは 2 つの認証方法をサポートしています。開始する前に 1 つ選択します。これは、作成する認証情報と、ドキュメントレベルのアクセスコントロールを使用できるかどうかを決定するためです。新しいデータソースには、Microsoft Entra ID App-Only 認証をお勧めします。

SharePoint 認証方法
方法 認証方法 どのようなときに使うか セットアップ
Microsoft Entra ID アプリ専用 (ENTRA_ID_APP_ONLY) — 推奨 Microsoft Entra アプリケーションは証明書で認証します。ユーザー認証情報もインタラクティブサインインもありません。 ほとんどのデータソース、およびドキュメントレベルのアクセスコントロールを使用するデータソース。 Entra ID アプリ専用認証を設定する
OAuth 2.0 (OAUTH2_APP) アプリケーションクライアント ID とシークレット、およびクロールするサイトにアクセスできる Microsoft 365 ユーザーアカウントのユーザー名とパスワード (リソース所有者パスワード認証情報、または ROPC、フロー）。 Microsoft Entra ID App-Only 認証を使用できない場合にのみ を使用します。アカウントは MFA または条件付きアクセスを必要としません。ドキュメントレベルのアクセスコントロールではサポートされていません。 OAuth 2.0 認証を設定する
重要

OAUTH2_APP メソッドはユーザー名とパスワードでサインインするため、多要素認証 (MFA) チャレンジを完了したり、それを必要とする条件付きアクセスポリシーを満たすことはできません。アカウントが MFA または条件付きアクセスを強制する場合、認証は失敗し、データソースは同期できません。を使用する特定の理由がない限り、Microsoft Entra ID App-Only 認証を使用しますOAUTH2_APP。

前提条件

Microsoft SharePoint では、以下を確認してください。

  • クロールする SharePoint サイトの URLs を書き留めます。各 URL はクロールエントリポイントであり、 https://で始まり、サイト、チームサイト、または個人サイトを指す必要があります。パスは、/sites/、/teams/、またはサイト名 (https://yourdomain.sharepoint.com/sites/mysite など) の/personal/後に続く必要があります。標準*.sharepoint.comドメインとカスタム (バニティ) ドメインの両方がサポートされています。各サイト内では、コネクタはファイルとページをクロールします。データソースを接続するときに、項目パスフィルターを使用して特定の項目にクロールを絞り込むことができます。

  • Microsoft 365 のテナント ID をコピーします。テナント ID は、Microsoft Entra ポータルのプロパティにあります。詳細については、Microsoft Learn ウェブサイトの「Microsoft 365 テナント ID を検索する」を参照してください。

AWS アカウントで、以下を確認してください。

SharePoint データソースをセットアップする方法

SharePoint データソースのセットアップには、次のステップが含まれます。

  1. 認証を設定します。選択したメソッドのページに従って、Microsoft Entra アプリケーションを登録し、アクセス許可を設定し、認証情報を AWSSharePoint の Microsoft Entra ID アプリ専用認証を設定するまたは に保存しますSharePoint の OAuth 2.0 認証を設定する。

  2. データソースを接続します。 AWS Management Console または API を使用して、ナレッジベースに SharePoint データソースを作成します。「SharePoint データソースを接続する」を参照してください。

  3. (オプション) ドキュメントレベルのアクセスコントロールを有効にします。各ユーザーの SharePoint アクセス許可でクエリ結果をフィルタリングします。「ドキュメントレベルのアクセスコントロール」を参照してください。

セットアップまたは同期中に問題が発生した場合は、「」を参照してくださいSharePoint データソースのトラブルシューティング。