Konektor Salesforce V1.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.

penting

Amazon Kendra menggunakan Salesforce API versi 48. Salesforce API membatasi jumlah permintaan yang dapat Anda buat per hari. Jika Salesforce melebihi permintaan tersebut, ia mencoba lagi sampai dapat melanjutkan.

catatan

Support untuk konektor Salesforce V1.0/ SalesforceConfiguration API dijadwalkan berakhir pada tahun 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

Fitur yang didukung

Amazon Kendra Konektor sumber data Salesforce mendukung fitur-fitur berikut:

• Pemetaan lapangan

• Kontrol akses pengguna

• Filter inklusi/pengecualian

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 Salesforce dan telah mencatat nama pengguna dan kata sandi yang Anda gunakan 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 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 token keamanan Salesforce yang terkait dengan akun yang digunakan untuk terhubung ke Salesforce.

• Menyalin URL instance Salesforce yang ingin Anda indeks. Biasanya, ini adalah https://.salesforce.com/. <company> Server harus menjalankan aplikasi yang terhubung dengan Salesforce.

• Menambahkan kredensil 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. ID dokumen bersifat global untuk indeks dan harus unik per indeks.

Di dalam Anda Akun AWS, pastikan Anda memiliki:

• Membuat Amazon Kendra indeks dan, jika menggunakan API, mencatat ID indeks.

• Membuat IAM peran 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 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

Console

Untuk terhubung Amazon Kendra ke Salesforce

1. Masuk ke Konsol AWS Manajemen dan buka Amazon Kendra konsol.

2. 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.

3. Pada halaman Memulai, pilih Tambahkan sumber data.

4. Pada halaman Tambah sumber data, pilih Konektor Salesforce V1.0, lalu pilih Tambah konektor.

5. Pada halaman Tentukan detail sumber data, masukkan informasi berikut:

   1. Nama sumber data —Masukkan nama untuk sumber data Anda. Anda dapat memasukkan tanda hubung tetapi bukan spasi.

   2. (Opsional) Deskripsi —Masukkan deskripsi opsional untuk sumber data Anda.

   3. Bahasa default — Bahasa untuk memfilter dokumen Anda untuk indeks. Kecuali Anda menentukan sebaliknya, bahasa default ke bahasa Inggris. Bahasa yang ditentukan dalam metadata menggantikan bahasa yang dipilih.

   4. Tambahkan tag baru —Tag untuk mencari dan memfilter sumber daya Anda atau melacak biaya bersama Anda.

   5. Pilih Selanjutnya.

6. Pada halaman Tentukan akses dan keamanan, masukkan informasi berikut:

   1. URL Salesforce —Masukkan URL instance untuk situs Salesforce yang ingin Anda indeks.

   2. Untuk Jenis otentikasi, pilih antara Existing dan New untuk menyimpan kredensyal otentikasi Salesforce Anda. Jika Anda memilih untuk membuat rahasia baru, jendela AWS Secrets Manager rahasia terbuka.

      1. 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.

         2. Untuk Nama Pengguna, Kata Sandi, Token keamanan, Kunci konsumen, Rahasia konsumen, dan URL Otentikasi —Masukkan nilai kredensi otentikasi yang Anda buat di akun Salesforce Anda.

         3. Pilih Simpan otentikasi.

   3. IAM peran —Pilih peran yang sudah ada atau buat IAM IAM peran baru untuk mengakses kredensi repositori dan mengindeks konten 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.

   4. Pilih Selanjutnya.

7. Pada halaman Konfigurasi pengaturan sinkronisasi, masukkan informasi berikut:

   1. Untuk lampiran Crawl —Pilih untuk meng-crawl semua objek, artikel, dan feed yang dilampirkan.

   2. Untuk objek Standar, artikel Pengetahuan, dan umpan obrolan —Pilih entitas Salesforce atau jenis konten yang ingin dirayapi.

      catatan

      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, nama artikel, dan apakah akan mengindeks bidang standar semua artikel pengetahuan atau hanya bidang jenis artikel khusus. Jika Anda memilih untuk mengindeks artikel kustom, Anda harus menentukan nama internal dari jenis artikel. Anda dapat menentukan hingga 10 jenis artikel.

   3. Frekuensi —Seberapa sering Amazon Kendra akan disinkronkan dengan sumber data Anda.

   4. Pilih Selanjutnya.

8. 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.

   2. Tambahkan bidang —Untuk menambahkan bidang sumber data kustom untuk membuat nama bidang indeks untuk dipetakan dan tipe data bidang.

   3. Pilih Selanjutnya.

9. 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 SalesforceConfigurationAPI berikut ini:

• URL Server —URL contoh untuk situs Salesforce yang ingin Anda indeks.

• 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"
  }

• IAM peran —Tentukan RoleArn kapan Anda menelepon CreateDataSource untuk memberikan IAM peran dengan izin untuk mengakses Secrets Manager rahasia Anda dan memanggil API publik yang diperlukan untuk konektor Salesforce dan. Amazon Kendra Untuk informasi selengkapnya, lihat IAM peran untuk sumber data Salesforce.

• Anda harus memberikan informasi konfigurasi untuk mengindeks setidaknya satu objek standar, artikel pengetahuan, atau umpan obrolan.

  • Objek standar —Jika Anda memilih untuk merayapi objek Standar, Anda harus menentukan nama objek standar dan nama bidang dalam tabel objek standar yang berisi konten dokumen.

  • Artikel pengetahuan —Jika Anda memilih untuk merayapi artikel Pengetahuan, Anda harus menentukan jenis artikel pengetahuan yang akan diindeks, status artikel pengetahuan yang akan diindeks, dan apakah akan mengindeks bidang standar semua artikel pengetahuan atau hanya bidang jenis artikel khusus.

  • Umpan obrolan —Jika Anda memilih untuk merayapi umpan Chatter, Anda harus menentukan nama kolom dalam tabel Salesforce FeedItem yang berisi konten yang akan diindeks.

Anda juga dapat menambahkan fitur opsional berikut:

• Filter inklusi dan pengecualian —Tentukan apakah akan menyertakan atau mengecualikan lampiran file 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 data Salesforce Anda ke bidang indeks Anda. Amazon Kendra Untuk informasi lebih lanjut, lihat Memetakan bidang sumber data.

  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.