Conexión de Box

Crear una aplicación personalizada en Box

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.

1. 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).
2. Realice las siguientes selecciones en la página Configuración. Si lo desea puede conservar los valores predeterminados.
   1. 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.
        
   2. 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.
3. 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
4. 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

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.

openssl pkcs8 -in private_key.pem -passin file:pass.txt -out private_key_unencrypted.pem

Los parámetros utilizados son:

private_key.pem

La clave privada encriptada generada y proporcionada por Box.

pass.txt

Este archivo contiene la contraseña asociada a la clave privada generada y proporcionada por Box.

private_key_unencrypted.pem

Este es el archivo de salida que contendrá la clave privada sin cifrar después de ejecutar el comando.

Elija el método para crear una conexión basada en el lugar en el que se encuentra en la plataforma

En un proyecto

Pulse Activos > Nuevo activo > Conectar a un origen de datos. Consulte Adición de una conexión a un proyecto.

En un espacio de despliegue

Pulse Importar activos > Acceso a datos > Conexión. Consulte Adición de activos de datos a un espacio de despliegue.

En el catálogo de activos de la plataforma

Pulse Nueva conexión. Consulte Adición de conexiones de plataforma.

Crear la conexión de Box

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

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

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.

1. 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}

   Cuerpo de la solicitud:

   {}
   

   Devuelve:

   {
    "login_name": "[email protected]"
   }
   

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

• Consulte Añadir datos de una conexión en un proyecto.