Características admitidas Requisitos previos Instrucciones de conexión

Adobe Experience Manager

Adobe Experience Manager es un sistema de gestión de contenido que se utiliza para crear contenido de sitios web o aplicaciones móviles. Puede usarlo Amazon Kendra para conectarse a sus páginas Adobe Experience Manager y activos de contenido e indexarlos.

Amazon Kendra admite Adobe Experience Manager (AEM) como instancia de autor de Cloud Service y como instancia de autor y publicación Adobe Experience Manager local.

Puede conectarse Amazon Kendra a su fuente de Adobe Experience Manager datos mediante la Amazon Kendra consola o la TemplateConfigurationAPI.

Para solucionar problemas del conector de fuentes de datos de Amazon Kendra Adobe Experience Manager, consulteSolución de problemas con los orígenes de datos.

Características admitidas

El conector de origen de datos de Adobe Experience Manager admite las siguientes características:

Asignaciones de campo
Control de acceso de usuarios
Filtros de inclusión/exclusión
Sincronizaciones de contenido completas e incrementales
Autenticación OAuth 2.0 y básica
Nube privada virtual (VPC)

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de Adobe Experience Manager datos, realice estos cambios en sus AWS cuentas Adobe Experience Manager y.

En Adobe Experience Manager, asegúrese de que:

Tiene acceso a una cuenta con privilegios administrativos o un usuario administrador.
Ha copiado la URL del host de Adobe Experience Manager.

nota
(local o en el servidor) Amazon Kendra comprueba si la información de punto final incluida AWS Secrets Manager es la misma que la información de punto final especificada en los detalles de configuración de la fuente de datos. Esto ayuda a evitar el problema del suplente confuso, que es un problema de seguridad en el que un usuario no tiene permiso para realizar una acción, pero utiliza Amazon Kendra como proxy para acceder al secreto configurado y realizar la acción. Si más adelante cambia la información de punto de conexión, debe crear un nuevo secreto para sincronizar esta información.
Ha apuntado las credenciales de autenticación básica del nombre de usuario y la contraseña del administrador.

nota
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).
Opcional: se configuraron las credenciales de OAuth 2.0 en Adobe Experience Manager (AEM) como un servicio en la nube o en las instalaciones de AEM. Si utiliza AEM On-Premise, las credenciales incluyen el ID de cliente, el secreto del cliente y la clave privada. Si utiliza AEM as a Cloud Service, las credenciales incluyen el ID de cliente, el secreto del cliente, la clave privada, el ID de la organización, el ID de la cuenta técnica y el host de Adobe Identity Management System (IMS). Para obtener más información sobre cómo generar estas credenciales para AEM as a Cloud Service, consulte la documentación de Adobe Experience Manager. En el caso de AEM On-Premise, la implementación del servidor OAuth 2.0 de Adobe Granite (com.adobe.granite.oauth.server) es compatible con las funcionalidades del servidor OAuth 2.0 en AEM.
Ha comprobado que cada documento es único en Adobe Experience Manager 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 las suyas Cuenta de AWS, asegúrate 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.

nota
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 Adobe Experience Manager en un secreto de AWS Secrets Manager y, si utiliza la API, ha anotado el ARN del secreto.

nota
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 tienes un IAM rol o secreto existente, puedes usar la consola para crear un nuevo IAM rol y Secrets Manager secreto al conectar tu fuente de datos de Adobe Experience Manager a 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 Adobe Experience Manager datos, debe proporcionar los detalles necesarios de la fuente de Adobe Experience Manager datos para que Amazon Kendra pueda acceder a sus datos. Si aún no lo ha configurado Adobe Experience Manager Amazon Kendra, consulteRequisitos previos.

Console

Para conectarse Amazon Kendra a Adobe Experience Manager

Inicie sesión en la Amazon Kendra consola AWS Management Console y ábrala.
En el panel de navegación izquierdo, elija Índices y, a continuación, elija el índice que desee usar de la lista de índices.

