Salesforce-Konnektor V1.0 - Amazon Kendra
Unterstützte FeaturesVoraussetzungenAnweisungen zur Verbindung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Salesforce-Konnektor V1.0

Salesforce ist ein Tool für das Kundenbeziehungsmanagement (CRM) zur Verwaltung von Support-, Vertriebs- und Marketingteams. Sie können Amazon Kendra damit Ihre Salesforce-Standardobjekte und sogar benutzerdefinierte Objekte indizieren.

Wichtig

Amazon Kendra verwendet die API Salesforce-Version 48. Salesforce API begrenzt die Anzahl der Anfragen, die Sie pro Tag stellen können. Wenn Salesforce diese Anfragen überschreitet, versucht es erneut, bis es fortfahren kann.

Anmerkung

Salesforce Connector V1.0/ SalesforceConfiguration API endete 2023. Wir empfehlen, zu Salesforce Connector V2.0/zu migrieren oder diesen zu verwenden. TemplateConfiguration API

Informationen zur Fehlerbehebung bei Ihrem Amazon Kendra Salesforce-Datenquellen-Connector finden Sie unter. Problembehandlung bei Datenquellen

Unterstützte Features

Amazon Kendra Der Salesforce-Datenquellen-Connector unterstützt die folgenden Funktionen:

  • Feldzuordnungen

  • Steuerung des Benutzerzugriffs

  • Einschluss-/Ausschlussfilter

Voraussetzungen

Bevor Sie Ihre Salesforce-Datenquelle Amazon Kendra zum Indizieren verwenden können, nehmen Sie diese Änderungen in Ihrem Salesforce und Ihren Accounts vor. AWS

Stellen Sie in Salesforce sicher, dass Sie über Folgendes verfügen:

  • Sie haben ein Salesforce-Konto erstellt und den Benutzernamen und das Passwort notiert, die Sie für die Verbindung mit Salesforce verwenden.

  • Sie haben ein Salesforce Connected App-Konto mit OAuth aktiviertem Konto erstellt und den Verbraucherschlüssel (Client-ID) und das Verbrauchergeheimnis (Kundengeheimnis) kopiert, die Ihrer Salesforce Connected-Anwendung zugewiesen sind. Die Client-ID und der geheime Kundenschlüssel werden als Ihre in einem AWS Secrets Manager Secret gespeicherten Authentifizierungsdaten verwendet. Weitere Informationen finden Sie in der Salesforce-Dokumentation zu verbundenen Anwendungen.

    Anmerkung

    Wir empfehlen Ihnen, Ihre Anmeldeinformationen und Ihr Geheimnis regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

  • Das Salesforce-Sicherheitstoken wurde kopiert, das dem Konto zugeordnet ist, das für die Verbindung mit Salesforce verwendet wurde.

  • Das URL der Salesforce-Instanz, die Sie indizieren möchten, wurde kopiert. In der Regel ist das https://<company>.salesforce.com/. Auf dem Server muss eine mit Salesforce verbundene Anwendung ausgeführt werden.

  • Sie haben Ihrem Salesforce-Server Anmeldeinformationen für einen Benutzer mit Lesezugriff auf Salesforce hinzugefügt, indem Sie das ReadOnly Profil geklont und anschließend die Berechtigungen „Alle Daten anzeigen“ und „Artikel verwalten“ hinzugefügt haben. Diese Anmeldeinformationen identifizieren den Benutzer, der die Verbindung herstellt, und die verbundene Salesforce-Anwendung, Amazon Kendra mit der eine Verbindung hergestellt wird.

  • Aktiviert, dass jedes Dokument in Salesforce und in anderen Datenquellen, die Sie für denselben Index verwenden möchten, einzigartig ist. Jede Datenquelle, die Sie für einen Index verwenden möchten, darf nicht dasselbe Dokument in allen Datenquellen enthalten. Dokumente IDs gelten für einen Index global und müssen pro Index eindeutig sein.

