翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
OneDrive データソースを接続する
認証を設定し、認証情報を AWS Secrets Manager シークレットに保存したら、ナレッジベースに OneDrive データソースを作成します。このページでは、 AWS マネジメントコンソール または API を使用してデータソースを作成し、次に設定できるコネクタパラメータのリファレンスを作成する方法について説明します。
注記
最初に認証のセットアップを完了します。OneDrive の Microsoft Entra App ID 認証を設定する 「(推奨)」または「」を参照してくださいOneDrive の OAuth 2.0 認証を設定する。シークレット ARN、テナント ID、および証明書の Amazon S3 の場所 (ドキュメントレベルのアクセスコントロールの場合) が必要です。
データソースを作成する
コネクタパラメータ
データソース設定では、次のコネクタパラメータを使用します。OneDrive に接続するには、 でコネクタタイプONEDRIVEとして を指定しますconnectorParameters。ラップするフィールド connectorParameters ( deletionProtectionConfigurationや などmediaExtractionConfiguration) については、「」を参照してくださいデータソースを接続する。
| フィールド | 必要 | 説明 |
|---|---|---|
secretArn |
はい | OneDrive 認証情報を含む AWS Secrets Manager シークレットの ARN。 |
tenantId |
はい | Microsoft Entra (Azure AD) テナント ID。 |
authType |
はい | 認証タイプ: ENTRA_APP_ID (推奨) または OAUTH2。「認証方法」を参照してください。 |
certificateS3Path |
条件付き | aclEnabled が true (Microsoft Entra App ID 認証) の場合は必須です。Amazon S3 s3KeyNameの.p12証明書ファイルの s3BucketNameと が含まれます。 Amazon S3 コンテンツのみのクローリングや では使用できませんOAUTH2。 |
| フィールド | 必要 | 説明 |
|---|---|---|
crawlPersonalDrives |
いいえ | ユーザーの個人用ドライブをクロールするかどうか。 |
crawlSharedWithMe |
いいえ | サインインしたユーザーと共有されているファイルをクロールするかどうか。OAUTH2 認証でのみサポートされます。Microsoft Entra App ID (アプリケーションのみ) 認証では、共有ファイルをクロールできません。 |
注記
OneNote ノートブックは現在サポートされていません。
| フィールド | 必要 | 説明 |
|---|---|---|
inclusionUserEmailAddresses |
いいえ | ドライブを含めるユーザーの E メールアドレス。 |
exclusionUserEmailAddresses |
いいえ | ドライブを除外するユーザーの E メールアドレス。 |
userFilterPath |
いいえ | 含めるまたは除外するユーザーを一覧表示するファイルを指す Amazon S3 URL。 |
inclusionDriveItems |
いいえ | 含める項目パスを駆動します。 |
exclusionDriveItems |
いいえ | 除外する項目パスを駆動します。 |
includeMimeTypes |
いいえ | 含める MIME タイプ。 |
excludeMimeTypes |
いいえ | 除外する MIME タイプ。 |
absoluteDateBefore |
いいえ | この日付より前に変更されたコンテンツのみを含めます (ISO 8601)。 |
absoluteDateAfter |
いいえ | この日付以降に変更されたコンテンツのみを含めます (ISO 8601)。 |
注記
OAUTH2 認証では、コネクタはサインインユーザーの委任コンテキストでクロールします。ユーザーベースのフィルター (inclusionUserEmailAddresses、exclusionUserEmailAddresses、userFilterPath) は、コネクタが試行するユーザーのドライブを決定します。サインインしたユーザーがアクセスできないドライブは、サイレントにスキップされます。アクセス許可に関係なく、テナント内のすべてのユーザーの OneDrive をクロールするには、ENTRA_APP_ID認証を使用します。
| フィールド | 必要 | 説明 |
|---|---|---|
aclEnabled |
いいえ | ドキュメントレベルのアクセスコントロールを有効にするtrueには、 に設定します。certificateS3Path でENTRA_APP_ID認証と が必要ですconnectionConfiguration。データソースの作成後にこの設定を変更することはできません。詳細については、「ドキュメントレベルのアクセスコントロール」を参照してください。 |
認証方法を変更する
UpdateDataSource オペレーションまたは を使用して、新しい authTypeおよび 認証情報でデータソースを更新することで、データソースの認証方法 (OAuth 2.0 から Microsoft Entra App ID など) を変更できます AWS マネジメントコンソール。ドキュメントレベルのアクセスコントロール設定は、データソースの作成時に修正されるため、ACLs を追加または削除するには、新しいデータソースを作成する必要があります。
次の手順
データソースを作成したら、同期してコンテンツをナレッジベースに取り込みます。詳細については、「データソースを同期する」を参照してください。ユーザーアクセス許可でクエリ結果をフィルタリングするには、「」を参照してくださいドキュメントレベルのアクセスコントロール。