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: La búsqueda federada está 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 aplicación 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 (con JWT).

   

   Selecciona Autenticación del servidor (con JWT).

7. Haz clic en Crear aplicación.

Configura la app de Box

1. En Box Developer Console, elige la app de la plataforma y, luego, ve a la pestaña Configuración.

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

3. En la sección Permisos de la aplicación, selecciona los permisos según tus requisitos en la siguiente tabla:

   Modo de conexión	Permiso	Objetivo
   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.
   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.

   

   Configura la app de Box.

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

     

     Administra las llaves.

5. Haz clic en Guardar cambios.

Autoriza la app de Box

1. En la Box Developer Console, elige la app de la plataforma y, luego, ve a la pestaña Autorización.
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.

   

   Autoriza la app de Box.

   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.

4. Accede al administrador de apps de la plataforma de administrador de Box con tu cuenta de administrador.

5. Elige la app de la plataforma que configuraste.

6. Haz clic en los tres puntos (…) de la fila correspondiente.

7. Selecciona Autorizar app en la lista desplegable.

8. En el diálogo Autorizar app, haz clic en Autorizar para completar el proceso de autorización.

   

   Haz clic en Autorizar.

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

Ten a mano la siguiente información de autenticación de Box:

• 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 ya 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.