nota
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 Añadir fuente de datos, seleccione el conector Adobe Experience Manager y, a continuación, seleccione Añadir conector. Si utiliza la versión 2 (si corresponde), elija el conector Adobe Experience Manager con la etiqueta «V2.0".
En la página Especificar detalles del origen de datos, introduzca la siguiente información:
1. En Nombre y descripción, en Nombre del origen de datos: introduzca un nombre para el origen de datos. Puede incluir guiones, pero no espacios.
2. (Opcional) Descripción: introduzca una descripción opcional para el origen de datos.
3. En el idioma predeterminado: elija 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 del documento anula el idioma seleccionado.
4. En Etiquetas, para añadir una nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar sus recursos o realizar un seguimiento de sus AWS costes.
5. Elija Siguiente.
En la página Definir acceso y seguridad, introduzca la siguiente información:
1. Origen: elija AEM On-Premise o AEM as a Cloud Service.
  
  Introduzca la URL del host de Adobe Experience Manager. Por ejemplo, si utiliza AEM On-Premise, debe incluir el nombre de host y el puerto: https://hostname:port. O bien, si usa AEM as a Cloud Service, puede usar la URL del autor: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com.
2. Ubicación del certificado SSL: introduzca la ruta al certificado SSL almacenado en un bucket de Amazon S3 . Se utiliza para conectarse a AEM On-Premise mediante una conexión SSL segura.
3. Autorización: active o desactive la información de la lista de control de acceso (ACL) de sus documentos, si tiene una ACL y desea utilizarla para el control de acceso. La ACL especifica a qué documentos pueden acceder los usuarios y los grupos. 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.
4. Autenticación: elija la autenticación básica o la autenticación OAuth 2.0. A continuación, elija un AWS Secrets Manager secreto existente o cree uno nuevo para almacenar sus Adobe Experience Manager credenciales. Si decides crear un secreto nuevo, se abrirá una ventana AWS Secrets Manager secreta.
  
  Si ha elegido la autenticación básica, introduzca un nombre para el secreto, el nombre de usuario del sitio de Adobe Experience Manager y la contraseña. El usuario debe tener permiso de administrador o ser un usuario administrador.
  
  Si ha elegido la autenticación OAuth 2.0 y utiliza AEM On-Premise, introduzca un nombre para el secreto, el ID de cliente, el secreto de cliente y la clave privada. Si utiliza AEM as a Cloud Service, introduzca un nombre para el secreto, el ID de cliente, el secreto del cliente, la clave privada, el ID de la organización, el ID de la cuenta técnica y el host de Adobe Identity Management System (IMS).
  
  Guarda y añade tu secreto.
5. Nube privada virtual (VPC): puede optar por utilizar una VPC. Si es así, debe agregar Subredes y Grupos de seguridad de VPC.
6. Rastreador de identidad: especifique si se debe activar el rastreador Amazon Kendra de identidad. El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o de su grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el filtrado Amazon Kendra de los resultados de búsqueda según el contexto del usuario. De lo contrario, si el rastreador de identidades está desactivado, se pueden realizar búsquedas públicas en todos los documentos. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la PutPrincipalMappingAPI para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
7. IAM rol: elija un IAM rol existente o cree uno nuevo IAM para acceder a las credenciales del repositorio y al contenido del índice.
  
  nota
  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.
8. Elija Siguiente.
En la página Configurar ajustes de sincronización, introduzca la siguiente información:
1. Ámbito de sincronización: establezca límites para rastrear determinados tipos de contenido, componentes de páginas y rutas raíz y filtre el contenido mediante patrones de expresiones regex.
  1. Tipos de contenido: elija si deseas rastrear solo las páginas o los activos, o ambos.
  2. (Opcional) Configuración adicional: configure los siguientes ajustes:
    - Componentes de página: los nombres específicos de los componentes de página. El componente de página es un componente de página extensible diseñado para funcionar con el editor de plantillas de Adobe Experience Manager y permite ensamblar los componentes de encabezado/pie de página y estructura con el editor de plantillas.
    - Variaciones de fragmentos de contenido: los nombres específicos de las variaciones de fragmentos de contenido. Los fragmentos de contenido le permiten diseñar, crear, seleccionar y publicar contenido independiente de la página en Adobe Experience Manager. Le permiten preparar contenido listo para su uso en múltiples ubicaciones o en múltiples canales.
    - Rutas raíz: las rutas raíz a contenido específico.
    - Patrones regex: patrones de expresiones regulares para incluir o excluir determinadas páginas y recursos.
