Connecteur Salesforce V2.0

Connectez-vous à la Amazon Kendra console Console de gestion AWS et ouvrez-la.

Dans le volet de navigation de gauche, choisissez Index, puis choisissez l'index que vous souhaitez utiliser dans la liste des index.

Sur la page Mise en route, choisissez Ajouter une source de données.

Sur la page Ajouter une source de données, choisissez le connecteur Salesforce, puis choisissez Ajouter un connecteur. Si vous utilisez la version 2 (le cas échéant), choisissez le connecteur Salesforce avec la balise V2.0 « ».

Sur la page Spécifier les détails de la source de données, entrez les informations suivantes :

1. Dans Nom et description, pour Nom de la source de données —Entrez un nom pour votre source de données. Vous pouvez inclure des tirets mais pas des espaces.

2. (Facultatif) Description —Entrez une description facultative pour votre source de données.

3. Dans la langue par défaut  : choisissez une langue pour filtrer vos documents en vue de l'index. Sauf indication contraire de votre part, la langue par défaut est l'anglais. La langue spécifiée dans les métadonnées du document remplace la langue sélectionnée.

4. Dans Tags, pour Ajouter une nouvelle étiquette  : incluez des balises facultatives pour rechercher et filtrer vos ressources ou suivre vos AWS coûts.

5. Choisissez Suivant.

Sur la page Définir l'accès et la sécurité, entrez les informations suivantes :

1. URL Salesforce  : entrez l'URL de l'instance du site Salesforce que vous souhaitez indexer.

2. Autorisation  : activez ou désactivez les informations de la liste de contrôle d'accès (ACL) pour vos documents, si vous possédez une ACL et souhaitez l'utiliser pour le contrôle d'accès. L'ACL spécifie les documents auxquels les utilisateurs et les groupes peuvent accéder. Les informations ACL sont utilisées pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Pour plus d'informations, consultez la section Filtrage contextuel des utilisateurs.

3. Entrez un secret existant ou, si vous créez un nouveau secret, une fenêtre AWS Secrets Manager secrète s'ouvre.

   1. Authentification : choisissez votre type d'authentification :

      • Flux d'informations d'identification du client (recommandé)  : utilise uniquement client_id et client_secret pour les intégrations de serveur à serveur.

      • Username-Password Flow (Legacy)  : utilise le nom d'utilisateur, le mot de passe, le jeton de sécurité, la clé du consommateur et le secret du consommateur. Obsolète par Salesforce à l'hiver 2027.

   2. Nom du secret : nom de votre secret. Le préfixe « AmazonKendra-Salesforce - » est automatiquement ajouté à votre nom secret.

   3. Pour le flux d'informations d'identification des clients :

      • Clé du consommateur  : identifiant du client provenant de votre application client externe Salesforce

      • Secret du consommateur  : secret client provenant de votre application client externe Salesforce

      • URL d'authentification  : URL de votre domaine (par exemple, https://<orgDomain>.my.salesforce.com/services/oauth2/token).

        Note

        https://login.salesforce.comet ne https://test.salesforce.com sont pas pris en charge pour ce flux.

   4. Pour Username-Password Flow :

      • Nom d'utilisateur  : votre nom d'utilisateur d'administrateur Salesforce

      • Mot de passe  : votre mot de passe administrateur Salesforce

      • Jeton de sécurité : jeton de sécurité pour votre compte Salesforce

      • Clé du consommateur  : identifiant client de votre application Salesforce Connected

      • Secret du consommateur  : secret client provenant de votre application Salesforce Connected

      • URL d'authentification  : pour Salesforce Developer Edition, utilisez https://login.salesforce.com/services/oauth2/token ou votre URL de connexion My Domain (par exemple). https://MyCompany.my.salesforce.com Pour Salesforce Sandbox Edition, utilisez https://test.salesforce.com/services/oauth2/token ou votre URL de connexion My Domain (par exemple, MyDomainName--SandboxName.sandbox.my.salesforce.com).

   5. Choisissez Enregistrer l'authentification.

4. Virtual Private Cloud (VPC)  : vous pouvez choisir d'utiliser un VPC. Si c'est le cas, vous devez ajouter des sous-réseaux et des groupes de sécurité VPC.

