Centro de soporte de Workiva

Con el conector de Box®, puedes utilizar los comandos para interactuar con las unidades de Box, como para:

• Buscar y gestionar archivos
• Crear y eliminar carpetas
• Recuperar URL de archivos y carpetas

Nota: Este conector ha sido creado por Workiva y conecta con un sistema de terceros. Aunque nuestro equipo de asistencia puede ayudarte a configurar este conector dentro de tu espacio de trabajo, no podemos solucionar ni ayudar de ningún otro modo con los problemas que se originen fuera de la plataforma Workiva.

Requisitos previos

Para configurar el conector, necesitarás:

• Una aplicación Box a medida para la integración de cuentas de servicio
• El ID de empresa de la aplicación a medida, el ID y secreto de cliente y la clave privada.

Crear una integración de cuenta de servicio en Box

Antes de configurar el conector de Box, crea una aplicación personalizada de Box para la integración de la cuenta de servicio. Para configurar el par de claves pública/privada de la aplicación, necesitarás: 

• OpenSSL
• Un editor de texto sin formato, como Bloc de notas de Windows
• Autenticación de dos factores (2FA) activada en Box

Paso 1: Crear una aplicación Box personalizada

1. Desde Dev Console in Box, haz clic en Crear nueva aplicación.
2. Selecciona Aplicación personalizada, y haz clic en Siguiente.
   
3. En Método de autenticación, selecciona OAuth 2.0 con JWT y haz clic en Siguiente.
   
4. Introduce un nombre que sea único para ayudar a identificar la aplicación, como Workiva Box App, y haz clic en Crear aplicación y, a continuación, en Visualiza tu aplicación.
   

Etapa 2: Crear el par de claves RSA de la aplicación

Para asegurar la conexión, el conector Box se autentica utilizando el par de claves pública/privada Rivest-Shamir-Adleman (RSA) de la aplicación personalizada. Para crear este par de claves en OpenSSL, introduce estos comandos:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Estos comandos generan dos archivos:

• private.pem, que contiene la clave de cliente que el conector utiliza para autenticarse con Box.
• public.pem, que la aplicación personalizada necesita para su configuración

Etapa 3: Configurar la aplicación personalizada

1. Desde Consola de desarrollo en el cuadro, selecciona Configuración para la aplicación personalizada.
2. En Método de autenticación, verifica que OAuth 2.0 con JWT está seleccionado.
   
3. Debajo de Acceso a aplicaciones, selecciona Empresa, y haz clic en Guardar cambios.
   
4. En un editor de texto plano, abre el archivo public.pem y copia todo su contenido, incluida la línea de encabezamiento -----BEGIN PUBLIC KEY-----, la línea de pie de página -----END PUBLIC KEY-----, y los espacios finales.
5. Desde Dev Console en Box, selecciona Configuración para la aplicación a medida, y haz clic en Agregar un clave pública en Agregar y administrar claves públicas.
   
   
6. Pega todo el contenido del archivo public.pem, y haz clic en Verificar y Guardar.
7. Cuando se te solicite, introduce el código 2FA de tu cuenta de Box y haz clic en Enviando a.
8. En Credenciales de OAuth 2.0, copia el ID de cliente de la aplicación personalizada.
   

Etapa 4: Autorizar la aplicación personalizada en Box

1. Desde Admin Console en Box, haz clic en Apps.
2. En la pestaña Personalizar aplicaciones, haz clic en Autorizar nueva aplicación.
3. Pega el Id de cliente de la aplicación personalizada y haz clic en Siguiente.
4. Debajo de Autorización de la aplicación, verifica que la aplicación está autorizada para Todos los usuarios y haz clic en Autorizar.

Etapa 5: Añadir el ID de cuenta de servicio como colaborador a una carpeta de Box.

1. Desde Consola de desarrollo en el cuadro, selecciona Configuración para la aplicación personalizada.
2. Copia el ID de acceso al servicio.
3. Ve a la carpeta Box que se compartirá. Debajo de Compartir, busca la sección Colaboradores y haz clic en Invitar a personas para añadir el identificador de cuenta del servicio.
   

Establece el conector Box

Nota: Para que el conector esté disponible para su uso en las cadenas de tu organización, un administrador de seguridad de la organización primero lo habilita desde Configuración.

1. En el Generador de cadenas, haz clic en Conexiones  compare_arrows y, a continuación, en Crear en la parte superior derecha.
2. Debajo de Conector Conexión, selecciona Caja y el CloudRunner predeterminado.
   
3. En Información básica, ingresa un nombre único y una descripción para ayudar a identificar la conexión.
4. En Propiedades, ingresa los detalles de la conexión:
   
   

   Propiedad	Detalles
   ID de cliente	Introduce el ID de cliente de la aplicación Box personalizada para utilizarla como integración de la cuenta de servicio del conector. Nota: Desde Consola de desarrollo en Box, el ID de cliente aparece en Credenciales de OAuth 2.0 en la pestaña Configuración de la aplicación personalizada.
   Secreto de cliente	Introduce el secreto de cliente de la aplicación a medida.  Nota: Desde Consola de desarrollo en Box, el secreto de cliente aparece en Credenciales de OAuth 2.0 en la pestaña Configuración de la aplicación personalizada.
   Clave del cliente	Introduce el contenido completo del archivo private.pem creado para la aplicación personalizada, incluida la línea de encabezado -----BEGIN RSA PRIVATE KEY-----, la línea de pie de página -----END RSA PRIVATE KEY-----, y los espacios finales.
   ID de empresa	Introduce el ID de empresa de la aplicación a medida. Nota: Desde Dev Console en Box, el ID de empresa aparece en App Info en la pestaña General de la aplicación general.

   Nota: Todas las credenciales confidenciales se cifran automáticamente y se almacenan con un cifrado Advanced Encryption Standard (AES)-256.

5. Selecciona los entornos para utilizar la conexión y haz clic en Guardar.
6. Para evaluar la conexión, crea y ejecuta una cadena con el comando del conector Obtener información de la carpeta y comprueba que devuelve un resultado válido.

Solución de problemas

Si falla la conexión a Box:

• Asegúrate de que la aplicación personalizada está autorizada en Box.
• Verifica el ID y el secreto de cliente de la aplicación personalizada introducidos para el conector. Desde Consola de desarrollo en Box, el ID de cliente y el secreto aparecen en Credenciales de OAuth 2.0 en la pestaña Configuración de la aplicación personalizada. Para Restablecer las credenciales, haz clic en Restablecer. 
• Asegúrate de que los contenidos completos de los archivos public.pem y private.pem de la aplicación personalizada se introducen en las configuraciones de la aplicación y del conector, respectivamente. Incluye la línea del Encabezado, la línea del Pie de página y los espacios finales. Si es necesario, crea un nuevo par de claves pública/privada en OpenSSL, e introduce su contenido en las configuraciones de la aplicación y el conector.
• Verifica el ID de empresa de la aplicación a medida introducido para el conector. Desde Dev Console en Box, el ID de empresa aparece en App Info en la pestaña General de la aplicación general.
• Verifica que la carpeta que se está compartiendo tiene el ID de cuenta de servicio añadido como colaborador.