Configuración de Box

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. 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)
    Selecciona Autenticación del servidor (con JWT).
  7. Haz clic en Crear aplicación.

Configurar la aplicación Box

  1. En la consola para desarrolladores de Box, elige la aplicación de plataforma y, a continuación, ve a la pestaña Configuración.

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

  3. 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 Box Se 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 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 Necesaria 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 groups Obligatorio para obtener la lista de grupos y sus miembros. Esto es fundamental para el control de acceso durante la ingestión.

    Configurar la aplicación Box
    Configura la aplicación Box.

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

      Añadir y gestionar claves públicas
      Gestiona las teclas.
  5. Haz clic en Guardar cambios.

Autorizar la aplicación Box

  1. En la consola para desarrolladores de Box, elige la aplicación de plataforma y, a continuación, ve a la pestaña Autorización.
  2. Haz 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.

    Autorizar la aplicación Box
    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
    La solicitud de autorización se ha enviado correctamente.

  4. Inicia sesión en el gestor de aplicaciones de la plataforma de administración de Box con tu cuenta de administrador.

  5. Elige la aplicación de plataforma que hayas configurado.

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

  7. Selecciona Autorizar aplicación en la lista desplegable.

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

    Haz clic en el botón Autorizar del cuadro de diálogo de autorización de la aplicació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.

    Obtener el ID de empresa
    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.

    obtener la configuración del cliente
    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
    Añadir y gestionar claves públicas.