Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Konektor Salesforce V2.0
Salesforce adalah alat manajemen hubungan pelanggan (CRM) untuk mengelola tim dukungan, penjualan, dan pemasaran. Anda dapat menggunakan Amazon Kendra untuk mengindeks objek standar Salesforce Anda dan bahkan objek kustom.
Konektor sumber data Amazon Kendra Salesforce mendukung edisi Salesforce berikut: Edisi Pengembang dan Edisi Perusahaan.
**catatan**
Konektor Salesforce V1.0/ SalesforceConfiguration API berakhir pada 2023. Kami merekomendasikan untuk bermigrasi ke atau menggunakan konektor Salesforce V2.0/API. TemplateConfiguration
Untuk memecahkan masalah konektor sumber data Amazon Kendra Salesforce Anda, lihat. [Mengatasi masalah sumber data](troubleshooting-data-sources.md)
**Topics**
+ [Fitur yang didukung](#supported-features-v2-salesforce)
+ [Prasyarat](#prerequisites-v2-salesforce)
+ [Instruksi koneksi](#data-source-procedure-v2-salesforce)
+ [Pelajari selengkapnya](#salesforce-v2-learn-more)
+ [Catatan](#salesforce-notes)
## Fitur yang didukung
Amazon KendraKonektor sumber data Salesforce mendukung fitur-fitur berikut:
+ Pemetaan bidang
+ Kontrol akses pengguna
+ Filter inklusi/pengecualian
+ Sinkronisasi konten penuh dan tambahan
+ Cloud privat virtual (VPC)
## Prasyarat
Sebelum Anda dapat menggunakan Amazon Kendra untuk mengindeks sumber data Salesforce Anda, buat perubahan ini di Salesforce dan akun Anda. AWS
**Di Salesforce, pastikan Anda memiliki:**
+ Membuat akun administratif Salesforce dan telah mencatat nama pengguna dan kata sandi yang Anda gunakan untuk terhubung ke Salesforce.
+ Menyalin token keamanan Salesforce yang terkait dengan akun yang digunakan untuk terhubung ke Salesforce.
+ Membuat akun Salesforce Connected App dengan OAuth diaktifkan dan telah menyalin kunci konsumen (ID klien) dan rahasia konsumen (rahasia klien) yang ditetapkan ke Aplikasi Salesforce Connected Anda. ID klien dan rahasia klien digunakan sebagai kredensi otentikasi Anda yang disimpan dalam rahasia. AWS Secrets Manager Lihat [dokumentasi Salesforce di Aplikasi Terhubung](https://help.salesforce.com/s/articleView?id=sf.connected_app_overview.htm&type=5) untuk informasi selengkapnya.
**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).
+ Menyalin URL instance Salesforce yang ingin Anda indeks. Biasanya, ini adalah *https://.salesforce.com/*. Server harus menjalankan aplikasi yang terhubung dengan Salesforce.
+ Menambahkan kredensyal ke server Salesforce Anda untuk pengguna dengan akses hanya-baca ke Salesforce dengan mengkloning ReadOnly profil dan kemudian menambahkan izin Lihat Semua Data dan Kelola Artikel. Kredensil ini mengidentifikasi pengguna yang membuat koneksi dan aplikasi terhubung Salesforce yang terhubung ke. Amazon Kendra
+ Memeriksa setiap dokumen unik di Salesforce 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 AndaAkun 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 tersebutIAM.
**catatan**
Jika Anda mengubah jenis otentikasi dan kredensialnya, Anda harus memperbarui IAM peran Anda untuk mengakses ID rahasia yang benarAWS Secrets Manager.
+ Menyimpan kredensi otentikasi Salesforce Anda secara AWS Secrets Manager 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 Anda menghubungkan sumber data Salesforce. 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 data Salesforce Anda, Anda harus memberikan rincian yang diperlukan dari sumber data Salesforce Anda sehingga Amazon Kendra dapat mengakses data Anda. Jika Anda belum mengkonfigurasi Salesforce untuk Amazon Kendra lihat. [Prasyarat](#prerequisites-v2-salesforce)
------
#### [ Console ]
**Untuk terhubung Amazon Kendra ke Salesforce**:
1. Masuk ke Konsol Manajemen AWS dan buka [Amazon Kendrakonsol](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** Anda di bawah **Pengaturan indeks**.
1. Pada halaman **Memulai**, pilih **Tambahkan sumber data**.
1. Pada halaman **Tambah sumber data**, pilih konektor **Salesforce, lalu pilih **Tambah** konektor**. Jika menggunakan versi 2 (jika ada), pilih **konektor Salesforce** 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. URL **Salesforce —Masukkan URL** contoh untuk situs Salesforce yang ingin Anda indeks.
1. **Otorisasi** — Aktifkan atau nonaktifkan informasi daftar kontrol akses (ACL) untuk dokumen Anda, jika Anda memiliki ACL dan ingin menggunakannya untuk kontrol akses. ACL menentukan dokumen mana yang dapat diakses pengguna dan grup. 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#context-filter-user-incl-datasources).
1. Masukkan rahasia yang ada atau jika Anda membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.
1. **Otentikasi** —Masukkan informasi berikut di jendela **Buat AWS Secrets Manager rahasia**:
1. **Nama rahasia** —Nama untuk rahasiamu. Awalan 'AmazonKendra-Salesforce-' secara otomatis ditambahkan ke nama rahasia Anda.
1. Untuk **Nama Pengguna**, **Kata Sandi**, **Token keamanan**, **Kunci konsumen**, **Rahasia konsumen**, dan **URL Otentikasi** —Masukkan nilai kredensi otentikasi yang Anda buat dan unduh dari akun Salesforce Anda.
**catatan**
Jika Anda menggunakan Salesforce Developer Edition, gunakan `https://login.salesforce.com/services/oauth2/token` atau URL login Domain Saya (misalnya,* https://MyCompany.my.salesforce.com*) sebagai URL **Otentikasi**. **Jika Anda menggunakan Salesforce Sandbox Edition, gunakan `https://test.salesforce.com/services/oauth2/token ` atau URL login Domain Saya (misalnya,* MyDomainName--SandboxName.sandbox.my.salesforce.com*) sebagai URL Otentikasi.**
1. Pilih **Simpan otentikasi.**
1. **Virtual Private Cloud (VPC)** —Anda dapat memilih untuk menggunakan VPC. Jika demikian, Anda harus menambahkan **Subnet** dan grup keamanan **VPC**.
1. **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.
1. **IAMperan** —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten Anda.
**catatan**
IAMperan 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. Untuk **lampiran Crawl** —Pilih untuk meng-crawl semua objek Salesforce yang terpasang.
1. Untuk **objek Standar, Objek** **standar dengan lampiran**, dan **objek Standar tanpa lampiran** dan **Artikel Pengetahuan** —Pilih entitas Salesforce atau tipe konten yang ingin dirayapi.
1. Anda harus memberikan informasi konfigurasi untuk mengindeks setidaknya satu objek standar, artikel pengetahuan, atau umpan obrolan. Jika Anda memilih untuk merayapi **artikel Pengetahuan**, Anda harus menentukan jenis artikel pengetahuan yang akan diindeks. Anda dapat memilih diterbitkan, diarsipkan, draf, dan lampiran.
**Filter Regex** —Tentukan pola regex untuk menyertakan item katalog tertentu.
1. Untuk **konfigurasi tambahan**:
+ **Informasi ACL** Semua daftar kontrol akses disertakan secara default. Menghapus pilihan daftar kontrol akses akan membuat semua file dalam kategori itu publik.
+ Pola **Regex —Tambahkan pola** ekspresi reguler untuk menyertakan atau mengecualikan file tertentu. Anda dapat menambahkan hingga 100 pola.
**Mode sinkronisasi** —Pilih cara memperbarui indeks saat konten sumber data berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda.
+ Sinkronisasi penuh: Indeks baru semua konten, ganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.
+ Sinkronisasi baru yang dimodifikasi: Indeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
+ Sinkronisasi baru, dimodifikasi, dihapus: Indeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
1. Pilih **Berikutnya**.
1. Pada halaman **Setel pemetaan bidang**, masukkan informasi berikut:
1. Untuk **artikel pengetahuan Standar**, **Lampiran objek standar**, dan **Pemetaan bidang yang disarankan tambahan** —Pilih dari bidang sumber data default Amazon Kendra yang dihasilkan yang ingin Anda petakan ke indeks Anda.
**catatan**
Diperlukan pemetaan `_document_body` indeks. Anda tidak dapat mengubah pemetaan antara `Salesforce ID` bidang dan Amazon Kendra `_document_id ` bidang. Anda dapat memetakan bidang Salesforce apa pun ke judul dokumen atau kolom indeks Amazon reserved/default Kendra badan dokumen.
Jika Anda memetakan bidang Salesforce apa pun ke bidang judul dokumen dan badan dokumen Amazon Kendra, Amazon Kendra akan menggunakan data dari judul dokumen dan bidang isi dalam respons penelusuran.
1. **Tambahkan bidang** —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang.
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 Salesforce**
Anda harus menentukan JSON dari [skema sumber data](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html) menggunakan API. [TemplateConfiguration](https://docs.aws.amazon.com/kendra/latest/APIReference/API_TemplateConfiguration.html) Anda harus memberikan informasi berikut ini:
+ **Sumber data** —Tentukan tipe sumber data seperti `SALESFORCEV2` saat Anda menggunakan skema [https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html](https://docs.aws.amazon.com/kendra/latest/dg/API_TemplateConfiguration.html)JSON. Tentukan juga sumber data seperti `TEMPLATE` saat Anda memanggil [https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html](https://docs.aws.amazon.com/kendra/latest/dg/API_CreateDataSource.html)API.
+ **URL Host** —Tentukan URL host instance Salesforce.
+ **Mode sinkronisasi** —Tentukan cara Amazon Kendra memperbarui indeks Anda saat konten sumber data Anda berubah. Saat Anda menyinkronkan sumber data Amazon Kendra untuk pertama kalinya, semua konten dirayapi dan diindeks secara default. Anda harus menjalankan sinkronisasi penuh data Anda jika sinkronisasi awal Anda gagal, bahkan jika Anda tidak memilih sinkronisasi penuh sebagai opsi mode sinkronisasi Anda. Anda dapat memilih antara:
+ `FORCED_FULL_CRAWL`untuk mengindeks semua konten baru, mengganti konten yang ada setiap kali sumber data Anda disinkronkan dengan indeks Anda.
+ `FULL_CRAWL`untuk mengindeks hanya konten baru, dimodifikasi, dan dihapus setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
+ `CHANGE_LOG`untuk mengindeks hanya konten baru dan yang dimodifikasi setiap kali sumber data Anda disinkronkan dengan indeks Anda. Amazon Kendradapat menggunakan mekanisme sumber data Anda untuk melacak perubahan konten dan mengindeks konten yang berubah sejak sinkronisasi terakhir.
+ **Rahasia Nama Sumber Daya Amazon (ARN) —Berikan** Nama Sumber Daya Amazon (ARN) Secrets Manager rahasia yang berisi kredensyal otentikasi untuk akun Salesforce Anda. Rahasianya disimpan dalam struktur JSON dengan kunci berikut:
```
{
"authenticationUrl": "OAUTH endpoint that Amazon Kendra connects to get an OAUTH token",
"consumerKey": "Application public key generated when you created your Salesforce application",
"consumerSecret": "Application private key generated when you created your Salesforce application",
"password": "Password associated with the user logging in to the Salesforce instance",
"securityToken": "Token associated with the user account logging in to the Salesforce instance",
"username": "User name of the user logging in to the Salesforce instance"
}
```
+ **IAMperan** —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 konektor Salesforce dan. Amazon Kendra Untuk informasi selengkapnya, lihat [IAMperan untuk sumber data Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/iam-roles.html#iam-roles-ds).
Anda juga dapat menambahkan fitur opsional berikut:
+ **Virtual Private Cloud (VPC) `VpcConfiguration` —Tentukan** kapan Anda menelepon. `CreateDataSource` Untuk informasi selengkapnya, lihat [Mengkonfigurasi Amazon Kendra untuk menggunakan Amazon VPC](vpc-configuration.md).
+ **Filter inklusi dan pengecualian** —Anda dapat menentukan apakah akan menyertakan atau mengecualikan dokumen, akun, kampanye, kasus, kontak, prospek, peluang, solusi, tugas, grup, obrolan, dan file entitas kustom 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.
+ **Perayap identitas —Tentukan apakah akan mengaktifkan crawler** Amazon Kendra identitas. Perayap identitas menggunakan informasi daftar kontrol akses (ACL) untuk dokumen Anda untuk memfilter hasil penelusuran berdasarkan akses pengguna atau grup mereka ke dokumen. Jika Anda memiliki ACL untuk dokumen Anda dan memilih untuk menggunakan ACL Anda, Anda juga dapat memilih untuk mengaktifkan crawler Amazon Kendra identitas untuk mengonfigurasi [pemfilteran konteks pengguna](https://docs.aws.amazon.com/kendra/latest/dg/user-context-filter.html#context-filter-user-incl-datasources) dari hasil pencarian. Sebaliknya, jika perayap identitas dinonaktifkan, semua dokumen dapat dicari secara publik. Jika Anda ingin menggunakan kontrol akses untuk dokumen dan crawler identitas dimatikan, Anda dapat menggunakan [PutPrincipalMapping](https://docs.aws.amazon.com/kendra/latest/APIReference/API_PutPrincipalMapping.html)API untuk mengunggah informasi akses pengguna dan grup untuk pemfilteran konteks pengguna.
+ **Pemetaan bidang** —Pilih untuk memetakan bidang sumber data Salesforce 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.
**catatan**
Diperlukan pemetaan `_document_body` indeks. Anda tidak dapat mengubah pemetaan antara `Salesforce ID` bidang dan Amazon Kendra `_document_id ` bidang. Anda dapat memetakan bidang Salesforce apa pun ke judul dokumen atau kolom indeks Amazon reserved/default Kendra badan dokumen.
Jika Anda memetakan bidang Salesforce apa pun ke bidang judul dokumen dan badan dokumen Amazon Kendra, Amazon Kendra akan menggunakan data dari judul dokumen dan bidang isi dalam respons penelusuran.
Untuk daftar kunci JSON penting lainnya untuk dikonfigurasi, lihat Skema template [Salesforce](https://docs.aws.amazon.com/kendra/latest/dg/ds-schemas.html#ds-salesforce-schema).
------
## Pelajari selengkapnya
Untuk mempelajari lebih lanjut tentang mengintegrasikan Amazon Kendra dengan sumber data Salesforce Anda, lihat:
+ [Mengumumkan konektor Salesforce yang diperbarui (V2) untuk Amazon Kendra](https://aws.amazon.com/blogs/machine-learning/announcing-the-updated-salesforce-connector-v2-for-amazon-kendra/)
## Catatan
+ Saat Daftar Kontrol Akses (ACLs) diaktifkan, opsi “Sinkronkan hanya konten baru atau yang dimodifikasi” tidak tersedia karena keterbatasan API Salesforce. Sebaiknya gunakan mode “Sinkronisasi penuh” atau “Sinkronisasi konten baru, dimodifikasi, atau dihapus” sebagai gantinya, atau nonaktifkan ACLs jika Anda perlu menggunakan mode sinkronisasi ini.