Preparar un identificador de Box
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:
- Crea Platform App › Custom App;
- método de autenticación Server Authentication (Client Credentials Grant);
- 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:
| Alcance | Lo que abre para REVIEWIT |
|---|---|
| Read all files and folders stored in Box | Carpetas compartidas, colaboraciones, enlaces compartidos, hubs |
| Manage users | Usuarios gestionados, administradores, colaboradores externos, usuarios de aplicación |
| Manage groups | Grupos, miembros, administradores de grupo |
| Manage enterprise properties | Diario de administración (última conexión), dominios autorizados, barreras de información, conexiones Slack y Teams, hubs de la empresa |
| Manage retention policies | Políticas de retención (Box Governance) |
| Manage legal holds | Conservaciones 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:
- pestaña Authorization de la aplicación › Review and Submit;
- 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
| Valor | Dónde encontrarla |
|---|---|
| Enterprise ID | Admin Console › Account & Billing › Account Information (un número); también en la pestaña General Settings de la aplicación |
| Client ID | Application › Configuration › OAuth 2.0 Credentials |
| Client Secret | Mismo lugar (Fetch Client Secret) |
En REVIEWIT: Conexiones › Nueva conexión › Box, introduzca los tres valores. La verificación:
- obtiene el token de la cuenta de servicio;
- verifica que esta cuenta pertenece a la empresa introducida;
- 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 Box | Causa | Acción |
|---|---|---|
| unauthorized_client | La aplicación no está autorizada en la empresa | Sección 3 |
| invalid_grant / invalid_client | Secret incorrecto o regenerado, o Enterprise ID que no es el de la autorización | Recopiar el secret, verificar el Enterprise ID |
| The grant type is unauthorized | La aplicación no está en Client Credentials Grant | Crear una aplicación Server Authentication (Client Credentials Grant) |
| the app reaches the enterprise but cannot list its users | App Access Only, o ámbito Manage users ausente | Sección 2, luego reautorizar (sección 3) |
| insufficient_scope | Falta un ámbito | Activar 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.