2. Modo de sincronización: elija cómo desea actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar la fuente de datos Amazon Kendra por primera vez, todo el contenido se rastrea e indexa de forma predeterminada. Debes realizar una sincronización completa de los datos si la sincronización inicial ha fallado, incluso si no seleccionas la sincronización completa como opción de modo de sincronización.
  - Sincronización completa: indexa todo el contenido de forma inmediata y reemplaza el contenido existente cada vez que la fuente de datos se sincronice con el índice.
  - Sincronización nueva y modificada: indexe solo el contenido nuevo y modificado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
  - Sincronización nueva, modificada o eliminada: indexe solo el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
3. ID de zona horaria: si utiliza AEM On-Premise y la zona horaria del servidor es diferente a la zona horaria del conector o índice de AEM de Amazon Kendra , puede especificar la zona horaria del servidor para alinearla con el conector o índice de AEM. La zona horaria predeterminada de AEM On-Premise es la zona horaria del conector o índice de AEM de Amazon Kendra . La zona horaria predeterminada de AEM as a Cloud Service es la hora media de Greenwich.
4. Calendario de ejecución de sincronización, para frecuencia: elija la frecuencia con la que desea sincronizar el contenido de la fuente de datos y actualizar el índice.
5. Elija Siguiente.
En la página Establecer asignaciones de campos, especifique la siguiente información:
1. Seleccione uno de los campos de fuente de datos predeterminados Amazon Kendra generados que desee asignar a su índice. Para agregar campos de origen de datos personalizados, cree un nombre de campo de índice para asignarlos y el tipo de datos del campo.
2. 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 Amazon Kendra a Adobe Experience Manager

Debe especificar un JSON del esquema del origen de datos mediante la API TemplateConfiguration. Debe proporcionar la siguiente información:

Fuente de datos: especifique el tipo de fuente de datos como AEM cuando utiliza el esquema TemplateConfigurationJSON. Especifique también la fuente de datos TEMPLATE al llamar a la CreateDataSourceAPI.
URL del host de AEM: especifique la URL del host de Adobe Experience Manager. Por ejemplo, si utiliza AEM On-Premise, debe incluir el nombre de host y el puerto: https://hostname:port. O bien, si usa AEM as a Cloud Service, puede usar la URL del autor: https://author-xxxxxx-xxxxxxx.adobeaemcloud.com.
Modo de sincronización: especifique cómo Amazon Kendra debe actualizarse el índice cuando cambie el contenido de la fuente de datos. Al sincronizar la fuente de datos Amazon Kendra por primera vez, todo el contenido se rastrea e indexa de forma predeterminada. Debes realizar una sincronización completa de los datos si la sincronización inicial ha fallado, incluso si no seleccionas la sincronización completa como opción de modo de sincronización. Puede elegir entre las siguientes opciones:
- FORCED_FULL_CRAWLpara indexar todo el contenido de forma actualizada, sustituyendo el contenido existente cada vez que la fuente de datos se sincronice con el índice.
- FULL_CRAWLpara indexar solo el contenido nuevo, modificado y eliminado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
- CHANGE_LOGpara indexar solo el contenido nuevo y modificado cada vez que la fuente de datos se sincronice con el índice. Amazon Kendra puede usar el mecanismo de la fuente de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido que ha cambiado desde la última sincronización.
Tipo de autenticación: especifique qué tipo de autenticación quiere usar, ya sea Basic o OAuth2.
Tipo de AEM: especifique qué tipo de Adobe Experience Manager va a utilizar, ya sea CLOUD o ON_PREMISE.
Nombre de recurso de Amazon (ARN) secreto: si desea utilizar la autenticación básica para AEM On-Premise o Cloud, debe proporcionar un secreto que almacene las credenciales de autenticación de su nombre de usuario y contraseña. Usted proporciona el nombre de recurso de Amazon (ARN) de un AWS Secrets Manager secreto. El secreto se almacena en una estructura JSON con las siguientes claves:
```
{
    "aemUrl": "Adobe Experience Manager On-Premise host URL",
    "username": "user name with admin permissions",
    "password": "password with admin permissions"
}
```
Si quiere utilizar la autenticación OAuth 2.0 para AEM On-Premise, el secreto se almacena en una estructura JSON con las siguientes claves:
```
{
    "aemUrl": "Adobe Experience Manager host URL",
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key"
}
```
Si quiere utilizar la autenticación OAuth 2.0 para AEM as a Cloud Service, el secreto se almacena en una estructura JSON con las siguientes claves:
```
{
    "clientId": "client ID",
    "clientSecret": "client secret",
    "privateKey": "private key",
    "orgId": "organization ID",
    "technicalAccountId": "technical account ID",
    "imsHost": "Adobe Identity Management System (IMS) host"
}
```
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 necesarias para el conector de Adobe Experience Manager y. Amazon Kendra Para obtener más información, consulte Roles de IAM para orígenes de datos de Adobe Experience Manager.