Stellen Sie in Ihrem sicher AWS-Konto, dass Sie Folgendes haben:

  • Hat einen Amazon Kendra Index erstellt und, falls Sie den verwendet habenAPI, die Index-ID notiert.

  • Sie haben eine IAM Rolle für Ihre Datenquelle erstellt und, falls Sie die verwendenAPI, ARN die IAM Rolle notiert.

    Anmerkung

    Wenn Sie Ihren Authentifizierungstyp und Ihre Anmeldeinformationen ändern, müssen Sie Ihre IAM Rolle aktualisieren, um auf die richtige AWS Secrets Manager geheime ID zugreifen zu können.

  • Sie haben Ihre Salesforce-Authentifizierungsdaten AWS Secrets Manager geheim gespeichert und, falls Sie den verwendenAPI, den ARN Geheimcode notiert.

    Anmerkung

    Wir empfehlen Ihnen, Ihre Anmeldeinformationen und Ihr Geheimnis regelmäßig zu aktualisieren oder zu wechseln. Stellen Sie zu Ihrer eigenen Sicherheit nur die Zugriffsebene bereit, die erforderlich ist. Wir raten davon ab, Anmeldeinformationen und geheime Daten für alle Datenquellen und Connector-Versionen 1.0 und 2.0 (sofern zutreffend) wiederzuverwenden.

Wenn Sie noch keine IAM Rolle oder keinen Schlüssel haben, können Sie die Konsole verwenden, um eine neue IAM Rolle und ein neues Secrets Manager Geheimnis zu erstellen, wenn Sie Ihre Salesforce-Datenquelle mit verbinden. Amazon Kendra Wenn Sie das verwendenAPI, müssen Sie die einer vorhandenen IAM Rolle und ARN eines Secrets Manager Geheimnisses sowie eine Index-ID angeben.

Anweisungen zur Verbindung

Um eine Verbindung Amazon Kendra zu Ihrer Salesforce-Datenquelle herzustellen, müssen Sie die erforderlichen Details zu Ihrer Salesforce-Datenquelle angeben, damit Sie auf Ihre Daten zugreifen Amazon Kendra können. Falls Sie Salesforce noch nicht konfiguriert haben, Amazon Kendra sehen Sie nachVoraussetzungen.

Console

