Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Salesforce Connector V1.0
Salesforce es una herramienta de gestión de relaciones con los clientes (CRM) para administrar los equipos de soporte, ventas y marketing. Puede utilizarlo Amazon Kendra para indexar sus objetos estándar de Salesforce e incluso objetos personalizados.
Amazon Kendra utiliza la versión 48 de la API de Salesforce. La API de Salesforce limita la cantidad de solicitudes que se pueden realizar por día. Si Salesforce supera esas solicitudes, lo volverá a intentar hasta que pueda continuar.
Está previsto que el soporte para el conector SalesforceConfiguration V1.0/API de Salesforce finalice en 2023. Recomendamos migrar o utilizar el conector V2.0/API de Salesforce. TemplateConfiguration
Para solucionar problemas de su conector de fuente de datos de Amazon Kendra Salesforce, consulte. Solución de problemas con los orígenes de datos
Características admitidas
Amazon Kendra El conector de fuente de datos de Salesforce admite las siguientes funciones:
Requisitos previos
Antes de poder utilizarla Amazon Kendra para indexar su fuente de datos de Salesforce, realice estos cambios en Salesforce y AWS en sus cuentas.
En Salesforce, asegúrese de que:
-
Ha creado una cuenta de Salesforce y ha anotado el nombre de usuario y la contraseña que utiliza para conectarse a Salesforce.
-
Ha creado una cuenta de la aplicación Salesforce Connected con OAuth activada y ha copiado la clave de consumidor (ID de cliente) y el secreto de consumidor (secreto de cliente) asignados a la aplicación Salesforce Connected. El ID de cliente y el secreto del cliente se utilizan como credenciales de autenticación almacenadas en un AWS Secrets Manager secreto. Consulte la Documentación de Salesforce sobre aplicaciones conectadas para obtener más información.
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
-
Ha copiado el token de seguridad de Salesforce asociado a la cuenta utilizada para conectarse a Salesforce.
-
Ha copiado la URL de la instancia de Salesforce que desea indexar. Normalmente, es https://<company>.salesforce.com/. El servidor debe ejecutar una aplicación conectada de Salesforce.
-
Se agregaron credenciales a su servidor de Salesforce para un usuario con acceso de solo lectura a Salesforce. Para ello, clonó el ReadOnly perfil y, a continuación, agregó los permisos Ver todos los datos y Administrar artículos. Estas credenciales identifican al usuario que realiza la conexión y a la aplicación conectada de Salesforce a la que se conecta. Amazon Kendra
-
Ha comprobado que cada documento es único en Salesforce y en otros orígenes de datos que vaya a utilizar para el mismo índice. Cada origen de datos que desee utilizar para un índice no debe contener el mismo documento en varios orígenes de datos. Los ID de documento son globales para un índice y deben ser únicos por índice.
En la suya Cuenta de AWS, asegúrese de tener:
-
Creó un Amazon Kendra índice y, si usa la API, anotó el ID del índice.
-
Creó un IAM rol para su fuente de datos y, si usa la API, anotó el ARN del IAM rol.
Si cambias el tipo de autenticación y las credenciales, debes actualizar tu IAM rol para acceder al ID AWS Secrets Manager secreto correcto.
-
Ha guardado sus credenciales de autenticación de Salesforce en un secreto de AWS Secrets Manager y, si utiliza la API, ha anotado el ARN del secreto.
Le recomendamos que actualice o modifique con regularidad las credenciales y el secreto. Por su propia seguridad, proporcione solo el nivel de acceso necesario. No se recomienda volver a utilizar las credenciales y los datos secretos en varios orígenes de datos ni en las versiones 1.0 y 2.0 del conector (si procede).
Si no tiene un IAM rol o secreto existente, puede usar la consola para crear un nuevo IAM rol y un Secrets Manager secreto al conectar su fuente de datos de Salesforce. Amazon Kendra Si utiliza la API, debe proporcionar el ARN de un IAM rol y un Secrets Manager secreto existentes y un ID de índice.
Instrucciones de conexión
Para conectarse Amazon Kendra a su fuente de datos de Salesforce, debe proporcionar los detalles necesarios de su fuente de datos de Salesforce para que Amazon Kendra pueda acceder a sus datos. Si aún no ha configurado Salesforce para consultarlo. Amazon Kendra Requisitos previos
- Console
-
Para conectarse a Amazon Kendra Salesforce
-
Inicie sesión en la consola AWS de administración y abra la Amazon Kendra consola.
-
En el panel de navegación izquierdo, elija Índices y, a continuación, elija el índice que desee usar de la lista de índices.
Puede elegir configurar o editar los ajustes de Control de acceso de usuarios en la Configuración del índice.
-
En la página Introducción, seleccione Agregar origen de datos.
-
En la página Agregar origen de datos, seleccione Salesforce Connector V1.0 y, a continuación, seleccione Añadir conector.
-
En la página Especificar detalles del origen de datos, introduzca la siguiente información:
-
Nombre de origen de datos: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.
-
(Opcional) Descripción: introduzca una descripción opcional para el origen de datos.
-
Idioma predeterminado: un idioma para filtrar los documentos para el índice. A menos que especifique lo contrario, el idioma predeterminado es el inglés. El idioma especificado en los metadatos anula el idioma seleccionado.
-
Agregar nueva etiqueta: etiquetas para buscar y filtrar los recursos o hacer un seguimiento de los costos compartidos.
-
Elija Siguiente.
-
En la página Definir acceso y seguridad, introduzca la siguiente información:
-
URL de Salesforce: introduzca la URL de la instancia para el sitio de Salesforce que desea indexar.
-
En Tipo de autenticación, elija entre Existente y Nuevo para almacenar las credenciales de autenticación de Salesforce. Si decide crear un secreto nuevo, se abrirá una ventana AWS
Secrets Manager secreta.
-
Introduzca la siguiente información en la ventana Crear un secreto de AWS
Secrets Manager :
-
Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-Salesforce-» se añade automáticamente a su nombre secreto.
-
En Nombre de usuario, Contraseña, Token de seguridad, Clave de consumidor, Secreto del consumidor y URL de autenticación, introduzca los valores de las credenciales de autenticación que creó en la cuenta de Salesforce.
-
Seleccione Guardar autenticación.
-
IAM rol: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del repositorio y al contenido del índice.
IAM los roles utilizados para los índices no se pueden usar para las fuentes de datos. Si no está seguro de si un rol existente se utiliza para un índice o para las preguntas frecuentes, elija Crear un nuevo rol para evitar errores.
-
Elija Siguiente.
-
En la página Configurar ajustes de sincronización, introduzca la siguiente información:
-
En Rastrear archivos adjuntos: seleccione esta opción para rastrear todos los objetos, artículos y feeds adjuntos.
-
En Objetos estándar, Artículos de conocimiento y Fuente de chat, seleccione las entidades o los tipos de contenido de Salesforce que desee rastrear.
Debe proporcionar información de configuración para indexar al menos uno de los objetos estándar, artículos de conocimiento o fuentes de chat. Si decide rastrear los Artículos de conocimiento, debe especificar los tipos de artículos de conocimiento que desea indexar, el nombre de los artículos y si desea indexar los campos estándar de todos los artículos de conocimiento o solo los campos de un tipo de artículo personalizado. Si decide indexar artículos personalizados, debe especificar el nombre interno del tipo de artículo. Puede especificar hasta 10 tipos de artículos.
-
Frecuencia: la frecuencia con la Amazon Kendra que se sincronizará con la fuente de datos.
-
Elija Siguiente.
-
En la página Establecer asignaciones de campos, especifique la siguiente información:
-
Para ver el artículo de conocimiento estándar, los archivos adjuntos a objetos estándar y las asignaciones de campos sugeridas adicionales, seleccione entre los campos de fuentes de datos predeterminados Amazon Kendra generados que desee asignar a su índice.
Es necesaria una asignación de índice a _document_body. No puede cambiar la asignación entre el campo Salesforce ID y el campo _document_id de Amazon Kendra
.
-
Agregar campo: para agregar campos de origen de datos personalizados para crear un nombre de campo de índice al que asignarlos y el tipo de datos del campo.
-
Elija Siguiente.
-
En la página Revisar y crear, compruebe que la información que ha introducido es correcta y, a continuación, seleccione Añadir origen de datos. También puede elegir editar la información desde esta página. El origen de datos aparecerá en la página Orígenes de datos una vez que el origen de datos se haya agregado correctamente.
- API
-
Para conectarse a Salesforce Amazon Kendra
Debe especificar lo siguiente en la SalesforceConfigurationAPI:
-
URL del servidor: la URL de la instancia para el sitio de Salesforce que desea indexar.
-
Nombre secreto del recurso de Amazon (ARN): proporcione el nombre del recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación de su cuenta de Salesforce. El secreto se almacena en una estructura JSON con las siguientes claves:
{
"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 rol: especifique RoleArn cuándo llama CreateDataSource para proporcionar un IAM rol con permisos para acceder a su Secrets Manager secreto y para llamar a las API públicas requeridas para el conector de Salesforce y. Amazon Kendra Para obtener más información, consulte Roles de IAM para orígenes de datos de Salesforce.
-
Debe proporcionar información de configuración para indexar al menos uno de los objetos estándar, artículos de conocimiento o fuentes de chat.
-
Objetos estándar: si decide rastrear los Objetos estándar, debe especificar el nombre del objeto estándar y el nombre del campo de la tabla de objetos estándar que contiene el contenido del documento.
-
Artículos de conocimiento: si decide rastrear los Artículos de conocimiento, debe especificar los tipos de artículos de conocimiento que desea indexar, los estados de los artículos de conocimiento que desea indexar y si quiere indexar los campos estándar de todos los artículos de conocimiento o solo los campos de un tipo de artículo personalizado.
-
Fuentes de Chatter: si decide rastrear las fuentes de Chatter, debe especificar el nombre de la columna de la FeedItem tabla de Salesforce que contiene el contenido que se va a indexar.
También puede añadir las siguientes características opcionales:
-
Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinados archivos adjuntos.
La mayoría de los orígenes de datos utilizan patrones de expresiones regulares, que son patrones de inclusión o exclusión denominados filtros. Si especifica un filtro de inclusión, solo se indexará el contenido que coincida con el filtro de inclusión. Los documentos que no coincidan con el filtro de inclusión no se indexan. Si especifica un filtro de inclusión y exclusión, los documentos que coincidan con el filtro de exclusión no se indexarán, aunque coincidan con el filtro de inclusión.
-
Asignaciones de campos: elija asignar los campos del origen de datos de Salesforce a los campos de índice de Amazon Kendra . Para obtener más información, consulte Asignación de campos de origen de datos.
El campo del cuerpo del documento o el cuerpo del documento equivalente de sus documentos es obligatorio para Amazon Kendra poder buscarlos. Debe asignar el nombre del campo del cuerpo del documento en la fuente de datos al nombre del campo de índice_document_body. Todos los demás campos son opcionales.
-
Filtrado por contexto de usuario y control de acceso:Amazon Kendra rastrea la lista de control de acceso (ACL) de sus documentos, si tiene una ACL para ellos. La información de la ACL se utiliza para filtrar los resultados de búsqueda en función del acceso del usuario o su grupo a los documentos. Para obtener más información, consulte Filtrado de contexto de usuario.
