Microsoft Exchange - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexiónMás informaciónNotas

Microsoft Exchange

Microsoft Exchange es una herramienta de colaboración empresarial para mensajería, reuniones e intercambio de archivos. Los usuarios de Microsoft Exchange pueden utilizar Amazon Kendra para indexar su origen de datos de Microsoft Exchange.

Puede conectar Amazon Kendra a su origen de datos de Microsoft Exchange mediante la consola de Amazon Kendra y la API TemplateConfiguration.

Para solucionar problemas del conector de origen de datos de Microsoft Exchange de Amazon Kendra, consulte Solución de problemas con los orígenes de datos.

Características admitidas

  • Asignaciones de campo

  • Control de acceso de usuarios

  • Filtros de inclusión/exclusión

  • Sincronizaciones del contenido completo e incremental

  • Nube privada virtual (VPC)

Requisitos previos

Antes de poder utilizar Amazon Kendra para indexar el origen de datos de Microsoft Exchange, realice estos cambios en sus cuentas de Microsoft Exchange y AWS.

En Microsoft Exchange, asegúrese de que:

  • Ha creado una cuenta de Microsoft Exchange en Office 365.

  • Ha apuntado su ID de inquilino de Microsoft 365. Puede encontrar su ID de inquilino en las propiedades de su portal de Azure Active Directory o en su aplicación OAuth.

  • Ha configurado una aplicación OAuth en el portal Azure y ha anotado el ID de cliente y el secreto de cliente o las credenciales de cliente. Consulte el Tutorial de Microsoft y el Ejemplo de aplicación registrada para obtener más información.

    nota

    Al crear o registrar una aplicación en el portal de Azure, el ID del secreto representa el valor del secreto real. Debe anotar o guardar el valor del secreto real inmediatamente al crear el secreto y la aplicación. Para acceder a su secreto, seleccione el nombre de la aplicación en el portal de Azure y, a continuación, vaya a la opción de menú relativa a los certificados y secretos.

    Puede acceder a su ID de cliente seleccionando el nombre de su aplicación en el portal de Azure y, a continuación, yendo a la página de información general. El ID de la aplicación (cliente) es el ID del cliente.

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

  • Ha agregado los siguientes permisos para la aplicación del conector:

    Microsoft Graph Office 365 Exchange Online

    • Mail.Read (Aplicación)

    • Mail.ReadBasic (Aplicación)

    • Mail.ReadBasic.All (Aplicación)

    • Calendars.Read (Aplicación)

    • User.Read.All (Aplicación)

    • Contacts.Read (Aplicación)

    • Notes.Read.All (aplicación)

    • Directory.Read.All (Aplicación)

    • EWS.AccessAsUser.All (Delegado)

    		 full_access_as_app (Aplicación)

  • Ha comprobado que cada documento es único en Microsoft Exchange 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 su Cuenta de AWS, asegúrese de que:

  • Ha creado un índice de Amazon Kendra y, si usa la API, ha anotado el ID del índice.

  • Ha creado un rol de IAM para el origen de datos y, si usa la API, ha anotado el ARN del rol de IAM.

    nota

    Si cambia el tipo de autenticación y las credenciales, debe actualizar el rol de IAM para acceder al ID secreto de AWS Secrets Manager correcto.

  • Ha guardado sus credenciales de autenticación de Microsoft Exchange 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 tiene un rol o secreto de IAM existente, puede usar la consola para crear un nuevo rol de IAM y secreto de Secrets Manager al conectar el origen de datos de Microsoft Exchange a Amazon Kendra. Si utiliza la API, debe proporcionar el ARN de un rol de IAM y un secreto de Secrets Manager existentes y un ID de índice.

Instrucciones de conexión

Para conectar Amazon Kendra al origen de datos de Microsoft Exchange, debe proporcionar los detalles necesarios del origen de datos de Microsoft Exchange para que Amazon Kendra pueda acceder a los datos. Si aún no ha configurado Microsoft Exchange para Amazon Kendra, consulte Requisitos previos.

Console

