Configuración de Box

Vista previa privada: El almacén de datos de la transferencia de datos está en vista previa privada. Debes estar en la lista de entidades permitidas para usar el almacén de datos de la transferencia de datos. Para que te agreguen a la lista de entidades permitidas, comunícate con tu equipo de cuentas o con el equipo de ventas.

Versión preliminar pública: Las funciones de búsqueda y acciones federadas están en versión preliminar pública. Esta función está sujeta a las “Condiciones de la Oferta de la Fase Previa a la DG” en la sección de Condiciones Generales del Servicio de las Condiciones Específicas del Servicio. Las funciones de la fase previa a la DG están disponibles “sin modificaciones” y pueden tener asistencia limitada. Para obtener más información, consulta las descripciones de la etapa de lanzamiento.

En esta página, se describe cómo configurar un parámetro de configuración de terceros antes de crear el almacén de datos de Box.

Crea una app de Box

1. Accede a la Consola para desarrolladores de Box con tu cuenta de administrador.
2. Haz clic en Crear app para la plataforma.
3. Selecciona Tipo de app como App personalizada.
4. Ingresa el Nombre de la app.

5. Establezca las siguientes propiedades:

   • Propósito: Integración.
   • Categorías: IA.
   • Sistema externo: Google Cloud Gemini Enterprise.

6. Selecciona Método de autenticación como Autenticación del servidor: JWT.

7. Haz clic en Crear app.

Configura la app de Box

1. En Box Developer Console, selecciona la app de la plataforma en la página My Platform Apps.

   

   Página My Platform Apps en la Consola de Box Developer.

2. En la pestaña Configuration, realice lo siguiente:

   1. En la sección Nivel de acceso de la app, selecciona Acceso a la app y a la empresa.

      Nota: Se requiere acceso a la app y a la empresa para recuperar archivos, comentarios y tareas de cuentas de usuarios individuales. Además, este nivel de acceso es necesario para la funcionalidad de sincronización incremental. El flujo de eventos empresariales se basa en este nivel para identificar y recuperar archivos, comentarios y tareas nuevos y modificados de manera eficiente.

      

      Configura la app de Box.

   2. En la sección Permisos de la aplicación, selecciona los permisos según el modo de conexión en la siguiente tabla:

      Modo de conexión	Permiso	Purpose
      Búsqueda federada	Read all files and folders stored in Box	Se requiere para recuperar comentarios y tareas, y para obtener una vista previa de los archivos en la búsqueda.
      Búsqueda y acciones federadas	Write all files and folders stored in Box	Se requiere para copiar los archivos, recuperar comentarios y tareas, y obtener vistas previas de los archivos para la búsqueda.
      Transferencia de datos	Read all files and folders stored in Box	Se requiere para la transferencia de datos.
      	Manage users	Se requiere para recuperar la lista de usuarios, lo que permite recuperar archivos, comentarios y tareas de cuentas de usuarios individuales para la transferencia. La cuenta de servicio del administrador no tiene acceso inherente a todos los archivos propiedad del usuario. El encabezado as-user permite que el sistema realice solicitudes a la API como el usuario específico para acceder a sus datos.
      	Manage enterprise properties	Es necesario para la funcionalidad de sincronización incremental, ya que facilita el uso del flujo de eventos de la empresa para hacer un seguimiento de los cambios para la transferencia.
      	Manage groups	Se requiere para recuperar la lista de grupos y sus miembros. Esto es fundamental para el control de acceso durante la transferencia.

      Nota: Si solo planeas usar el almacén de datos para la búsqueda y no para realizar ninguna acción que modifique el contenido en Box, puedes limitar el alcance a Leer todos los archivos y carpetas almacenados en Box. El alcance Escribir todos los archivos y las carpetas almacenados en Box es necesario para las acciones que implican actualizar contenido en Box.

3. En la sección Agregar y administrar claves públicas, haz clic en Generar un par de claves pública/privada.

   • La clave pública se sube automáticamente a la consola con un ID, que se usa cuando se crea una conexión.
   • Puedes descargar un archivo de configuración con la clave privada y la frase de contraseña. Asegúrate de conservar este archivo para usarlo más adelante.
   • De manera opcional, si deseas generar tu propia clave, consulta la guía de configuración del par de claves de Box.

4. Haz clic en Guardar cambios.

Autoriza la app de Box

Para autorizar la app de Box desde la consola para desarrolladores, haz lo siguiente:

1. En Box Developer Console, selecciona la app de la plataforma y, luego, ve a la pestaña Authorization.
2. Haz clic en Revisar y enviar.

3. En el diálogo Revisa el envío de autorización de la app, haz clic en Enviar.

   Si la solicitud de autorización se envía correctamente, se muestra el siguiente mensaje de confirmación:

   

   Se envió correctamente la solicitud de autorización.

Para autorizar la app de Box desde el administrador de apps de la plataforma de administración de Box, haz lo siguiente:

1. Accede al administrador de apps de la plataforma de administrador de Box con tu cuenta de administrador.
2. Elige la app de la plataforma que configuraste.
3. Haz clic en los tres puntos (…) de la fila correspondiente.
4. Selecciona Autorizar app en la lista desplegable.
5. En el diálogo Autorizar app, haz clic en Autorizar para completar el proceso de autorización.

Obtén información de autenticación de Box

Para obtener la información de autenticación de Box, haz lo siguiente:

1. En Box Developer Console, selecciona la app de la plataforma en la página My Platform Apps.

• ID de la empresa: Obténlo en la pestaña Configuración general.

  

  Obtén el ID de la empresa.

• ID de cliente y secreto del cliente: Obtén estos datos en la pestaña Configuración en Credenciales de OAuth 2.0.

  

  Obtén la configuración del cliente.

• Clave privada, ID de clave y Frase de contraseña: Estos parámetros se generaron y descargaron en un archivo local desde la pestaña Configuración en Agregar y administrar claves públicas mientras se configuraba la app.

  

  Agrega y administra claves públicas.