REVIEWITDocumentación
ProcedimientoAl día · verificada el 13 noviembre 2026

Preparar un identificador de Box

Traducción automática, aún no revisadaEsta página fue traducida por un modelo a partir de la versión francesa, que es la que da fe. Leer la versión francesa.

01En resumen #sec_d80f63df

REVIEWIT recopila una empresa de Box mediante una aplicación de Box que crea en la consola de desarrollador de Box, en modo Server Authentication (Client Credentials Grant). Le confía a REVIEWIT tres valores: el Enterprise ID, el Client ID y el Client Secret de esta aplicación. REVIEWIT obtiene entonces el token de la cuenta de servicio de la aplicación, válido por una hora, y solo lee.

Box no ofrece un alcance «lectura única» para la administración: los alcances Manage users o Manage groups también permiten la escritura, y la opción as-user permite actuar en nombre de un usuario. REVIEWIT solo hace un uso de lectura: cada llamada que tiene derecho a hacer está escrita en el contrato del recurso, y nada más se envía.

021. Crear la aplicación #sec_02ac4128

En la Box Developer Console (app.box.com/developers/console), con una cuenta de su empresa:

  1. Crea Platform App › Custom App;
  2. método de autenticación Server Authentication (Client Credentials Grant);
  3. nómbrala, por ejemplo REVIEWIT Collector.

Para ver el Client Secret, la verificación en dos pasos debe estar activada en la cuenta del desarrollador.

032. Configurar la aplicación #sec_9b48a95f

Pestaña Configuración:

  • App Access Level: App + Enterprise Access. Sin él, la aplicación no ve ningún usuario de la empresa, y REVIEWIT rechaza la conexión.
  • Application Scopes, para marcar según los recursos que quiera recopilar:
AlcanceLo que abre para REVIEWIT
Read all files and folders stored in BoxCarpetas compartidas, colaboraciones, enlaces compartidos, hubs
Manage usersUsuarios gestionados, administradores, colaboradores externos, usuarios de aplicación
Manage groupsGrupos, miembros, administradores de grupo
Manage enterprise propertiesDiario de administración (última conexión), dominios autorizados, barreras de información, conexiones Slack y Teams, hubs de la empresa
Manage retention policiesPolíticas de retención (Box Governance)
Manage legal holdsConservaciones legales (Box Governance; alcance bajo demanda al soporte de Box)
  • Advanced Features: marque Make API calls using the as-user header. La cuenta de servicio solo ve su propio folder: el contenido de sus usuarios se lee en su nombre, en lectura única.

Un alcance que no marque no bloquea la conexión: los recursos que dependen de él simplemente permanecen no recopilables, y la etapa Preparar del asistente los nombra. Un módulo que no ha suscrito (Box Governance, Box Shield) se lee igual como «no suscrito», nunca «vacío».

043. Hacer autorizar la aplicación por un administrador #sec_209c1692

Una aplicación Client Credentials Grant solo funciona autorizada en su empresa:

  1. pestaña Authorization de la aplicación › Review and Submit;
  2. un administrador de Box: Admin Console › Platform › Platform Apps, la aplicación enviada › Authorize (o Add con su Client ID).

Cualquier modificación de los alcances o del acceso exige una nueva autorización (Platform Apps › … › Reauthorize): mientras no se haga, Box aplica la configuración anterior.

054. Obtener los tres valores #sec_6b0a65ee

ValorDónde encontrarla
Enterprise IDAdmin Console › Account & Billing › Account Information (un número); también en la pestaña General Settings de la aplicación
Client IDApplication › Configuration › OAuth 2.0 Credentials
Client SecretMismo lugar (Fetch Client Secret)

En REVIEWIT: Conexiones › Nueva conexión › Box, introduzca los tres valores. La verificación:

  1. obtiene el token de la cuenta de servicio;
  2. verifica que esta cuenta pertenece a la empresa introducida;
  3. verifica que ve los usuarios de la empresa (App + Enterprise Access).

Luego, la prueba de derechos constata cada ámbito con una lectura mínima: Box no permite a una aplicación listar sus propios ámbitos.

065. Si la conexión es denegada #sec_28cc585b

Mensaje de BoxCausaAcción
unauthorized_clientLa aplicación no está autorizada en la empresaSección 3
invalid_grant / invalid_clientSecret incorrecto o regenerado, o Enterprise ID que no es el de la autorizaciónRecopiar el secret, verificar el Enterprise ID
The grant type is unauthorizedLa aplicación no está en Client Credentials GrantCrear una aplicación Server Authentication (Client Credentials Grant)
the app reaches the enterprise but cannot list its usersApp Access Only, o ámbito Manage users ausenteSección 2, luego reautorizar (sección 3)
insufficient_scopeFalta un ámbitoActivar el ámbito, luego reautorizar

El secret solo cambia si lo regenera: hágalo cada vez que una persona que lo ha visto se vaya, luego reemplácelo en REVIEWIT.

Esc
↑↓ navegar↵ abrirVer todos los resultados →