Box (Cuadro) - Amazon Kendra
Características admitidasRequisitos previosInstrucciones de conexiónMás información

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.

Box (Cuadro)

Box es un servicio de almacenamiento en la nube que ofrece capacidades de alojamiento de archivos. Puedes usarlo Amazon Kendra para indexar el contenido de tu Box, incluidos los comentarios, las tareas y los enlaces web.

Puedes conectarte Amazon Kendra a tu fuente de datos de Box mediante la Amazon Kendra consola y el BoxConfigurationAPI.

Para solucionar problemas del conector de fuente de datos de Amazon Kendra Box, consultaSolución de problemas con los orígenes de datos.

Características admitidas

Amazon Kendra El conector de fuente de datos de Box admite las siguientes funciones:

  • Asignaciones de campo

  • Control de acceso de usuarios

  • Filtros de inclusión/exclusión

  • El registro de cambios y las sincronizaciones de contenido completas e incrementales

  • Nube privada virtual () VPC

Requisitos previos

Antes de poder utilizarla Amazon Kendra para indexar la fuente de datos de Box, realiza estos cambios en Box y en tus AWS cuentas.

En Box, asegúrese de que:

  • Tiene una cuenta Box Enterprise o Box Enterprise Plus.

  • Configuró una aplicación personalizada de Box en la consola de desarrolladores de Box, con autenticación del lado del servidor mediante JSON Web Tokens ()JWT. Consulte la documentación de Box sobre la creación de una aplicación personalizada y la documentación de Box sobre la configuración de JWT Auth para obtener más información.

  • Establezca el nivel de acceso a la aplicación en App + Enterprise Access y permita que realice API llamadas utilizando el encabezado como usuario.

  • Ha usado el usuario administrador para agregar los siguientes Ámbitos de aplicación en su aplicación Box:

    • Escribir todos los archivos y carpetas almacenados en un Box

    • Administración de usuarios

    • Administrar grupos

    • Administrar propiedades empresariales

  • Par de claves pública/privada configurado que incluye un ID de cliente, un secreto de cliente, un ID de clave pública, un ID de clave privada, una contraseña y un ID empresarial para usar como credenciales de autenticación. Consulte Par de claves públicas y privadas para obtener más información.

    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 copiado el ID empresarial de Box de la configuración de la consola para desarrolladores de Box o de la aplicación Box. Por ejemplo: 801234567.

  • Ha comprobado que cada documento es único en Box 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. IDsLos documentos son globales para un índice y deben ser únicos por índice.

En el tuyo Cuenta de AWS, asegúrate de tener:

  • Creó un Amazon Kendra índice y, si lo usaAPI, anotó el ID del índice.

  • Creó un IAM rol para la fuente de datos yAPI, si lo usó, anotó el ARN 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.

  • Guardó sus credenciales de autenticación de Box en un AWS Secrets Manager secreto yAPI, si las usó, anotó el ARN 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 IAM rol o secreto existente, puede usar la consola para crear un nuevo IAM rol y Secrets Manager secreto al conectar su fuente de datos de Box Amazon Kendra. Si usa elAPI, debe proporcionar el ARN IAM rol y el Secrets Manager secreto existentes y un ID de índice.

Instrucciones de conexión

Para conectarse Amazon Kendra a su fuente de datos de Box, debe proporcionar los detalles necesarios de su fuente de datos de Box para Amazon Kendra poder acceder a sus datos. Si todavía no has configurado Box for Amazon Kendra, consultaRequisitos previos.

Console

