Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Connect sumber OneDrive data
Setelah Anda mengatur otentikasi dan menyimpan kredensyal Anda secara AWS Secrets Manager rahasia, buat sumber OneDrive data di basis pengetahuan Anda. Halaman ini menjelaskan cara membuat sumber data dengan Konsol Manajemen AWS atau API, diikuti dengan referensi untuk parameter konektor yang dapat Anda konfigurasi.
**catatan**
Selesaikan pengaturan otentikasi terlebih dahulu. Lihat [Mengatur otentikasi Microsoft Entra App ID untuk OneDrive](kb-managed-onedrive-entra-setup.md) (disarankan) atau[Siapkan otentikasi OAuth 2.0 untuk OneDrive](kb-managed-onedrive-oauth2-setup.md). Anda memerlukan ARN rahasia, ID penyewa Anda, dan (untuk kontrol akses tingkat dokumen) lokasi Amazon S3 sertifikat Anda.
## Buat sumber data
------
#### [ Console ]
**Untuk terhubung OneDrive ke basis pengetahuan terkelola**
1. Di bawah **Sumber data**, berikan nama untuk sumber data Anda.
1. Pilih **OneDrive**dari dropdown sumber data.
1. Di bawah **Sumber**, masukkan **ID OneDrive Penyewa** Anda.
1. Di bawah **Otentikasi**, pilih **Microsoft Entra ID App** atau otentikasi **OAuth 2.0**.
1. Pilih atau buat AWS Secrets Manager rahasia untuk menyimpan kredensyal Anda.
1. (Opsional) Untuk mengaktifkan kontrol akses tingkat dokumen, pilih **Kontrol akses dokumen dengan ACL** dan berikan **jalur Sertifikat — jalur** Amazon S3 ke file sertifikat Anda. `.p12` Opsi ini hanya tersedia dengan otentikasi Microsoft Entra ID App dan tidak dapat diubah setelah pembuatan. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-onedrive-acl.md).
1. (Opsional) Perluas **cakupan Sinkronisasi** untuk memilih konten mana yang akan dirayapi. Dengan otentikasi Microsoft Entra ID App, hanya drive pribadi yang dapat dirayapi.
1. (Opsional) Perluas **email Pengguna** untuk menambahkan email tertentu dari pengguna yang datanya ingin Anda sertakan atau kecualikan.
1. (Opsional) Perluas **filter jalur File** untuk menyertakan atau mengecualikan file dan folder tertentu.
1. (Opsional) Perluas pola **regex tipe Mime untuk menambahkan pola** regex untuk menyertakan atau mengecualikan tipe MIME tertentu.
1. (Opsional) Perluas **sinkronisasi entitas berbasis Tanggal** untuk menentukan filter tanggal.
------
#### [ API ]
Untuk membuat sumber OneDrive data, kirim [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html)permintaan dengan titik akhir waktu pembuatan Agen untuk Amazon Bedrock. AWS Command Line Interface Contoh berikut membuat sumber data yang menggunakan otentikasi Microsoft Entra App ID. Untuk mengaktifkan kontrol akses tingkat dokumen, setel `aclEnabled` ke `true` dan tambahkan ke. `certificateS3Path` `connectionConfiguration` Untuk deskripsi setiap bidang, lihat referensi parameter konektor berikut.
```
aws bedrock-agent create-data-source \
--name "{{OneDrive-connector}}" \
--knowledge-base-id "{{your-knowledge-base-id}}" \
--data-source-configuration file://onedrive-managed-connector.json
```
`onedrive-managed-connector.json`File tersebut berisi yang berikut:
```
{
"type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
"managedKnowledgeBaseConnectorConfiguration": {
"connectorParameters": {
"type": "ONEDRIVE",
"version": "1",
"aclEnabled": false,
"connectionConfiguration": {
"secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-onedrive-creds}}",
"tenantId": "{{12345678-1234-1234-1234-123456789012}}",
"authType": "ENTRA_APP_ID"
},
"dataEntityConfiguration": {
"crawlPersonalDrives": true
}
}
}
}
```
Untuk mengaktifkan kontrol akses tingkat dokumen, setel ke `true` dan tambahkan `aclEnabled` ke: `certificateS3Path` `connectionConfiguration`
```
{
"type": "ONEDRIVE",
"version": "1",
"aclEnabled": true,
"connectionConfiguration": {
"secretArn": "{{arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-onedrive-creds}}",
"tenantId": "{{12345678-1234-1234-1234-123456789012}}",
"authType": "ENTRA_APP_ID",
"certificateS3Path": {
"s3BucketName": "{{your-certificate-bucket}}",
"s3KeyName": "{{certs/certificate.p12}}"
}
},
"dataEntityConfiguration": {
"crawlPersonalDrives": true
}
}
```
Untuk sumber `OAUTH2` data, atur `authType` ke `OAUTH2` dan hilangkan`certificateS3Path`.
Untuk basis pengetahuan terkelola, `CreateDataSource` asinkron: transisi status sumber data dari `CREATING` ke `AVAILABLE` saat operasi selesai.
------
## Parameter konektor
Konfigurasi sumber data menggunakan parameter konektor berikut. Untuk terhubung OneDrive, tentukan `ONEDRIVE` sebagai tipe konektor di`connectorParameters`. Untuk bidang yang membungkus `connectorParameters` (seperti `deletionProtectionConfiguration` dan`mediaExtractionConfiguration`), lihat[Connect sumber data](kb-managed-connect-ds.md).
**ConnectionConfiguration**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| secretArn | Ya | ARN AWS Secrets Manager rahasia yang berisi kredensialmu OneDrive . |
| tenantId | Ya | ID penyewa Microsoft Entra (Azure AD). |
| authType | Ya | Jenis otentikasi: ENTRA\_APP\_ID (disarankan) atauOAUTH2. Lihat [Metode autentikasi](kb-managed-ds-onedrive.md#kb-managed-onedrive-auth-methods). |
| certificateS3Path | Bersyarat | Diperlukan saat aclEnabled ini true (otentikasi ID Aplikasi Microsoft Entra). Berisi s3BucketName dan s3KeyName untuk file .p12 sertifikat di Amazon S3. Tidak digunakan untuk perayapan konten saja atau dengan. OAUTH2 |
**data EntityConfiguration**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| crawlPersonalDrives | Tidak | Apakah akan merayapi drive pribadi pengguna. |
| crawlSharedWithMe | Tidak | Apakah akan merayapi file yang dibagikan dengan pengguna yang masuk. Hanya didukung dengan OAUTH2 otentikasi. Otentikasi Microsoft Entra App ID (khusus aplikasi) tidak dapat merayapi file bersama. |
**catatan**
OneNote notebook saat ini tidak didukung.
**FilterConfiguration (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| inclusionUserEmailAddresses | Tidak | Alamat email pengguna yang drive-nya disertakan. |
| exclusionUserEmailAddresses | Tidak | Alamat email pengguna yang drive-nya dikecualikan. |
| userFilterPath | Tidak | URL Amazon S3 yang menunjuk ke file yang mencantumkan pengguna untuk disertakan atau dikecualikan. |
| inclusionDriveItems | Tidak | Dorong jalur item untuk disertakan. |
| exclusionDriveItems | Tidak | Dorong jalur item untuk dikecualikan. |
| includeMimeTypes | Tidak | Jenis MIME untuk disertakan. |
| excludeMimeTypes | Tidak | Jenis MIME untuk dikecualikan. |
| absoluteDateBefore | Tidak | Hanya sertakan konten yang dimodifikasi sebelum tanggal ini (ISO 8601). |
| absoluteDateAfter | Tidak | Hanya sertakan konten yang dimodifikasi setelah tanggal ini (ISO 8601). |
**catatan**
Dengan `OAUTH2` autentikasi, konektor akan dirayapi dalam konteks delegasi pengguna yang masuk. Filter berbasis pengguna (`inclusionUserEmailAddresses`,`exclusionUserEmailAddresses`,`userFilterPath`) menentukan drive pengguna mana yang mencoba konektor; drive yang tidak dapat diakses pengguna yang masuk dilewati secara diam-diam. Untuk merayapi setiap pengguna OneDrive di penyewa Anda terlepas dari izin, gunakan autentikasi. `ENTRA_APP_ID`
**ACLENabled (opsional)**
| Bidang | Diperlukan | Deskripsi |
| --- | --- | --- |
| aclEnabled | Tidak | Setel true untuk mengaktifkan kontrol akses tingkat dokumen. Membutuhkan ENTRA\_APP\_ID otentikasi dan certificateS3Path masukconnectionConfiguration. Anda tidak dapat mengubah pengaturan ini setelah Anda membuat sumber data. Lihat perinciannya di [Document-level kontrol akses](kb-managed-ds-onedrive-acl.md). |
## Ubah metode otentikasi
Anda dapat mengubah metode autentikasi sumber data (misalnya, dari OAuth 2.0 ke Microsoft Entra App ID) dengan memperbarui sumber data dengan yang baru `authType` dan kredensyal, menggunakan operasi atau. [UpdateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateDataSource.html) Konsol Manajemen AWS Pengaturan kontrol akses tingkat dokumen diperbaiki saat Anda membuat sumber data, jadi untuk menambah atau menghapus ACL, Anda harus membuat sumber data baru.
## Langkah selanjutnya
Setelah Anda membuat sumber data, sinkronkan untuk mencerna konten ke basis pengetahuan Anda. Lihat perinciannya di [Sinkronkan sumber data](kb-managed-sync.md). Untuk memfilter hasil kueri berdasarkan izin pengguna, lihat[Document-level kontrol akses](kb-managed-ds-onedrive-acl.md).