Amazon Kendra Tidak lagi terbuka untuk pelanggan baru. Untuk kemampuan yang mirip dengan Amazon Kendra, jelajahi Amazon Bedrock Knowledge Bases. [Pelajari selengkapnya.](https://docs.aws.amazon.com/kendra/latest/dg/kendra-availability-change.html)
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# SharePoint konektor V1.0
SharePoint adalah layanan pembuatan situs web kolaboratif yang dapat Anda gunakan untuk menyesuaikan konten web dan membuat halaman, situs, pustaka dokumen, dan daftar. Jika Anda adalah SharePoint pengguna, Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda.
**catatan**
SharePoint connec V1.0 tor/ SharePointConfiguration API berakhir pada tahun 2023. Kami merekomendasikan migrasi ke atau menggunakan SharePoint konektor V2.0 / TemplateConfiguration API.
Untuk mengatasi masalah konektor sumber Amazon Kendra SharePoint data Anda, lihat[Mengatasi masalah sumber data](troubleshooting-data-sources.md).
**Topics**
+ [Fitur yang didukung](#supported-features-v1-sharepoint)
+ [Prasyarat](#prerequisites-v1-sharepoint)
+ [Instruksi koneksi](#data-source-procedure-v1-sharepoint)
+ [Pelajari selengkapnya](#sharepoint-v1-learn-more)
## Fitur yang didukung
+ Pemetaan bidang
+ Kontrol akses pengguna
+ Inclusion/exclusion filter
+ Ubah log
+ Cloud privat virtual (VPC)
## Prasyarat
Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber SharePoint data Anda, buat perubahan ini di AWS akun SharePoint dan Anda.
Anda diharuskan memberikan kredentif otentikasi, yang Anda simpan secara AWS Secrets Manager rahasia dengan aman.
**catatan**
Kami menyarankan Anda menyegarkan atau memutar kredenSIAL dan rahasia Anda secara teratur. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami ** tidak ** menyarankan Anda menggunakan kembali kredensi dan rahasia di seluruh sumber data, dan konektor versi 1.0 dan 2.0 (jika berlaku).
**Di SharePoint, pastikan Anda memiliki: **
+ Perhatikan URL SharePoint situs yang ingin Anda indeks.
+ **Untuk SharePoint Online: **
+ Perhatikan kredentif otentikasi dasar Anda yang berisi nama pengguna dan kata sandi dengan izin admin situs.
+ **Opsional: ** Kredentif OAuth 2.0 yang dihasilkan berisi nama pengguna, kata sandi, ID klien, dan rahasia klien.
+ Default ** Keamanan yang dinonaktifkan ** di portal Azure Anda menggunakan pengguna administratif. Untuk informasi selengkapnya tentang mengelola pengaturan default keamanan di portal Azure, lihat dokumentasi [ Microsoft tentang cara mengam enable/disable ankan default](https://learn.microsoft.com/en-us/microsoft-365/business-premium/m365bp-conditional-access?view=o365-worldwide&tabs=secdefaults#security-defaults-1).
+ **Untuk SharePoint Server: **
+ Catat nama domain SharePoint Server Anda (nama NetBIOS di Active Directory Anda). Anda menggunakan ini, bersama dengan nama pengguna otentikasi SharePoint dasar dan kata sandi Anda, untuk menghubungkan SharePoint Server ke Amazon Kendra.
**catatan**
Jika Anda menggunakan SharePoint Server dan perlu mengonversi Daftar Kontrol Akses (ACL) ke format email untuk memfilter pada konteks pengguna, berikan URL server LDAP dan basis pencarian LDAP. Atau Anda dapat menggunakan direktori domain override. URL server LDAP adalah nama domain lengkap dan nomor port (misalnya, ldap: //example.com:389). Basis pencarian LDAP adalah pengontrol domain 'example' dan 'com'. Dengan penggantian domain direktori, Anda dapat menggunakan domain email alih-alih menggunakan URL server LDAP dan basis pencarian LDAP. Misalnya, domain email untuk username@example.com adalah 'example.com'. Anda dapat menggunakan penggantian ini jika Anda tidak khawatir tentang memvalidasi domain Anda dan hanya ingin menggunakan domain email Anda.
+ Menambahkan izin berikut ke SharePoint akun Anda:
**Untuk SharePoint daftar **
+ Item Terbuka—Melihat sumber dokumen dengan penangan file sisi server.
+ Lihat Halaman Aplikasi—Lihat formulir, tampilan, dan halaman aplikasi. Menghitung daftar.
+ Lihat Item—Melihat item dalam daftar dan dokumen di pustaka dokumen.
+ Lihat Versi—Melihat versi sebelumnya dari item daftar atau dokumen.
**Untuk SharePoint situs web **
+ Jelajahi Direktori — Menghitung file dan folder di situs web menggunakan antarmuka SharePoint Designer dan Web DAV.
+ Jelajahi Informasi Pengguna—Lihat informasi tentang pengguna situs web.
+ Menghitung Izin—Menghitung izin pada situs web, daftar, folder, dokumen, atau item daftar.
+ Buka — Buka situs web, daftar, atau folder untuk mengakses item di dalam wadah.
+ Gunakan Fitur Integrasi Klien—Gunakan SOAP, WebDAV, model objek klien, atau antarmuka Desainer untuk mengakses SharePoint situs web.
+ Gunakan Antarmuka Jarak Jauh—Gunakan fitur yang meluncurkan aplikasi klien.
+ Lihat Halaman — Melihat halaman di situs web.
+ Diperiksa setiap dokumen unik di dalam SharePoint 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. ID dokumen bersifat global untuk indeks dan harus unik per indeks.
**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, catat 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 IAM peran tersebut.
**catatan**
Jika Anda mengubah jenis dan kredentif otentikasi, Anda harus memperbarui IAM peran Anda untuk mengakses ID AWS Secrets Manager rahasia yang benar.
+ Meny SharePoint impan kredentif otentikasi Anda secara AWS Secrets Manager rahasia dan, jika menggunakan API, catat ARN rahasia tersebut.
**catatan**
Kami menyarankan Anda menyegarkan atau memutar kredenSIAL dan rahasia Anda secara teratur. Berikan hanya tingkat akses yang diperlukan untuk keamanan Anda sendiri. Kami ** tidak ** menyarankan Anda menggunakan kembali kredensi 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 SharePoint data Anda ke Amazon Kendra. Jika Anda menggunakan API, Anda harus memberikan ARN dari IAM peran dan Secrets Manager rahasia yang ada, dan ID indeks.
## Instruksi koneksi
Untuk terhubung Amazon Kendra ke sumber SharePoint data Anda, Anda harus memberikan rincian SharePoint kredensional Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengonfigurasi SharePoint untuk Amazon Kendra lihat[Prasyarat](#prerequisites-v1-sharepoint).
------
#### [ Console ]
**Untuk terhubung Amazon Kendra ke SharePoint **
1. Masuk ke Konsol AWS Manajemen 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 ** SharePoint konektor v1.0**, lalu pilih ** Tambahkan sumber ** data.
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 menyertakan tanda hubung tetapi bukan spasi.
1. (Opsional) ** Deskripsi ** —Masukkan deskripsi opsional untuk sumber data Anda.
1. Dalam bahasa Def ** ** ault —Pilih bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default adalah bahasa Inggris. Bahasa yang ditentukan dalam metadata dokumen menggantikan 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. Untuk metode ** Hosting ** —Pilih antara ** SharePoint Online ** dan ** SharePoint Server**.
1. Untuk ** SharePoint Online ** —Masukkan URL ** Situs khusus untuk SharePoint repositori ** Anda.
1. Untuk ** SharePoint Server ** —Pilih ** SharePoint versi Anda**, masukkan URL ** Situs khusus untuk SharePoint repositori Anda**, dan masukkan Amazon S3 jalur ke lokasi ** sertifikat ** SSL Anda.
1. (SharePoint Hanya server) Untuk proxy ** Web ** —Masukkan nama ** Host ** dan nomor ** ** Port SharePoint instans internal Anda. Nomor port harus berupa nilai numerik antara 0 dan 65535.
1. Untuk ** Otentikasi ** —Pilih di antara opsi berikut berdasarkan kasus penggunaan Anda:
1. Untuk SharePoint Online—Pilih antara otentikasi ** Dasar ** dan otentikasi ** OAuth 2.0. **
1. Untuk SharePoint Server—Pilih antara Tidak Ada**, ** ** LDAP**, dan Manual. ** **
1. Untuk **AWS Secrets Manager rahasia ** —Pilih rahasia yang ada atau buat Secrets Manager rahasia baru untuk menyimpan kredentif SharePoint otentikasi Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka. Anda harus memasukkan nama ** rahasia**. Awalan 'AmazonKendra-SharePoint-' secara otomatis ditambahkan ke nama rahasia Anda.
1. Masukkan informasi lain berikut di jendela ** Buat AWS Secrets Manager rahasia**:
1. Pilih dari opsi otentikasi SharePoint Cloud berikut, berdasarkan kasus penggunaan Anda:
1. **Otentikasi dasar ** —Masukkan nama pengguna SharePoint akun Anda sebagai Nama ** pengguna ** dan kata sandi SharePoint akun sebagai Kata Sand ** i. **
1. **OAuth 2.0 otentikasi ** —Masukkan nama pengguna SharePoint akun Anda sebagai Nama ** Pengguna**, kata sandi SharePoint akun sebagai ** Kata Sandi**, SharePoint ID unik yang dibuat secara otomatis sebagai ID ** Klien**, dan string rahasia bersama yang digunakan oleh keduanya SharePoint dan Amazon Kendra sebagai rahasia Klien. ** **
1. Pilih dari opsi otentikasi SharePoint Server berikut, berdasarkan kasus penggunaan Anda:
1. **Tidak ada ** —Masukkan nama pengguna SharePoint akun Anda sebagai Nama ** Pengguna**, kata sandi SharePoint akun Anda sebagai Kata Sand ** i**, dan Nama ** Domain ** Server Anda.
1. **LDAP ** —Masukkan nama pengguna SharePoint akun Anda sebagai Nama ** Pengguna**, kata sandi SharePoint akun sebagai ** Kata Sandi**, Titik Akhir Server ** LDAP Anda ** (termasuk protokol dan nomor port, misalnya{{ldap://example.com:389}}), dan Basis Pencarian ** LDAP Anda ** (misalnya,). {{dc=example, dc=com}}
1. **Manual ** —Masukkan nama pengguna SharePoint akun Anda sebagai Nama ** Pengguna**, kata sandi SharePoint akun Anda sebagai Kata Sand ** i**, dan Peng ** gantian Domain Email Anda ** (domain email pengguna direktori atau grup).
1. Pilih **Simpan**.
1. **Virtual Private Cloud (VPC) ** — Anda juga harus menambahkan ** Subnets ** dan grup keamanan ** VPC. **
**catatan**
Anda harus menggunakan VPC jika Anda menggunakan SharePoint Server. Amazon VPC bersifat opsional untuk SharePoint versi lain.
1. **IAM peran ** —Pilih peran yang ada atau buat IAM IAM peran baru untuk mengakses kredentif repositori dan konten indeks Anda.
**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. **Gunakan Log perubahan ** —Pilih untuk memperbarui indeks Anda alih-alih menyinkronkan semua file Anda.
1. **Merayapi lampiran ** —Pilih untuk merayapi lampiran.
1. **Gunakan pemetaan grup lokal ** —Pilih untuk memastikan bahwa dokumen difilter dengan benar.
1. **Konfigurasi tambahan ** —Tambahkan pola ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola.
1. Dalam Sin ** kronisasi jadwal jalankan ** untuk Fre ** kuensi ** —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda.
1. Pilih **Berikutnya**.
1. Pada ** halaman ** Set pemetaan bidang, masukkan informasi berikut:
1. **Amazon Kendra pemetaan bidang default ** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda.
1. Untuk ** pemetaan bidang kustom ** —Tambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan jenis data bidang.
1. Pilih **Berikutnya**.
1. Pada ** halaman ** Tinjau dan buat, periksa apakah informasi yang Anda masukkan benar, lalu 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 SharePoint **
Anda harus menentukan yang berikut menggunakan [ SharePointConfiguration ](https://docs.aws.amazon.com/kendra/latest/APIReference/API_SharePointConfiguration.html) API:
+ **SharePointVersi ** —Tentukan SharePoint versi yang Anda gunakan saat mengonfigurasi SharePoint. Ini adalah kasus tidak masalah jika Anda menggunakan SharePoint Server 2013, SharePoint Server Subscription Edition, atau SharePoint Online.
+ **Nama Sumber Daya Amazon Rahasia (ARN) ** —Berikan Nama Sumber Daya Amazon (ARN) dari Secrets Manager rahasia yang berisi kredentif otentikasi yang Anda buat di akun SharePoint Anda.Rahasia disimpan dalam struktur JSON.
Untuk otentikasi dasar ** SharePoint Online**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda:
```
{
"userName": "{{user name}}",
"password": "{{password}}"
}
```
Untuk otentikasi OAuth 2.0 ** SharePoint Online**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda:
```
{
"userName": "{{SharePoint account user name"}}",
"password": "{{SharePoint account password}}",
"clientId": "{{SharePoint auto-generated unique client id}}",
"clientSecret": "{{secret string shared by Amazon Kendra and SharePoint to authorize communications}}"
}
```
Untuk otentikasi dasar ** SharePoint Server**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda:
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}"
}
```
Untuk otentikasi ** SharePoint Server LDAP ** (jika Anda perlu mengonversi daftar kontrol akses (ACL) ke format email untuk memfilter pada konteks pengguna, Anda dapat menyertakan URL server LDAP dan basis pencarian LDAP dalam rahasia Anda), berikut ini adalah struktur JSON minimum yang harus ada di rahasia Anda:
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}"
"ldapServerUrl": "{{ldap://example.com:389}}",
"ldapSearchBase": "{{dc=example,dc=com}}"
}
```
Untuk otentikasi Manual ** SharePoint Server**, berikut ini adalah struktur JSON minimum yang harus ada dalam rahasia Anda::
```
{
"userName": "{{user name}}",
"password": "{{password}}",
"domain": "{{server domain name}}",
"emailDomainOverride": "{{example.com}}"
}
```
+ **IAM role ** —T `RoleArn` entukan kapan Anda memang `CreateDataSource` gil untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan untuk memanggil API publik yang diperlukan untuk SharePoint konektor dan Amazon Kendra. Untuk informasi selengkapnya, lihat [IAM peran untuk sumber SharePoint data](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
+ **Amazon VPC**—Jika Anda menggunakan SharePoint Server, tentukan `VpcConfiguration` sebagai bagian dari konfigurasi sumber data. Lihat Meng [ onfigurasi Amazon Kendra untuk menggunakan VPC](https://docs.aws.amazon.com/kendra/latest/dg/vpc-configuration.html).
Anda juga dapat menambahkan fitur opsional berikut:
+ **Web proxy ** —Apakah akan terhubung ke URL SharePoint situs Anda melalui proxy web. Anda dapat menggunakan opsi ini hanya untuk SharePoint Server.
+ **Daftar pengindeksan ** —Apakah Amazon Kendra harus mengindeks konten lampiran ke SharePoint daftar item.
+ **Log perubahan ** —Apakah Amazon Kendra harus menggunakan mekanisme log perubahan sumber SharePoint data untuk menentukan apakah dokumen harus diperbarui dalam indeks.
**catatan**
Gunakan log perubahan jika Anda tidak ingin Amazon Kendra memindai semua dokumen. Jika log perubahan Anda besar, mungkin perlu waktu Amazon Kendra lebih sedikit untuk memindai dokumen di sumber SharePoint data daripada memproses log perubahan. Jika Anda menyinkronkan sumber data SharePoint Anda dengan indeks Anda untuk pertama kalinya, semua dokumen akan dipindai.
+ **Filter inklusi dan pengecualian ** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan konten 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 diindeks, bahkan jika dokumen tersebut cocok dengan filter inklusi.
+ **Pemetaan bidang ** —Pilih untuk memetakan bidang sumber SharePoint 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 — merayapi 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).
------
## Pelajari selengkapnya
Untuk mempelajari selengkapnya tentang mengintegrasikan Amazon Kendra dengan sumber SharePoint data Anda, lihat:
+ [Memulai dengan konektor Amazon Kendra SharePoint Online ](https://aws.amazon.com/blogs/machine-learning/getting-started-with-the-amazon-kendra-sharepoint-online-connector/)