Para conectarse Amazon Kendra a Box

  1. Inicia sesión en la Amazon Kendra consola AWS Management Console y ábrela.

  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 Añadir fuente de datos, selecciona el conector Box y, a continuación, selecciona Añadir conector. Si utiliza la versión 2 (si corresponde), elija el conector Box 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 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 Next (Siguiente).

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

    1. ID empresarial de Box: introduzca el ID empresarial de Box. Por ejemplo: 801234567.

    2. 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. ACLEspecifica a qué documentos pueden acceder los usuarios y los grupos. La ACL información se utiliza para filtrar los resultados de la 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. AWS Secrets Manager secreto: elija un secreto existente o cree uno nuevo Secrets Manager para almacenar sus credenciales de autenticación de Box. Si decide crear un secreto nuevo, se abrirá una ventana de secreto de AWS Secrets Manager .

      1. Nombre del secreto: un nombre para su secreto. El prefijo «AmazonKendra-Box» se añade automáticamente a su nombre secreto.

      2. Para el identificador de cliente, el secreto de cliente, el identificador de clave pública, el identificador de clave privada y la contraseña, introduzca los valores de la clave pública o privada que configuró en Box.

      3. Añada y guarde su secreto.

    4. Nube privada virtual (VPC): puede optar por utilizar unaVPC. Si es así, debe agregar subredes y grupos de VPCseguridad.

    5. Rastreador de identidades: especifique si se debe activar el rastreador Amazon Kendra de identidades. 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 su grupo a los documentos. Si tiene uno ACL para sus documentos y decide usar el suyoACL, también puede optar por activar el rastreador de identidad 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 identidad está desactivado, se pueden buscar públicamente todos los documentos. Si desea usar el control de acceso para sus documentos y el rastreador de identidad está desactivado, también puede usarlo PutPrincipalMappingAPIpara cargar la información de acceso de los usuarios y grupos para filtrar el contexto de los usuarios.

    6. 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 se utiliza un rol existente para un índiceFAQ, o bien, elija Crear un nuevo rol para evitar errores.

    7. Elija Next (Siguiente).

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

    1. Archivos de caja: elija si desea rastrear los enlaces web, los comentarios y las tareas.

    2. Para una configuración adicional: añada patrones de expresiones regulares para incluir o excluir cierto contenido.

    3. 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 eliges 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.

    4. Calendario de ejecución sincronizado para la frecuencia: elija la frecuencia con la que desea sincronizar el contenido de la fuente de datos y actualizar el índice.

    5. Elija Next (Siguiente).

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

    1. Campos de fuente de datos predeterminados: seleccione entre los campos de fuente de datos predeterminados Amazon Kendra generados que desee asignar a su índice.

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

    3. Elija Next (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 conectarse Amazon Kendra a Box

Debe especificar lo siguiente mediante BoxConfigurationAPI:

ID empresarial de Box: proporcione el ID empresarial de Box. Puede encontrar el ID empresarial en la configuración de Box Developer Console o al configurar una aplicación en Box.

  • Nombre secreto del recurso de Amazon (ARN): proporciona el nombre del recurso de Amazon (ARN) de un Secrets Manager secreto que contenga las credenciales de autenticación de tu cuenta de Box. El secreto se guarda en una JSON estructura con las siguientes claves:

    {
    "clientID": "client-id",
    "clientSecret": "client-secret",
    "publicKeyID": "public-key-id",
    "privateKey": "private-key",
    "passphrase": "pass-phrase"
}

  • IAM rol: especifique RoleArn cuándo llamar CreateDataSource para proporcionar a un IAM rol permisos para acceder a su Secrets Manager secreto y para llamar al público requerido APIs para el conector Box y Amazon Kendra. Para obtener más información, consulte Roles de IAM para orígenes de datos de Box.

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

  • Nube privada virtual (VPC): especifíquelo VpcConfiguration como parte de la configuración de la fuente de datos. Consulte Configurar Amazon Kendra para usar un VPC.

  • Registro de cambios: si se Amazon Kendra debe utilizar el mecanismo de registro de cambios de la fuente de datos de Box para determinar si un documento debe actualizarse en el índice.

    nota

    Utilice el registro de cambios si no quiere que Amazon Kendra digitalice todos los documentos. Si el registro de cambios es grande, es posible que se tarde Amazon Kendra menos en digitalizar los documentos de la fuente de datos de Box que en procesar el registro de cambios. Si está sincronizando el origen de datos de Box con su índice por primera vez, se escanean todos los documentos.

  • Comentarios, tareas y enlaces web: especifique si desea rastrear este tipo de 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.

  • Filtros de inclusión y exclusión: especifique si desea incluir o excluir determinados archivos y carpetas de Box.

    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.

  • 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 lista ACL de sus documentos. La ACL información se utiliza para filtrar los resultados de la 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 Box 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.

Más información

Para obtener más información sobre la integración Amazon Kendra con la fuente de datos de Box, consulte: