Configuración de Box

Vista previa privada: el almacén de datos de ingesta de datos está en vista previa privada. Para usar el almacén de datos de ingestión de datos, debes estar en la lista de permitidos. Para que se te añada a la lista de permitidos, ponte en contacto con tu equipo de cuentas o con el equipo de Ventas.

Vista Previa Pública: las funciones de búsqueda y acciones federadas están en Vista Previa Pública. Esta función está sujeta a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases 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.

Crear una aplicación de Box

1. Inicia sesión en la consola de desarrolladores de Box con tu cuenta de administrador.
2. Haz clic en Crear aplicación de plataforma.
3. En Tipo de aplicación, selecciona Aplicación personalizada.
4. Introduce el nombre de la aplicación.

5. Define las siguientes propiedades:

   • Finalidad: integración.
   • Categorías: IA.
   • Sistema externo: Google Cloud Gemini Enterprise.

6. En Authentication method (Método de autenticación), selecciona Server Auth - JWT (Autenticación del servidor - JWT).

7. Haz clic en Create App (Crear aplicación).

Configurar la aplicación Box

1. En la consola para desarrolladores de Box, selecciona la aplicación de plataforma en la página Mis aplicaciones de plataforma.

   

   Página Mis aplicaciones de plataforma en Box Developer Console.

2. En la pestaña Configuración, haz lo siguiente:

   1. En la sección Nivel de acceso de aplicaciones, selecciona Acceso de aplicaciones y empresas.

      Nota: Se necesita acceso a la aplicación y a la empresa para obtener archivos, comentarios y tareas de cuentas de usuario individuales. Además, este nivel de acceso es necesario para la función de sincronización incremental. El flujo de eventos de empresa se basa en este nivel para identificar y recuperar archivos, comentarios y tareas nuevos y modificados de forma eficiente.

      

      Configura la aplicación Box.

   2. En la sección Ámbitos de la aplicación, selecciona los ámbitos en función del modo de conexión de la siguiente tabla:

      Modo de conexión	Ámbito	Purpose
      Búsqueda federada	Read all files and folders stored in Box	Se necesita para obtener comentarios y tareas, así como para previsualizar archivos en las búsquedas.
      Búsquedas y acciones federadas	Write all files and folders stored in Box	Se necesita para copiar los archivos, así como para obtener comentarios y tareas, y para previsualizar archivos en las búsquedas.
      Ingestión de datos	Read all files and folders stored in Box	Obligatorio para la ingestión de datos.
      	Manage users	Se requiere para obtener la lista de usuarios, lo que permite recuperar archivos, comentarios y tareas de cuentas de usuario individuales para la ingestión. La cuenta de servicio de administrador no tiene acceso a todos los archivos propiedad de los usuarios. El encabezado as-user permite que el sistema haga solicitudes de API como el usuario específico para acceder a sus datos.
      	Manage enterprise properties	Es necesario para la función de sincronización incremental, ya que facilita el uso del flujo de eventos de Enterprise para monitorizar los cambios de la ingestión.
      	Manage groups	Obligatorio para obtener la lista de grupos y sus miembros. Esto es fundamental para controlar el acceso durante la ingestión.

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

3. En la sección Añadir y gestionar claves públicas, haz clic en Generar un par de claves públicas/privadas.

   • La clave pública se sube automáticamente a la consola con un ID, que se usa al crear una conexión.
   • Puede descargar un archivo de configuración con la clave privada y la contraseña. Guarda este archivo para usarlo más adelante.
   • Si quieres generar tu propia clave, consulta la guía de configuración de pares de claves de Box.

4. Haz clic en Guardar cambios.

Autorizar la aplicación Box

Para autorizar la aplicación de Box desde la consola para desarrolladores, sigue estos pasos:

1. En la consola para desarrolladores de Box, selecciona la aplicación de plataforma y, a continuación, ve a la pestaña Autorización.
2. Haga clic en Revisar y enviar.

3. En el cuadro de diálogo Revisar envío de autorización de aplicación, haz clic en Enviar.

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

   

   La solicitud de autorización se ha enviado correctamente.

Para autorizar la aplicación de Box desde el gestor de aplicaciones de la plataforma de administrador de Box, sigue estos pasos:

1. Inicia sesión en el gestor de aplicaciones de la plataforma de administración de Box con tu cuenta de administrador.
2. Elige la aplicación de plataforma que hayas configurado.
3. Haz clic en los tres puntos (...) de la fila correspondiente.
4. Selecciona Autorizar aplicación en la lista desplegable.
5. En el cuadro de diálogo Autorizar aplicación, haz clic en Autorizar para completar el proceso de autorización.

Obtener información de autenticación de Box

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

1. En la consola para desarrolladores de Box, selecciona la aplicación de plataforma en la página Mis aplicaciones de plataforma.

• ID de empresa: obténgalo en la pestaña Ajustes generales.

  

  Obtén el ID de empresa.

• ID de cliente y Secreto de cliente: obténgalos 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 Añadir y gestionar claves públicas, al configurar la aplicación.

  

  Añadir y gestionar claves públicas.