Para conectar Amazon Kendra a Microsoft Exchange

  1. Inicie sesión en Consola de administración de AWS y abra la consola de Amazon Kendra.

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

  3. En la página Introducción, seleccione Agregar origen de datos.

  4. En la página Agregar origen de datos, elija Conector de Microsoft Exchange y, a continuación, elija Agregar conector. Si usa la versión 2 (si corresponde), elija el Conector de Microsoft Exchange con la etiqueta V2.0.

  5. 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 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 Agregar nueva etiqueta: incluya etiquetas opcionales para buscar y filtrar los recursos o hacer un seguimiento de los costos de AWS.

    5. Elija Siguiente.

  6. En la página Definir acceso y seguridad, introduzca la siguiente información:

    1. ID de inquilina: introduzca su ID de inquilino de Microsoft 365. Puede encontrar su ID de inquilino en las propiedades de su portal de Azure Active Directory o en su aplicación OAuth.

    2. Autorización: active o desactive la información de la lista de control de acceso (ACL) para los documentos, si tiene una ACL y desea usarla 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.

    3. Secreto de AWS Secrets Manager: elija un secreto existente o cree un nuevo secreto de Secrets Manager para almacenar sus credenciales de autenticación de Microsoft Exchange. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager.

      1. Introduzca la siguiente información en la ventana Crear un secreto de AWS Secrets Manager:

        1. Nombre del secreto: un nombre para su secreto. El prefijo “AmazonKendra-Microsoft Exchange”

        2. Para ID de cliente, Secreto de cliente: introduzca las credenciales de autenticación que ha configurado en Microsoft Exchange en el portal de Azure.

      2. Guarde y agregue el secreto.

    4. Nube privada virtual (VPC): puede optar por utilizar una VPC. Si es así, debe agregar Subredes y Grupos de seguridad de VPC.

    5. Rol de IAM: elija un rol de IAM existente o cree un nuevo rol de IAM para acceder a las credenciales del repositorio y al contenido del índice.

      nota

      Los roles de IAM utilizados para los índices no se pueden usar para los orígenes 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.

    6. Elija Siguiente.

  7. En la página Configurar ajustes de sincronización, introduzca la siguiente información:

    1. ID de usuario: proporcione los correos electrónicos de los usuarios si quiere filtrar el contenido por determinados correos electrónicos.

    2. Configuración adicional: especifique los tipos de contenido que desee rastrear.

      • Tipos de entidad: puede elegir rastrear el contenido del calendario, de OneNotes o de los contactos.

      • Rastreo del calendario: introduzca la fecha de inicio y finalización para rastrear contenido entre fechas concretas.

      • Incluir correo electrónico: introduzca las líneas “para”, “de” y asunto del correo electrónico para filtrar determinados correos electrónicos que quiera rastrear.

      • Acceso a carpetas compartidas: elija habilitar el rastreo de la lista de control de acceso para controlar el acceso a su origen de datos de Microsoft Exchange.

      • Regex para dominios: añada patrones de expresiones regulares para incluir o excluir ciertos dominios de correo electrónico.

      • Patrones regex: añada patrones de expresiones regulares para incluir o excluir determinados archivos.

    3. Modo de sincronización: elija cómo desea actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar el origen de datos con Amazon Kendra por primera vez, todo el contenido se rastrea y se indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización.

      • Sincronización completa: se vuelve a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.

      • Sincronización nueva y modificada: se indexa solo contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.

      • Sincronización nueva y modificada: se indexa solo contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.

    4. En Programación de ejecución de sincronización, en Frecuencia: elija la frecuencia con la que desea sincronizar el contenido del origen de datos y actualizar el índice.

    5. Elija Siguiente.

  8. En la página Establecer asignaciones de campos, especifique la siguiente información:

    1. Campos de origen de datos predeterminados: seleccione uno de los campos de origen de datos predeterminados generados por Amazon Kendra que desee asignar al índice.

      nota

      El conector de origen de datos de Microsoft Exchange de Amazon Kendra no es compatible con asignaciones de campos personalizadas.

    2. Elija Siguiente.

  9. 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 conectar Amazon Kendra a Microsoft Exchange

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

  • Origen de datos: especifique el tipo de origen de datos como MSEXCHANGE cuando utiliza el esquema JSON de TemplateConfiguration. Especifique también el origen de datos como TEMPLATE al llamar a la API CreateDataSource.

  • ID de inquilino: puede encontrar su ID de inquilino en las propiedades de su portal de Azure Active Directory o en su aplicación OAuth.

  • Modo de sincronización: especifique cómo Amazon Kendra debe actualizar el índice cuando cambie el contenido del origen de datos. Al sincronizar el origen de datos con Amazon Kendra por primera vez, todo el contenido se rastrea y se indexa de forma predeterminada. Debe ejecutar una sincronización completa de los datos si la sincronización inicial falló, incluso si no selecciona la sincronización completa como opción de modo de sincronización. Puede elegir entre las siguientes opciones:

    • FORCED_FULL_CRAWL para volver a indexar todo el contenido, reemplazando el contenido existente cada vez que el origen de datos se sincronice con el índice.

    • FULL_CRAWL para indexar solo contenido nuevo, modificado y eliminado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.

    • CHANGE_LOG para indexar solo contenido nuevo y modificado cada vez que el origen de datos se sincronice con el índice. Amazon Kendra puede utilizar el mecanismo del origen de datos para realizar un seguimiento de los cambios en el contenido e indexar el contenido modificado desde la última sincronización.

  • Nombre de recurso de Amazon (ARN) de secreto: proporcione el nombre de recurso de Amazon (ARN) de un secreto de Secrets Manager que contenga las credenciales de autenticación para su cuenta de Microsoft Exchange. El secreto se almacena en una estructura JSON con las siguientes claves:

    {
    "clientId": "client ID",
    "clientSecret": "client secret"
}

  • Rol de IAM: especifique a RoleArn cuándo llamar a CreateDataSource para proporcionar a un rol de IAM permisos para acceder a su secreto de Secrets Manager y para llamar a las API públicas necesarias para el conector de Microsoft Exchange y Amazon Kendra. Para obtener más información, consulte Roles de IAM para orígenes de datos de Microsoft Exchange.

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 de Amazon Kendra para usar una Amazon VPC.

  • Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinado contenido.

    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.

  • Lista de control de acceso (ACL): especifique si se va a rastrear la información de la ACL para los documentos, si tiene una ACL y desea usarla 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.

  • Asignaciones de campos: elija asignar los campos del origen de datos de Microsoft Exchange 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 los documentos es obligatorio para que Amazon Kendra busque en los documentos. Debe asignar el nombre del campo del cuerpo del documento en el origen 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 Microsoft Exchange.

Más información

Para obtener más información acerca de la integración de Amazon Kendra con el origen de datos de Microsoft Exchange, consulte:

Notas

  • Cuando las listas de control de acceso (ACL) están habilitadas, la opción “Sincronizar solo el contenido nuevo o modificado” no está disponible debido a las limitaciones de la API de Microsoft Exchange. En su lugar, recomendamos usar los modos “Sincronización completa” o “Sincronización de contenido nuevo, modificado o eliminado”, o bien deshabilitar las ACL si necesita usar este modo de sincronización.