Configuración de Box

Vista previa privada: La creación y el uso de un almacén de datos mediante la transferencia de datos se encuentran en versión preliminar privada. Debes estar en la lista de entidades permitidas para usar el almacén de datos de transferencia de datos. Para que te agreguen a la lista de entidades permitidas, comunícate con tu equipo de cuentas o el equipo de ventas.

Versión preliminar pública: Las funciones de búsqueda y acciones federadas se encuentran en versión preliminar pública. Esta función está sujeta a las "Condiciones de la oferta previa a la DG" en la sección 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 una configuración de terceros antes de crear el almacén de datos de Box.

Crea una app de Box

1. Accede a la Box Developer Console con tu cuenta de administrador.
2. Haz clic en Create platform app.
3. Selecciona App type como Custom app.
4. Ingresa el nombre de la app.

5. Establece las siguientes propiedades:

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

6. Selecciona Authentication method como Server Auth - JWT.

7. Haz clic en Crear app.

Configura la app de Box

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

   

   Página My Platform Apps en Box Developer Console.

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

   1. En la sección App access level, selecciona App + Enterprise access.

      Nota: Se requiere App + Enterprise access para recuperar archivos, comentarios y tareas de cuentas de usuario individuales. Además, este nivel de acceso es necesario para la funcionalidad de sincronización incremental. La transmisión de eventos de Enterprise depende de 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 Application scopes, selecciona los permisos según el modo de conexión de la siguiente tabla:

      Modo de conexión	Alcance	Propósito
      Búsqueda federada	Read all files and folders stored in Box	Obligatorio para recuperar comentarios y tareas, y para obtener una vista previa de los archivos para la búsqueda
      Búsqueda y acciones federadas	Write all files and folders stored in Box	Obligatorio para copiar, subir y descargar archivos, y también para recuperar comentarios y tareas, y para obtener una vista previa de los archivos para la búsqueda
      Transferencia de datos	Read all files and folders stored in Box	Obligatorio para la transferencia de datos
      	Manage users	Obligatorio para recuperar la lista de usuarios, lo que permite recuperar archivos, comentarios y tareas de cuentas de usuario individuales para la transferencia (la cuenta de servicio del administrador no posee acceso de forma 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	Necesario para la funcionalidad de sincronización incremental, ya que facilita el uso de la transmisión de eventos de Enterprise para hacer un seguimiento de los cambios para la transferencia
      	Manage groups	Obligatorio para recuperar la lista de grupos y sus miembros (esto es fundamental para el control de acceso durante la transferencia)

      Nota: Si solo tienes la intención de usar el almacén de datos para la búsqueda y no para realizar acciones que modifiquen el contenido en Box, puedes limitar el permiso a Read all files and folders stored in Box. El permiso Write all files and folders stored in Box es obligatorio para las acciones admitidas que implican actualizar contenido en Box.

3. En la sección Add and manage public keys, haz clic en Generate a public/private keypair.

   • 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, para generar tu propia clave, consulta la guía de configuración de pares 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 el 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 Review app authorization submission, 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 administración 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 Authorize app en la lista desplegable.
5. En el diálogo Authorize app, haz clic en Authorize 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 el 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 General settings.

  

  Obtén el ID de la empresa.

• ID de cliente y secreto del cliente: Obténlos en la pestaña Configuration en OAuth 2.0 credentials.

  

  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 Configuration en Add and manage public keys mientras se configuraba la app.

  

  Agrega y administra claves públicas.