Box

Rastrear documentos almacenados en un origen de datos de Box.

IBM Cloud Pak for Data IBM Software Hub

Esta información sólo se aplica a los despliegues instalados. Para obtener más información sobre cómo conectarse a Box desde un despliegue gestionado, consulte Box.

Qué documentos se rastrean

Solo se rastrean los documentos que están respaldados por Discovery en sus carpetas de Box; todos los demás se ignoran. Para obtener más información, consulte Tipos de archivo soportados.
La seguridad a nivel de documento solo está soportada para los conectores configurados para utilizar la App + Enterprise Access como nivel de acceso de aplicación de la aplicación Box. Cuando esta opción está habilitada, los usuarios pueden rastrear y consultar el mismo contenido al que pueden acceder cuando inician sesión en Box. Para obtener más información, consulte Soporte de seguridad de nivel de documento.
Cuando se vuelve a rastrear una fuente, se añaden nuevos documentos, se modifican los documentos actualizados a la versión actual y se eliminan los documentos eliminados del índice de la colección.
Todos los conectores de origen de datos Discovery son de sólo lectura. Independientemente de los permisos otorgados a la cuenta de rastreo, Discovery nunca graba, actualiza o suprime ningún contenido del origen de datos original.
Las notas de Box se almacenan en formato JSON, por lo que Discovery también incorpora cualquier nota de Box en las carpetas especificadas.

Requisitos de orígenes de datos

Además de los requisitos de origen de datos para todos los despliegues instalados, el origen de datos de Box debe cumplir el requisito siguiente:

Debe obtener las licencias de servicio necesarias para el origen de datos al que desea conectarse. Para obtener más información sobre las licencias, póngase en contacto con el administrador del sistema del origen de datos.

Pasos de requisito previo

Si desea habilitar la seguridad de nivel de documento, debe realizar algunos pasos para configurarla. Para obtener más información, consulte Acerca de la seguridad de nivel de documento.

Debe crear una aplicación personalizada en Box para poder conectarse a Box desde Discovery. Cualquiera puede crear la aplicación personalizada, pero sólo un administrador de Box puede autorizarla.

Para crear una aplicación personalizada, siga estos pasos:

Asegúrese de tener una cuenta Box. Durante este proceso, obtendrá el archivo de configuración y el ID de cliente.
A continuación, cree una app personalizada que utilice Autenticación de servidor con JWT como método de autenticación.

Para obtener información detallada, consulte Configuración con JWT en la documentación para desarrolladores de Box.

Siga estas directrices al crear la aplicación:
1. Durante el procedimiento de configuración, elija utilizar el método Autenticación de servidor con JWT para verificar la identidad de la aplicación con un par de claves.
2. Elija el nivel de acceso adecuado para el contenido de Box que desea rastrear:
  - Archivos de Box que se comparten con usuarios gestionados: Acceso a la aplicación más acceso a la empresa
  - Archivos de Box que se comparten con la cuenta de servicio: Solo acceso de aplicación
  - Archivos de Box que se comparten con la cuenta de servicio y sus usuarios de aplicación: Solo acceso de aplicación
  El soporte para configurar el acceso de nivel de Box con acceso de aplicación solo se ha añadido con el release 4.6.
3. Configure el nivel de acceso siguiendo los pasos adecuados para el tipo de nivel de acceso de la app:
  - Acceso a la aplicación más acceso a la empresa
    
    Elija los siguientes ámbitos de aplicación:
    - Leer todas las carpetas almacenadas en Box
    - Escribir todas las carpetas almacenadas en Box
    - Gestionar usuarios
    Habilite la siguiente función avanzada:
    - Generar tokens de acceso de usuario
  - Solo acceso a la aplicación
    
    Para rastrear archivos que se comparten sólo con la cuenta de servicio, realice los pasos siguientes:
    1. Elija los siguientes ámbitos de aplicación:
      - Leer todas las carpetas almacenadas en Box
      - Escribir todas las carpetas almacenadas en Box
    2. Comparta las carpetas y archivos de Box de destino con la cuenta de servicio realizando los pasos siguientes:
      1. En la página Valores generales, copie el correo electrónico para el ID de cuenta de servicio.
      2. Cuando haya iniciado la sesión como usuario gestionado, comparta la carpeta o los archivos que desea que el conector pueda rastrear.
      3. Añada el correo electrónico de ID de cuenta de servicio como persona para invitar a compartir los archivos.
      Para obtener más información, consulte la documentación de Box.
    Para rastrear los archivos que se comparten con la cuenta de servicio y sus usuarios de app, realice los pasos siguientes:
    1. Elija los siguientes ámbitos de aplicación:
      - Leer todas las carpetas almacenadas en Box
      - Escribir todas las carpetas almacenadas en Box
      - Gestionar usuarios
    2. Habilite la siguiente función avanzada:
      - Generar tokens de acceso de usuario
    3. Comparta las carpetas y archivos de Box de destino con los usuarios de la aplicación adecuados.
      
      Para obtener más información, consulte la documentación de Box.