Um eine Verbindung Amazon Kendra zu Salesforce herzustellen

  1. Melden Sie sich bei der AWS Management Console an und öffnen Sie die Amazon Kendra Konsole.

  2. Wählen Sie im linken Navigationsbereich Indizes und dann den Index, den Sie verwenden möchten, aus der Indexliste aus.

    Anmerkung

    Sie können Ihre Einstellungen für die Benutzerzugriffskontrolle unter Indexeinstellungen konfigurieren oder bearbeiten.

  3. Wählen Sie auf der Seite Erste Schritte die Option Datenquelle hinzufügen aus.

  4. Wählen Sie auf der Seite Datenquelle hinzufügen die Option Salesforce Connector V1.0 und dann Connector hinzufügen aus.

  5. Geben Sie auf der Seite „Datenquellendetails angeben“ die folgenden Informationen ein:

    1. Datenquellenname — Geben Sie einen Namen für Ihre Datenquelle ein. Sie können Bindestriche, aber keine Leerzeichen verwenden.

    2. (Optional) Beschreibung — Geben Sie eine optionale Beschreibung für Ihre Datenquelle ein.

    3. Standardsprache — Eine Sprache, um Ihre Dokumente nach dem Index zu filtern. Sofern Sie nichts anderes angeben, ist die Standardsprache Englisch. Die in den Metadaten angegebene Sprache hat Vorrang vor der ausgewählten Sprache.

    4. Neues Tag hinzufügen — Stichwörter, mit denen du deine Ressourcen durchsuchen und filtern oder deine gemeinsamen Kosten verfolgen kannst.

    5. Wählen Sie Weiter.

  6. Geben Sie auf der Seite Zugriff und Sicherheit definieren die folgenden Informationen ein:

    1. Salesforce URL — Geben Sie die Instanz URL für die Salesforce-Site ein, die Sie indexieren möchten.

    2. Wählen Sie unter Authentifizierungstyp zwischen Bestehend und Neu, um Ihre Salesforce-Authentifizierungsdaten zu speichern. Wenn Sie sich dafür entscheiden, ein neues Geheimnis zu erstellen, wird ein AWS Secrets Manager geheimes Fenster geöffnet.

      1. Geben Sie die folgenden Informationen in das Fenster Create an AWS Secrets Manager Secret ein:

        1. Geheimer Name — Ein Name für Ihr Geheimnis. Das Präfix 'AmazonKendra-Salesforce-' wird Ihrem geheimen Namen automatisch hinzugefügt.

        2. URLGeben Sie für Benutzername, Passwort, Sicherheitstoken, Verbraucherschlüssel, Verbrauchergeheimnis und Authentifizierung die Werte für die Authentifizierungsdaten ein, die Sie in Ihrem Salesforce-Konto erstellt haben.

        3. Wählen Sie Authentifizierung speichern aus.

    3. IAM Rolle — Wählen Sie eine bestehende IAM Rolle oder erstellen Sie eine neue IAM Rolle, um auf Ihre Repository-Anmeldeinformationen und Indexinhalte zuzugreifen.

      Anmerkung

      IAM Rollen, die für Indizes verwendet werden, können nicht für Datenquellen verwendet werden. Wenn Sie sich nicht sicher sind, ob eine vorhandene Rolle für einen Index verwendet wirdFAQ, wählen Sie Neue Rolle erstellen, um Fehler zu vermeiden.

    4. Wählen Sie Weiter.

  7. Geben Sie auf der Seite Synchronisierungseinstellungen konfigurieren die folgenden Informationen ein:

    1. Für Crawl-Anlagen — Wählen Sie diese Option, um alle angehängten Objekte, Artikel und Feeds zu crawlen.

    2. Wählen Sie für Standardobjekte, Knowledge-Artikel und Chatter-Feeds die Salesforce-Entitäten oder Inhaltstypen aus, die Sie crawlen möchten.

      Anmerkung

      Sie müssen Konfigurationsinformationen für die Indizierung mindestens eines der Standardobjekte, Wissensartikel oder Chatter-Feeds angeben. Wenn Sie Knowledge-Artikel crawlen möchten, müssen Sie die Typen von Wissensartikeln, die indexiert werden sollen, den Namen der Artikel angeben und angeben, ob die Standardfelder aller Wissensartikel oder nur die Felder eines benutzerdefinierten Artikeltyps indexiert werden sollen. Wenn Sie benutzerdefinierte Artikel indizieren möchten, müssen Sie den internen Namen des Artikeltyps angeben. Sie können bis zu 10 Artikeltypen angeben.

    3. Häufigkeit — Wie oft Amazon Kendra wird mit Ihrer Datenquelle synchronisiert.

    4. Wählen Sie Weiter.

  8. Geben Sie auf der Seite Feldzuordnungen festlegen die folgenden Informationen ein:

    1. Für den Artikel Standardwissen, Standardobjektanhänge und Zusätzliche vorgeschlagene Feldzuordnungen — Wählen Sie aus den Amazon Kendra generierten Standard-Datenquellenfeldern aus, die Sie Ihrem Index zuordnen möchten.

      Anmerkung

      Eine Indexzuordnung zu _document_body ist erforderlich. Sie können die Zuordnung zwischen dem Salesforce ID Feld und dem Amazon Kendra _document_id Feld nicht ändern.

    2. Feld hinzufügen — Um benutzerdefinierte Datenquellenfelder hinzuzufügen, um einen Indexfeldnamen für die Zuordnung und den Felddatentyp zu erstellen.

    3. Wählen Sie Weiter.

  9. Überprüfen Sie auf der Seite Überprüfen und erstellen, ob die von Ihnen eingegebenen Informationen korrekt sind, und wählen Sie dann Datenquelle hinzufügen aus. Sie können Ihre Informationen auch auf dieser Seite bearbeiten. Ihre Datenquelle wird auf der Seite Datenquellen angezeigt, nachdem die Datenquelle erfolgreich hinzugefügt wurde.