5. Identity crawler  : indiquez si vous souhaitez activer le robot Amazon Kendra d'identification. Le robot d'identification utilise les informations de la liste de contrôle d'accès (ACL) de vos documents pour filtrer les résultats de recherche en fonction de l'accès de l'utilisateur ou de son groupe aux documents. Si vous disposez d'une ACL pour vos documents et que vous choisissez d'utiliser votre ACL, vous pouvez également choisir d'activer le robot Amazon Kendra d'identification pour configurer le filtrage contextuel des résultats de recherche par utilisateur. Sinon, si le robot d’identité est désactivé, tous les documents peuvent faire l’objet d’une recherche publique. Si vous souhaitez utiliser le contrôle d'accès pour vos documents et que le robot d'identification est désactivé, vous pouvez également utiliser l'PutPrincipalMappingAPI pour télécharger les informations d'accès des utilisateurs et des groupes afin de filtrer le contexte utilisateur.

6. IAM rôle  : choisissez un IAM rôle existant ou créez-en un nouveau IAM pour accéder aux informations d'identification de votre référentiel et indexer le contenu.

   Note

   IAM les rôles utilisés pour les index ne peuvent pas être utilisés pour les sources de données. Si vous ne savez pas si un rôle existant est utilisé pour un index ou une FAQ, choisissez Créer un nouveau rôle pour éviter les erreurs.

7. Choisissez Suivant.

Sur la page Configurer les paramètres de synchronisation, entrez les informations suivantes :

1. Pour analyser les pièces jointes  : sélectionnez cette option pour analyser tous les objets Salesforce joints.

2. Pour les objets standard, les objets standard avec pièces jointes, les objets standard sans pièce jointe et les articles de connaissances, sélectionnez les entités Salesforce ou les types de contenu que vous souhaitez analyser.

3. Vous devez fournir des informations de configuration pour indexer au moins un objet standard, des articles de connaissances ou des fils de membres de la discussion. Si vous choisissez d'explorer les articles de connaissances, vous devez spécifier les types d'articles de connaissances à indexer. Vous pouvez choisir les documents publiés, archivés, les brouillons et les pièces jointes.

   Filtre Regex  : spécifiez un modèle regex pour inclure des éléments de catalogue spécifiques.

Pour une configuration supplémentaire  :

Mode de synchronisation  : choisissez la manière dont vous souhaitez mettre à jour votre index lorsque le contenu de votre source de données change. Lorsque vous synchronisez votre source de données Amazon Kendra pour la première fois, tout le contenu est analysé et indexé par défaut. Vous devez exécuter une synchronisation complète de vos données si votre synchronisation initiale a échoué, même si vous n'avez pas sélectionné la synchronisation complète comme mode de synchronisation.

Choisissez Suivant.

Sur la page Définir les mappages de champs, entrez les informations suivantes :

1. Pour l'article de connaissances standard, les pièces jointes aux objets standard et les mappages de champs supplémentaires suggérés  : sélectionnez parmi les champs de source de données par défaut Amazon Kendra générés que vous souhaitez mapper à votre index.

   Note

   Un mappage d'index vers _document_body est requis. Vous ne pouvez pas modifier le mappage entre le champ Salesforce ID et le champ Amazon Kendra _document_id . Vous pouvez mapper n'importe quel champ Salesforce au titre du document ou aux champs d' reserved/default index Amazon Kendra du corps du document.

   Si vous associez un champ Salesforce aux champs du titre et du corps du document Amazon Kendra, Amazon Kendra utilisera les données des champs du titre et du corps du document dans les réponses de recherche.

2. Ajouter un champ —Pour ajouter des champs de source de données personnalisés afin de créer un nom de champ d'index à mapper et le type de données du champ.

3. Choisissez Suivant.

Sur la page Réviser et créer, vérifiez que les informations que vous avez saisies sont correctes, puis sélectionnez Ajouter une source de données. Vous pouvez également choisir de modifier vos informations depuis cette page. Votre source de données apparaîtra sur la page Sources de données une fois que la source de données aura été ajoutée avec succès.