Para acceder a los datos de Box, cree un activo de conexión para el mismo.
La plataforma Box es un servicio de gestión de contenido de nube y de uso compartido de archivos.
Requisitos previos
Copy link to section
Crear una aplicación personalizada en Box
Copy link to section
Para poder crear una conexión a Box, cree una aplicación personalizada en Box Developer Console. Puede crear una aplicación para el acceso a nivel de aplicación que los usuarios pueden utilizar para compartir archivos, o puede crear una aplicación para el acceso de toda la empresa a todas las cuentas de usuario. Con el acceso de toda la empresa, los usuarios no necesitan compartir archivos y carpetas con la aplicación.
Vaya a Box Developer Console y siga el asistente para crear una Aplicación personalizada. Para el Método de autenticación, seleccione OAuth 2.0 with JWT (Server Authentication).
Realice las siguientes selecciones en la página Configuración. Si lo desea puede conservar los valores predeterminados.
Seleccione una de las dos opciones para Nivel de acceso a aplicaciones:
Mantenga la selección de Solo acceso a aplicaciones predeterminada para permitir el acceso donde los usuarios comparten archivos.
Seleccione App + Acceso a la empresa para crear una aplicación con acceso de toda la empresa a todas las cuentas de usuario.
En Añadir y gestionar claves públicas, pulse Generar un par de claves pública/privada. Esta selección requiere que la autenticación de dos factores esté habilitada en la cuenta de Box, pero puede inhabilitarla después. El par de claves generado genera un archivo de configuración (*_config.json) para que lo descargue. Necesitará la información de este archivo para crear la conexión en el proyecto.
Si ha seleccionado App + Acceso a empresa en Características avanzadas, marque ambos recuadros de selección:
Realizar llamadas de API utilizando la cabecera as-user
Generar señales de acceso de usuarios
Envíe el ID de cliente de la aplicación al administrador de empresa de Box para obtener autorización: Vaya a la aplicación en Box Developer Console y seleccione el enlace General de la barra lateral izquierda de la aplicación. Desplácese hacia abajo hasta la sección Autorización de aplicaciones.
Descifrar una clave privada
Copy link to section
Para descifrar una clave privada utilizando su contraseña asociada, ejecute el siguiente comando. Este proceso utiliza el comando " openssl pkcs8 " para generar una versión no cifrada de la clave privada.
Especifique los valores del archivo de configuración descargado para estos valores:
ID de cliente
Secreto de cliente
ID de empresa
Clave privada (Sustituya cada \n por una nueva línea)
Contraseña de clave privada (El valor passphrase en el archivo de configuración)
Clave pública (El valor publicKeyID en el archivo de configuración)
Aplicación en toda la empresa
Copy link to section
Si ha configurado una aplicación de acceso para toda la empresa, especifique el nombre de usuario de la cuenta de usuario de Box en el campo Nombre.
Aplicación a nivel de aplicación
Copy link to section
Los usuarios deben compartir de forma explícita sus archivos con la dirección de correo electrónico de la aplicación para que la aplicación acceda a los archivos.
Realice una llamada REST a la conexión para averiguar la dirección de correo electrónico de la aplicación. Por ejemplo:
PUT https://api.dataplatform.cloud.ibm.com/v2/connections/{connection_id}/actions/get_user_info?project_id={project_id}
Comparta los archivos y carpetas de Box a los que desea acceder desde watsonx.ai Studio con el nombre de inicio de sesión devuelto por la llamada REST.
Paso siguiente: Añadir activos de datos desde la conexión
Si tiene miles de archivos en una carpeta de Box, es posible que la conexión no pueda recuperar los archivos antes de un tiempo de espera. Es posible que los trabajos o perfiles que utilizan los archivos de Box no funcionen.
Solución temporal: Reorganice la jerarquía de archivos en Box para que haya menos archivos en la misma carpeta.
Tipos de archivos soportados
Copy link to section
La conexión Box da soporte a estos tipos de archivo: Avro, CSV, Texto delimitado, Excel, JSON, ORC, Parquet, SAS, SAV, SHP y XML.