API

Um eine Verbindung Amazon Kendra zu Salesforce herzustellen

Sie müssen Folgendes angeben SalesforceConfigurationAPI:

  • Server URL — Die Instanz URL für die Salesforce-Site, die Sie indizieren möchten.

  • Geheimer Amazon-Ressourcenname (ARN) — Geben Sie den Amazon-Ressourcennamen (ARN) eines Secrets Manager Geheimnisses ein, das die Authentifizierungsdaten für Ihr Salesforce-Konto enthält. Das Geheimnis wird in einer JSON Struktur mit den folgenden Schlüsseln gespeichert:

    {
    "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 Rolle — Geben Sie anRoleArn, wann Sie anrufenCreateDataSource, um einer IAM Rolle Berechtigungen für den Zugriff auf Ihr Secrets Manager Geheimnis und für das Aufrufen der erforderlichen Öffentlichkeit APIs für den Salesforce-Connector und Amazon Kendra zu erteilen. Weitere Informationen finden Sie unter IAM Rollen für Salesforce-Datenquellen.

  • Sie müssen Konfigurationsinformationen für die Indizierung mindestens eines der Standardobjekte, Wissensartikel oder Chatter-Feeds bereitstellen.

    • Standardobjekte — Wenn Sie Standardobjekte crawlen möchten, müssen Sie den Namen des Standardobjekts und den Namen des Felds in der Standardobjekttabelle angeben, das den Dokumentinhalt enthält.

    • Knowledge-Artikel — Wenn Sie Knowledge-Artikel crawlen möchten, müssen Sie die Typen der zu indizierenden Wissensartikel, den Status der zu indizierenden Wissensartikel und angeben, ob die Standardfelder aller Wissensartikel oder nur die Felder eines benutzerdefinierten Artikeltyps indexiert werden sollen.

    • Chatter-Feeds — Wenn Sie Chatter-Feeds crawlen möchten, müssen Sie den Namen der Spalte in der FeedItem Salesforce-Tabelle angeben, die den zu indizierenden Inhalt enthält.

Sie können auch die folgenden optionalen Funktionen hinzufügen:

  • Inklusions- und Ausschlussfilter — Geben Sie an, ob bestimmte Dateianhänge ein- oder ausgeschlossen werden sollen.

    Anmerkung

    Die meisten Datenquellen verwenden Muster für reguläre Ausdrücke, bei denen es sich um Ein- oder Ausschlussmuster handelt, die als Filter bezeichnet werden. Wenn Sie einen Einschlussfilter angeben, werden nur Inhalte indexiert, die dem Einschlussfilter entsprechen. Jedes Dokument, das nicht dem Einschlussfilter entspricht, wird nicht indexiert. Wenn Sie einen Ein- und Ausschlussfilter angeben, werden Dokumente, die dem Ausschlussfilter entsprechen, nicht indexiert, auch wenn sie dem Einschlussfilter entsprechen.

  • Feldzuordnungen — Wählen Sie diese Option, um Ihre Salesforce-Datenquellenfelder Ihren Indexfeldern zuzuordnen. Amazon Kendra Weitere Informationen finden Sie unter Zuweisen von Datenquellenfeldern.

    Anmerkung

    Das Textfeld oder das entsprechende Textfeld für Ihre Dokumente ist erforderlich, um Ihre Dokumente durchsuchen Amazon Kendra zu können. Sie müssen den Feldnamen Ihres Dokumenthauptteils in Ihrer Datenquelle dem Namen des Indexfeldes zuordnen_document_body. Alle anderen Felder sind optional.

  • Benutzerkontextfilterung und ZugriffskontrolleAmazon Kendra — durchsucht die Zugriffskontrollliste (ACL) für Ihre Dokumente, sofern Sie eine ACL für Ihre Dokumente haben. Die ACL Informationen werden verwendet, um Suchergebnisse nach dem Benutzer- oder Gruppenzugriff auf Dokumente zu filtern. Weitere Informationen finden Sie unter Benutzerkontextfilterung.