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
- Inicia sesión en la consola de desarrolladores de Box con tu cuenta de administrador.
- Haz clic en Crear aplicación de plataforma.
- En Tipo de aplicación, selecciona Aplicación personalizada.
- Introduce el nombre de la aplicación.
Define las siguientes propiedades:
- Finalidad: integración.
- Categorías: IA.
- Sistema externo: Google Cloud Gemini Enterprise.
Selecciona Server authentication (with JWT) (Autenticación del servidor con JWT) en Authentication method (Método de autenticación).
Selecciona Autenticación del servidor (con JWT). Haz clic en Crear aplicación.
Configurar la aplicación Box
En la consola para desarrolladores de Box, elige la aplicación de plataforma y, a continuación, ve a la pestaña Configuración.
En la sección Nivel de acceso de aplicaciones, selecciona Acceso de aplicaciones y empresas.
En la sección Permisos de aplicación, selecciona los permisos que necesites en la siguiente tabla:
Modo de conexión Ámbito Finalidad Búsqueda federada Read all files and folders stored in BoxSe necesita para obtener comentarios y tareas, así como para previsualizar archivos en las búsquedas. Ingestión de datos Read all files and folders stored in BoxObligatorio para la ingestión de datos. Manage usersSe 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 propertiesNecesaria para la función de sincronización incremental, ya que facilita el uso del flujo de eventos de Enterprise para monitorizar los cambios que se van a ingerir. Manage groupsObligatorio para obtener la lista de grupos y sus miembros. Esto es fundamental para el control de acceso durante la ingestión.
Configura la aplicación Box. 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.
Gestiona las teclas.
Haz clic en Guardar cambios.
Autorizar la aplicación Box
- En la consola para desarrolladores de Box, elige la aplicación de plataforma y, a continuación, ve a la pestaña Autorización.
- Haz clic en Revisar y enviar.
En el cuadro de diálogo Revisar envío de autorización de aplicación, haz clic en Enviar.
Autoriza la aplicación de Box. 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. Inicia sesión en el gestor de aplicaciones de la plataforma de administración de Box con tu cuenta de administrador.
Elige la aplicación de plataforma que hayas configurado.
Haz clic en los tres puntos (...) de la fila correspondiente.
Selecciona Autorizar aplicación en la lista desplegable.
En el cuadro de diálogo Autorizar aplicación, haz clic en Autorizar para completar el proceso de autorización.
Haz clic en Autorizar.
Obtener información de autenticación de Box
Ten a mano la siguiente información de autenticación de Box:
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 ya 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.