Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# OneDrive Konektor Microsoft V1.0
Microsoft OneDrive adalah layanan penyimpanan berbasis cloud yang dapat Anda gunakan untuk menyimpan, berbagi, dan meng-host konten Anda. Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber OneDrive data Microsoft Anda.
**catatan**
Support untuk OneDrive konektor V1.0/Microsft OneDrive API dijadwalkan berakhir pada Juni 2023. Kami merekomendasikan menggunakan OneDrive konektor V2.0/ TemplateConfiguration API.
Untuk memecahkan masalah konektor sumber Amazon Kendra OneDrive data Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md)
**Topics**
+ [
## Fitur yang didukung
](#supported-features-v1-onedrive)
+ [
## Prasyarat
](#prerequisites-v1-onedrive)
+ [
## Instruksi koneksi
](#data-source-v1-procedure-onedrive)
## Fitur yang didukung
+ Pemetaan bidang
+ Filter inklusi/pengecualian
## Prasyarat
Sebelum dapat digunakan Amazon Kendra untuk mengindeks sumber OneDrive data Anda, buat perubahan ini di akun OneDrive dan AWS akun Anda.
**Di Azure Active Directory (AD) Anda, pastikan Anda memiliki:**
+ Membuat aplikasi Azure Active Directory (AD).
+ Menggunakan ID aplikasi AD untuk mendaftarkan kunci rahasia untuk aplikasi di situs AD. Kunci rahasia harus berisi ID aplikasi dan kunci rahasia.
+ Menyalin domain AD organisasi.
+ Menambahkan izin aplikasi berikut ke aplikasi AD Anda pada opsi Microsoft Graph:
+ Baca file di semua koleksi situs (File.Read.All)
+ Membaca profil lengkap semua pengguna (User.Read.All)
+ Membaca data direktori (Directory.Read.All)
+ Membaca semua grup (Group.Read.All)
+ Baca item di semua koleksi situs (Site.Read.All)
+ Menyalin daftar pengguna yang dokumennya harus diindeks. Anda dapat memilih untuk memberikan daftar nama pengguna, atau Anda dapat memberikan nama pengguna dalam file yang disimpan dalam file Amazon S3. Setelah membuat sumber data, Anda dapat:
+ Mengubah daftar pengguna.
+ Ubah dari daftar pengguna ke daftar yang disimpan dalam Amazon S3 bucket.
+ Ubah lokasi Amazon S3 bucket daftar pengguna. Jika Anda mengubah lokasi bucket, Anda juga harus memperbarui IAM peran untuk sumber data agar memiliki akses ke bucket.
**catatan**
Jika Anda menyimpan daftar nama pengguna dalam Amazon S3 bucket, IAM kebijakan untuk sumber data harus menyediakan akses ke bucket dan akses ke kunci yang dienkripsi bucket, jika ada.
+ Memeriksa setiap dokumen unik di dalam OneDrive dan di seluruh sumber data lain yang Anda rencanakan untuk digunakan untuk indeks yang sama. Setiap sumber data yang ingin Anda gunakan untuk indeks tidak boleh berisi dokumen yang sama di seluruh sumber data. Dokumen IDs bersifat global untuk indeks dan harus unik per indeks.
**Di dalam Anda Akun AWS, pastikan Anda memiliki:**
+ [Membuat Amazon Kendra indeks](https://docs.aws.amazon.com/kendra/latest/dg/create-index.html) dan, jika menggunakan API, mencatat ID indeks.
+ [Membuat IAM peran](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds) untuk sumber data Anda dan, jika menggunakan API, catat ARN peran tersebut IAM .
**catatan**
Jika Anda mengubah jenis otentikasi dan kredensyal, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benar AWS Secrets Manager .
+ Menyimpan kredensyal OneDrive otentikasi Anda AWS Secrets Manager secara rahasia dan, jika menggunakan API, catat ARN rahasia tersebut.
**catatan**
Kami menyarankan Anda secara teratur menyegarkan atau memutar kredensil dan rahasia Anda. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami **tidak** menyarankan Anda menggunakan kembali kredensyal dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).
Jika Anda tidak memiliki IAM peran atau rahasia yang ada, Anda dapat menggunakan konsol untuk membuat IAM peran dan Secrets Manager rahasia baru saat menghubungkan sumber OneDrive data Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks.
## Instruksi koneksi
Untuk terhubung Amazon Kendra ke sumber OneDrive data Anda, Anda harus memberikan rincian OneDrive kredensyal Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi OneDrive untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-onedrive).
------
#### [ Console ]
**Untuk terhubung Amazon Kendra ke OneDrive**
1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendra konsol](https://console.aws.amazon.com/kendra/).
1. Dari panel navigasi kiri, pilih **Indeks** dan kemudian pilih indeks yang ingin Anda gunakan dari daftar indeks.
**catatan**
Anda dapat memilih untuk mengonfigurasi atau mengedit pengaturan **kontrol akses Pengguna** di bawah **Pengaturan indeks**.
1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**.
1. Pada halaman **Tambahkan sumber data**, pilih **OneDrive konektor**, lalu pilih **Tambah konektor**. Jika menggunakan versi 2 (jika ada), pilih **OneDrive konektor** dengan tag “V2.0".
1. Pada halaman **Tentukan detail sumber data**, masukkan informasi berikut:
1. Di **Nama dan deskripsi**, untuk **Nama sumber data** —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi.
1. (Opsional) **Deskripsi** —Masukkan deskripsi opsional untuk sumber data Anda.
1. Dalam **Bahasa default** —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen mengesampingkan bahasa yang dipilih.
1. Di **Tag**, untuk **Tambahkan tag baru —Sertakan tag** opsional untuk mencari dan memfilter sumber daya Anda atau melacak AWS biaya Anda.
1. Pilih **Berikutnya**.
1. Pada halaman **Tentukan akses dan keamanan**, masukkan informasi berikut:
1. **OneDrive ID penyewa** —Masukkan ID OneDrive penyewa tanpa protokol.
1. **Jenis otentikasi** **—Pilih antara **Baru** dan yang Ada.**
1.
1. Jika Anda memilih **yang ada**, pilih rahasia yang ada untuk **Select secret**.
1. Jika Anda memilih **Baru**, masukkan informasi berikut di bagian ** AWS Secrets Manager Rahasia baru**:
1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra- OneDrive -' secara otomatis ditambahkan ke nama rahasia Anda.
1. **Untuk **ID Aplikasi** dan **kata sandi Aplikasi** —Masukkan nilai kredensi otentikasi dari OneDrive akun Anda dan kemudian pilih Simpan otentikasi.**
1. **IAM peran** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten.
**catatan**
IAM peran yang digunakan untuk indeks tidak dapat digunakan untuk sumber data. Jika Anda tidak yakin apakah peran yang ada digunakan untuk indeks atau FAQ, pilih **Buat peran baru** untuk menghindari kesalahan.
1. Pilih **Berikutnya**.
1. Pada halaman **Konfigurasi pengaturan sinkronisasi**, masukkan informasi berikut:
1. Pilih antara **file Daftar** dan **daftar Nama** berdasarkan kasus penggunaan Anda.
1. Jika Anda memilih **Daftar file**, masukkan informasi berikut:
1. **Pilih lokasi** —Masukkan jalur ke Amazon S3 bucket Anda.
**Tambahkan file daftar pengguna ke Amazon S3** —Pilih untuk menambahkan file daftar pengguna ke Amazon S3 bucket.
**Pemetaan grup lokal pengguna** —Pilih untuk menggunakan pemetaan grup lokal untuk memfilter konten Anda.
1. Jika Anda memilih **daftar Nama**, masukkan informasi berikut:
1. **Nama pengguna** —Masukkan hingga 10 drive pengguna untuk diindeks. Untuk menambahkan lebih dari 10 pengguna, buat file yang berisi nama.
**Tambahkan yang lain** —Pilih untuk menambahkan lebih banyak pengguna.
**Pemetaan grup lokal pengguna** —Pilih untuk menggunakan pemetaan grup lokal untuk memfilter konten Anda.
1. Untuk **konfigurasi tambahan** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola.
1. Di **Jadwal lari Sinkronisasi**, untuk **Frekuensi** —Pilih seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda.
1. Pilih **Berikutnya**.
1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut:
1. Untuk **bidang sumber data default** dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda.
1. Pilih **Berikutnya**.
1. Pada halaman **Tinjau dan buat**, periksa apakah informasi yang Anda masukkan sudah benar dan kemudian pilih **Tambahkan sumber data**. Anda juga dapat memilih untuk mengedit informasi Anda dari halaman ini. Sumber data Anda akan muncul di halaman **Sumber data** setelah sumber data berhasil ditambahkan.
------
#### [ API ]
**Untuk terhubung Amazon Kendra ke OneDrive**
Anda harus menentukan yang berikut menggunakan [OneDriveConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_OneDriveConfiguration.html)API:
+ **ID Penyewa** —Tentukan domain Azure Active Directory organisasi.
+ **OneDrive Pengguna** —Tentukan daftar akun pengguna yang dokumennya harus diindeks.
+ **Rahasia Nama Sumber Daya Amazon (ARN)** —Berikan Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Anda. OneDrive Rahasianya disimpan dalam struktur JSON dengan kunci berikut:
```
{
"username": "OAuth client ID",
"password": "client secret"
}
```
+ **IAM peran** —Tentukan `RoleArn` kapan Anda menelepon `CreateDataSource` untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil publik yang diperlukan APIs untuk OneDrive konektor dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAM peran untuk sumber OneDrive data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Anda juga dapat menambahkan fitur opsional berikut:
+ **Filter inklusi dan pengecualian** —Tentukan apakah akan menyertakan atau mengecualikan dokumen tertentu.
**catatan**
Sebagian besar sumber data menggunakan pola ekspresi reguler, yang merupakan pola inklusi atau pengecualian yang disebut sebagai filter. Jika Anda menentukan filter inklusi, hanya konten yang cocok dengan filter inklusi yang diindeks. Dokumen apa pun yang tidak cocok dengan filter inklusi tidak diindeks. Jika Anda menentukan filter inklusi dan pengecualian, dokumen yang cocok dengan filter pengecualian tidak akan diindeks, meskipun sesuai dengan filter inklusi.
+ **Pemetaan bidang** —Pilih untuk memetakan bidang sumber OneDrive data Anda ke bidang indeks Anda Amazon Kendra . Untuk informasi lebih lanjut, lihat [Memetakan bidang sumber data](https://docs.aws.amazon.com/kendra/latest/dg/field-mapping.html).
**catatan**
Bidang badan dokumen atau badan dokumen yang setara untuk dokumen Anda diperlukan Amazon Kendra untuk mencari dokumen Anda. Anda harus memetakan nama bidang badan dokumen Anda di sumber data Anda ke nama bidang indeks`_document_body`. Semua kolom lain bersifat opsional.
+ **Pemfilteran konteks pengguna dan kontrol akses** —Amazon Kendra meng-crawl daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL untuk dokumen Anda. Informasi ACL digunakan untuk memfilter hasil pencarian berdasarkan pengguna atau akses grup mereka ke dokumen. Untuk informasi selengkapnya, lihat [Pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#datasource-context-filter).
------