Cree claves para la autenticación. Asegúrese de completar las tareas siguientes:
1. En la página Valores generales, pulse Añadir una clave pública.
2. Guarde el archivo de configuración descargado que se genera para la clave privada.
3. Pulse Guardar cambios.
4. En la página Configuración, copie el valor ID de cliente.
A continuación, debe solicitar a un administrador de Box que autorice la aplicación. En la consola de administración de Box, realice las tareas siguientes:
1. En la página Aplicaciones > Gestor de aplicaciones personalizadas, pulse Añadir aplicación.
2. Especifique el ID de cliente y, a continuación, pulse Siguiente.
  
  Para obtener más información, consulte Aprobación de aplicación personalizada.
Paso de administrador de Box: Desde la consola de administración de Box, compruebe que la información de la aplicación sea precisa y, a continuación, pulse Autorizar.

Conexión con el origen de datos de Box

En el proyecto Discovery, realice los pasos siguientes:

En el panel de navegación, elija Gestionar colecciones.
Haga clic en Nueva colección.
Haga clic en Cuadro y, a continuación, haga clic en Siguiente.
Asigne un nombre a la colección.
Si el idioma de los documentos en Box no es el inglés, seleccione el idioma apropiado.

Para ver una lista de los idiomas admitidos, consulte Soporte de idiomas.
Opcional. Cambie la planificación de sincronización.

Para obtener más información, consulte Opciones de planificación de rastreo.
En la sección Especifique sus credenciales, pulse Seleccionar archivo y, a continuación, examine para buscar el archivo de configuración que se ha generado y descargado al añadir la clave pública como parte de los pasos de requisito previo.

Puede volver a descargar un archivo de configuración desde la página de configuración del sitio de Box Developer.
Opcional. En la sección Especificar lo que desea rastrear, elija un contenido de usuario específico o una carpeta específica con el contenido que desea rastrear. Si no especifica nada, el servicio rastrea todo el contenido que está disponible para la app personalizada.
- Para rastrear una empresa completa, especifique box://app.box.com/.
- Para rastrear una carpeta específica, introduzca box://app.box.com/user/USER'S_ACCOUNT_ID/folder/FOLDER_ID/FolderName.
  
  Por ejemplo, box://example.app.box.com/user/460250779/folder/158001591642/My Folder
- Para rastrear a un usuario específico, introduzca box://app.box.com/user/USER'S_ACCOUNT_ID/.
Opcional: si utiliza un servidor proxy para acceder al servidor de origen de datos, en la sección Valores de proxy, establezca el conmutador Habilitar valores de proxy en On. Añada valores a los campos siguientes:

Nombre de usuario

Opcional. El nombre de usuario que utiliza para autenticarse, si el servidor proxy requiere autenticación. Si no conoce su nombre de usuario, puede obtenerlo del administrador del servidor proxy.

Contraseña

Opcional. La contraseña que utiliza para autenticarse, si el servidor proxy requiere autenticación. Si no conoce su contraseña, puede obtenerla del administrador del servidor proxy.

Nombre de host o dirección IP del servidor proxy

El nombre de host o la dirección IP del servidor proxy.

Número de puerto del servidor proxy

El puerto de red al que desea conectarse en el servidor proxy.
Opcional. Si desea activar la seguridad de nivel de documento, en la sección Seguridad, establezca el conmutador Habilitar seguridad de nivel de documento en On.

Cuando esta opción está habilitada, los usuarios pueden rastrear y consultar el mismo contenido al que pueden acceder cuando inician sesión en Box. Para obtener más información, consulte Soporte de seguridad de nivel de documento.
Si desea que el rastreador extraiga texto de imágenes en el sitio, expanda Más valores de procesoy establezca Aplicar reconocimiento óptico de caracteres (OCR) en On.

Cuando OCR está habilitado y los documentos contienen imágenes, el proceso tarda más tiempo. Para obtener más información, consulte Reconocimiento de caracteres ópticos.
Pulse Finalizar.

La colección se crea rápidamente. Los datos tardan más tiempo en procesarse a medida que se añaden a la colección.

Si desea comprobar el progreso, vaya a la página Actividad. En el panel de navegación, pulse Gestionar colecciones y, a continuación, pulse para abrir la colección.