También puede añadir las siguientes características opcionales:

Nube privada virtual (VPC): especifique a VpcConfiguration cuándo llamar a CreateDataSource. Para obtener más información, consulte Configuración Amazon Kendra para usar un Amazon VPC.
ID de zona horaria: si utiliza AEM On-Premise y la zona horaria del servidor es diferente a la zona horaria del conector o índice de Amazon Kendra AEM, puede especificar la zona horaria del servidor para alinearla con el conector o índice de AEM.

La zona horaria predeterminada de AEM On-Premise es la zona horaria del conector o índice de AEM. Amazon Kendra La zona horaria predeterminada de AEM as a Cloud Service es la hora media de Greenwich.

Para obtener información sobre los ID de zonas horarias compatibles, consulte Esquema JSON de Adobe Experience Manager.
Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinadas páginas y activos.

nota
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.
Rastreador de identidades: especifique si se debe activar el rastreador de identidades. Amazon Kendra El rastreador de identidades utiliza la información de la lista de control de acceso (ACL) de los documentos para filtrar los resultados de la búsqueda en función del acceso del usuario o de su grupo a los documentos. Si tiene una ACL para sus documentos y decide utilizarla, también puede optar por activar el rastreador de identidades para configurar el filtrado Amazon Kendra de los resultados de búsqueda según el contexto del usuario. De lo contrario, si el rastreador de identidades está desactivado, se pueden realizar búsquedas públicas en todos los documentos. Si quieres usar el control de acceso para tus documentos y el rastreador de identidad está desactivado, también puedes usar la PutPrincipalMappingAPI para cargar información de acceso de usuarios y grupos para filtrar el contexto de los usuarios.
Asignaciones de campos: elija asignar los campos del origen de datos de Adobe Experience Manager a los campos de índice de Amazon Kendra . Para obtener más información, consulte Asignación de campos de origen de datos.

nota
El campo del cuerpo del documento o el cuerpo del documento equivalente de sus documentos es obligatorio Amazon Kendra para 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.

Para obtener una lista de otras claves JSON importantes que debe configurar, consulte el Esquema de plantilla de Adobe Experience Manager.

Aviso JavaScript está desactivado o no está disponible en su navegador.

Para utilizar la documentación de AWS, debe estar habilitado JavaScript. Para obtener más información, consulte las páginas de ayuda de su navegador.

Convenciones del documento

Esquemas de plantillas de origen de datos

Alfresco

Adobe Experience Manager

Temas

Características admitidas

Requisitos previos

nota

nota

nota

nota

Instrucciones de conexión

nota

nota

nota

nota