기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
OneDrive 데이터 소스 연결
인증을 설정하고 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장한 후 지식 기반에 OneDrive 데이터 소스를 생성합니다. 이 페이지에서는 AWS Management Console 또는 API를 사용하여 데이터 소스를 생성한 다음 구성할 수 있는 커넥터 파라미터에 대한 참조를 생성하는 방법을 설명합니다.
참고
먼저 인증 설정을 완료합니다. 사용자 관리형 설정(3LO) (단순), OneDrive에 대한 Microsoft Entra 앱 ID 인증 설정 (문서 수준 액세스 제어에 권장됨) 또는 섹션을 참조하세요OneDrive에 대한 OAuth 2.0 인증 설정. 사용자 관리형 설정(3LO)의 경우 콘솔을 통해 로그인하면 Amazon Bedrock이 보안 암호를 생성합니다(시스템 생성 ARN 사용). 보안 암호 또는 테넌트 ID는 제공하지 않습니다. 다른 방법의 경우 보안 암호 ARN, 테넌트 ID 및 (문서 수준 액세스 제어용) 인증서의 Amazon S3 위치가 필요합니다.
데이터 소스 생성
커넥터 파라미터
데이터 소스 구성은 다음 커넥터 파라미터를 사용합니다. OneDrive에 연결하려면에서 커넥터 유형ONEDRIVE으로를 지정합니다connectorParameters. 래핑되는 필드connectorParameters(예: deletionProtectionConfiguration 및 mediaExtractionConfiguration)는 섹션을 참조하세요데이터 소스 연결.
| Field | 필수 | 설명 |
|---|---|---|
secretArn |
예 | OneDrive 자격 증명이 포함된 AWS Secrets Manager 보안 암호의 ARN입니다. |
tenantId |
예 | Microsoft Entra(Azure AD) 테넌트 ID입니다. |
authType |
예 | 인증 유형: MANAGED_OAUTH2 (사용자 관리형 설정, 3LO), ENTRA_APP_ID (권장) 또는 OAUTH2. 인증 방법을(를) 참조하세요. |
certificateS3Path |
조건부 | aclEnabled가 인 경우 필요합니다true(Microsoft Entra 앱 ID 인증). Amazon S3의 .p12 인증서 파일에 s3KeyName 대한 s3BucketName 및를 포함합니다. 콘텐츠 전용 크롤링 또는 에는 사용되지 않습니다OAUTH2. |
| Field | 필수 | 설명 |
|---|---|---|
crawlPersonalDrives |
아니요 | 사용자의 개인 드라이브를 크롤링할지 여부입니다. |
crawlSharedWithMe |
아니요 | 로그인한 사용자와 공유된 파일을 크롤링할지 여부입니다. OAUTH2 인증에서만 지원됩니다. Microsoft Entra 앱 ID(애플리케이션 전용) 인증은 공유 파일을 크롤링할 수 없습니다. |
참고
OneNote 노트북은 현재 지원되지 않습니다.
| Field | 필수 | 설명 |
|---|---|---|
inclusionUserEmailAddresses |
아니요 | 드라이브가 포함될 사용자 이메일 주소입니다. |
exclusionUserEmailAddresses |
아니요 | 제외할 드라이브가 있는 사용자 이메일 주소입니다. |
userFilterPath |
아니요 | 포함하거나 제외할 사용자를 나열하는 파일을 가리키는 Amazon S3 URL입니다. |
inclusionDriveItems |
아니요 | 포함할 항목 경로를 구동합니다. |
exclusionDriveItems |
아니요 | 제외할 드라이브 항목 경로입니다. |
includeMimeTypes |
아니요 | 포함할 MIME 유형입니다. |
excludeMimeTypes |
아니요 | 제외할 MIME 유형입니다. |
absoluteDateBefore |
아니요 | 이 날짜 이전에 수정된 콘텐츠만 포함합니다(ISO 8601). |
absoluteDateAfter |
아니요 | 이 날짜 이후에 수정된 콘텐츠만 포함합니다(ISO 8601). |
참고
OAUTH2 인증을 사용하면 커넥터가 로그인한 사용자의 위임된 컨텍스트에서 크롤링됩니다. 사용자 기반 필터(inclusionUserEmailAddresses, exclusionUserEmailAddresses, userFilterPath)는 커넥터가 시도하는 사용자의 드라이브를 결정하며, 로그인한 사용자가 액세스할 수 없는 드라이브는 자동으로 건너뜁니다. 권한에 관계없이 테넌트에서 모든 사용자의 OneDrive를 크롤링하려면 ENTRA_APP_ID 인증을 사용합니다.
| Field | 필수 | 설명 |
|---|---|---|
aclEnabled |
아니요 | 문서 수준 액세스 제어를 활성화true하려면 로 설정합니다. certificateS3Path에서 ENTRA_APP_ID 인증 및가 필요합니다connectionConfiguration. 데이터 소스를 생성한 후에는이 설정을 변경할 수 없습니다. 자세한 내용은 문서 수준 액세스 제어을 참조하세요. |
인증 방법 변경
UpdateDataSource 작업 또는를 사용하여 데이터 소스를 새 authType 및 자격 증명으로 업데이트하여 데이터 소스의 인증 방법(예: OAuth 2.0에서 Microsoft Entra 앱 ID로)을 변경할 수 있습니다 AWS Management Console. 문서 수준 액세스 제어 설정은 데이터 소스를 생성할 때 수정되므로 ACLs 추가하거나 제거하려면 새 데이터 소스를 생성해야 합니다.
다음 단계
데이터 소스를 생성한 후 이를 동기화하여 지식 기반에 콘텐츠를 수집합니다. 자세한 내용은 데이터 소스 동기화을 참조하세요. 사용자 권한별로 쿼리 결과를 필터링하려면 섹션을 참조하세요문서 수준 액세스 제어.