Uso de un origen de datos de Box - Amazon Kendra

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.

Uso de un origen de datos de Box

Puede utilizar la plataforma de contenido de Box como fuente de datos paraAmazon Kendra. Para utilizar Box en la consola de, vaya a laAmazon Kendraconsola, selecciona tu índice y, a continuación, seleccionaOrígenes de datosdesde el menú de navegación para agregar Box.

Cuando se conecta a Box para indexar los documentos, especifica el ID de empresa de Box. Por ejemplo,801234567. Puede especificar patrones de expresiones regulares para incluir o excluir archivos y carpetas específicos dentro de la plataforma Box. También puede especificar si desea incluir enlaces web, comentarios y tareas con los archivos.

Debe crear un índice antes de crear el origen de datos Box. Para obtener más información, consulteCreación de un índice. Proporciona el ID del índice al crear el origen de datos.

Para conectarse a Box, especifique la conexión y otra información en la consola o mediante elConfiguración de cajasobjeto. Puede encontrar el ID de empresa en la configuración de Box Developer Console o cuando crea una aplicación en Box y descarga las credenciales de autenticación.

También debe proporcionar el nombre de recurso de Amazon (ARN) de unIAMrol que conceda permiso a para obtener acceso a la plataforma Box. Proporciona el ARN de unIAMfunción mediante laCreateDataSourceAPI. Para obtener más información acerca de los permisos de, consulteIAMroles para fuentes de datos de Box.

Amazon Kendrarequiere credenciales de autenticación para acceder a la plataforma Box. Consulte Autenticación.

Amazon Kendratambién rastrea la información de usuario y grupo desde la instancia de Box. Esto resulta útil para el filtrado de contexto de usuario, donde los resultados de búsqueda se filtran en función del acceso del usuario o de su grupo a los documentos. Para obtener más información, consulteFiltrado de contexto de usuario para fuentes de datos de Box.

También puede agregar la siguiente información opcional:

  • Ya seaAmazon Kendradebe indexar el contenido de los comentarios de sus documentos. Cada comentario se indexa como documento independiente.

  • Ya seaAmazon Kendradebe utilizar el mecanismo de registro de cambios de Box para determinar si el contenido debe actualizarse en el índice. Utilice el registro de cambios si no lo deseaAmazon Kendrapara escanear todo el contenido. Si el registro de cambios es grande, podría tardarAmazon Kendramenos tiempo para escanear contenido en Box que para procesar el registro de cambios. Si sincroniza la fuente de datos de Box con el índice por primera vez, se escanea todo el contenido.

  • Patrón de inclusión o exclusión: Si especifica un patrón de inclusión, ningún archivo, documento o carpeta que no coincida con el patrón no se indexará. Si especifica un patrón de inclusión y exclusión, el contenido que coincida con el patrón de exclusión no se indexará aunque coincida con el patrón de inclusión.

  • Asignaciones de campos que asignan los campos Box aAmazon Kendracampos de índice. Para obtener más información, consulteAsignación de campos de origen de datos.

Autenticación

Las credenciales de autenticación para acceder a la plataforma Box deben incluir lo siguiente:

  • ID de cliente

  • secreto de cliente

  • ID de clave pública

  • clave privada

  • Frase de contraseña

Crea una aplicación en Box Developer Console para generar estas credenciales. Almacena las credenciales de Box en unAWS Secrets Managersecreto de. Si utiliza laAmazon Kendraconsola para crear el origen de datos, puede crear el secreto mientras crea el origen de datos. O bien, puede utilizar un sistema existenteSecrets Managersecreto de. Si utiliza la API para crear su origen de datos, deberá proporcionar el nombre de recurso de Amazon (ARN) de un secreto existente.

Las credenciales se almacenan como una cadena JSON en elSecrets Managersecreto de.

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

Para crear una aplicación en Box

  1. Inicie sesión endeveloper.box.comaplicación de escritorio. Debe ser un usuario con permisos administrativos o tener la aplicación aprobada por un usuario con permisos administrativos.

  2. SelectMY Appsen el menú de navegación y, a continuación, seleccioneCrear una nueva aplicación.

  3. ElegirAutenticación de servidor (con JWT).

  4. Especifique un nombre para la aplicación. Por ejemplo,kendra_box_app. A continuación, seleccioneCrear aplicación.

  5. En la aplicación creada enMY Apps, seleccione laConfiguraciónpestaña.

  6. En el navegadorNivel de acceso a aplicacionessección, elijaAcceso empresarial a la aplicación +.

  7. En el navegadorÁmbitos de la aplicación, elija los siguientes permisos:

    • Escribir todos los archivos y carpetas almacenados en una caja

    • Administrar usuarios

    • Administración de grupos de

    • Administrar propiedades empresariales

  8. En el navegadorCaracterísticas avanzadassección, elijaRealizar llamadas a la API utilizando el encabezado como usuario.

  9. En el navegadorAgregar y administrar claves públicassección, seleccioneAñadir una clave pública. En primer lugar, debe crear una autenticación de dos factores. Para hacerlo, seleccione.Configuraciónen la ventana emergente o yendo a la configuración de su cuenta y creando autenticación de dos factores.

  10. SelectGenerar un par de claves público/privadoy, a continuación, seleccioneDescargar como JSON.

  11. Vaya al directorio de descargas de su equipo y abra el archivo config.json. Copie el ID de cliente, el secreto del cliente, el ID de clave pública, la clave privada y la frase de contraseña. Lo necesitará cuando cree laSecrets Managersecreto para el origen de datos de Box.