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

# Microsoft SharePoint
<a name="kb-managed-ds-sharepoint"></a>

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

## サポートされている機能
<a name="kb-managed-supported-features-sharepoint"></a>
+ 複数の SharePoint サイトからファイルとページをクロールする
+ 一般的なドキュメントフィールド (タイトル、作成者、作成または変更された日付など) の自動検出
+ 項目パスと日付範囲を使用した包含コンテンツフィルター
+ 追加、更新、削除されたコンテンツの増分コンテンツ同期
+ ユーザー管理 (3LO)、Microsoft Entra ID App-Only、および OAuth 2.0 認証
+ Microsoft Entra ID アプリ専用認証を使用したドキュメントレベルのアクセスコントロール (ACLs)

## ユースケースと必要なアクセス許可
<a name="kb-managed-sharepoint-use-cases"></a>

コネクタに必要な 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 アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)。

ユースケースのタブを選択すると、割り当てる 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 アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)。

## 認証方法
<a name="kb-managed-sharepoint-auth-methods"></a>

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


**SharePoint 認証方法**  

| 方法 | 認証方法 | どのようなときに使うか | セットアップ | 
| --- | --- | --- | --- | 
| ユーザー管理 (3LO) (MANAGED\_OAUTH2) | SharePoint に直接サインインして接続を承認すると、Amazon Bedrock Managed Knowledge Base が認証を処理します。これは最も簡単な開始方法です。 | ドキュメントレベルのアクセスコントロールが不要な場合は、すぐに開始できます。ドキュメントレベルのアクセスコントロールではサポートされていません。 | [ユーザー管理のセットアップ (3LO)](kb-managed-sharepoint-3lo-setup.md) | 
| Microsoft Entra ID アプリ専用 (ENTRA\_ID\_APP\_ONLY) — 推奨 | Microsoft Entra アプリケーションは証明書を使用して認証します。ユーザー認証情報もインタラクティブサインインもありません。 | ほとんどのデータソース、およびドキュメントレベルのアクセスコントロールを使用するデータソース。 | [Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md) | 
| OAuth 2.0 (OAUTH2\_APP) | アプリケーションクライアント ID とシークレット、およびクロールするサイトにアクセスできる Microsoft 365 ユーザーアカウントのユーザー名とパスワード (リソース所有者パスワード認証情報、または ROPC、フロー）。 | Microsoft Entra ID App-Only 認証を使用できない場合にのみ を使用します。アカウントは MFA または条件付きアクセスを必要としません。ドキュメントレベルのアクセスコントロールではサポートされていません。 | [OAuth 2.0 認証を設定する](kb-managed-sharepoint-oauth2-setup.md) | 

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

## 前提条件
<a name="kb-managed-prereqs-sharepoint"></a>

**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](https://learn.microsoft.com/en-us/sharepoint/find-your-office-365-tenant-id) を検索する」を参照してください。

** AWS アカウントで、以下を確認してください**。
+ 認証の認証情報を[AWS Secrets Manager シークレット](https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_secret.html)に保存し、シークレットの Amazon リソースネーム (ARN) を書き留めます。
+ シークレットに保存される正確なキーと値のペアについては、認証方法の設定ページ「」または「」を参照してください[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)[SharePoint の OAuth 2.0 認証を設定する](kb-managed-sharepoint-oauth2-setup.md)。
+ ナレッジベースの AWS Identity and Access Management (IAM) ロール/アクセス許可ポリシーに、データソースに接続するために必要なアクセス許可を含めます。必要なアクセス許可の詳細については、「」を参照してください[データソースにアクセスするためのアクセス許可](kb-permissions.md#kb-permissions-access-ds)。

## SharePoint データソースをセットアップする方法
<a name="kb-managed-sharepoint-workflow"></a>

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

1. **認証を設定します。**選択したメソッドのページに従います。ユーザー管理のセットアップ (3LO) では、SharePoint に直接サインインします。「」を参照してください[ユーザー管理のセットアップ (3LO)](kb-managed-sharepoint-3lo-setup.md)。その他の方法については、Microsoft Entra アプリケーションを登録し、アクセス許可を設定し、認証情報を に保存します。[SharePoint の Microsoft Entra ID アプリ専用認証を設定する](kb-managed-sharepoint-entra-setup.md)「」または AWS 「」を参照してください[SharePoint の OAuth 2.0 認証を設定する](kb-managed-sharepoint-oauth2-setup.md)。

1. **データソースを接続します。** AWS マネジメントコンソール または API を使用して、ナレッジベースに SharePoint データソースを作成します。「[SharePoint データソースを接続する](kb-managed-ds-sharepoint-connect.md)」を参照してください。

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

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