REVIEWITDocumentazione
ProceduraAggiornata · verificata il 13 novembre 2026

Preparare un identificativo Box

Traduzione automatica, non ancora rivistaQuesta pagina è stata tradotta da un modello a partire dalla versione francese, che fa fede. Leggi la versione francese.

01In breve #sec_d80f63df

REVIEWIT raccoglie un'azienda Box tramite un'applicazione Box che crei nella console sviluppatore di Box, in modalità Server Authentication (Client Credentials Grant). Affidi a REVIEWIT tre valori: l'Enterprise ID, il Client ID e il Client Secret di questa applicazione. REVIEWIT ottiene quindi il token dell'account di servizio dell'applicazione, valido un'ora, e legge solo.

Box non offre una portata "lettura sola" per l'amministrazione: le porte Manage users o Manage groups consentono anche la scrittura, e l'opzione as-user permette di agire a nome di un utente. REVIEWIT ne fa uso solo in lettura: ogni chiamata che ha il diritto di fare è scritta nel contratto della risorsa, e nient'altro viene inviato.

021. Creare l'applicazione #sec_02ac4128

Nella Box Developer Console (app.box.com/developers/console), con un conto della tua azienda:

  1. Crea Platform App › Custom App;
  2. metodo di autenticazione Server Authentication (Client Credentials Grant);
  3. nominala, ad esempio REVIEWIT Collector.

Per vedere il Client Secret, la verifica in due passi deve essere attivata sul conto sviluppatore.

032. Configurare l'applicazione #sec_9b48a95f

Scheda Configurazione:

  • Livello di accesso dell'app: App + Enterprise Access. Senza di essa, l'applicazione non vede nessun utente dell'azienda e REVIEWIT rifiuta la connessione.
  • Portate dell'applicazione, da selezionare in base alle risorse che vuoi raccogliere:
PortataCosa apre a REVIEWIT
Leggere tutti i file e le cartelle memorizzate in BoxCartelle condivise, collaborazioni, link condivisi, hub
Gestire utentiUtenti gestiti, amministratori, collaboratori esterni, utenti dell'applicazione
Gestire gruppiGruppi, membri, amministratori di gruppo
Gestire proprietà aziendaliRegistro di amministrazione (ultima connessione), domini autorizzati, barriere di informazione, collegamenti Slack e Teams, hub aziendali
Gestire politiche di ritenzionePolitiche di ritenzione (Box Governance)
Gestire conservazioni legaliConservazioni legali (Box Governance; portata su richiesta al supporto Box)
  • Funzionalità avanzate: seleziona Esegui chiamate API usando l'intestazione as-user. Il conto di servizio vede solo la propria cartella: il contenuto dei tuoi utenti viene letto a loro nome, in lettura sola.

Una portata che non selezioni non blocca la connessione: le risorse che dipendono da essa rimangono semplicemente non raccogliabili, e la fase Preparare dell'assistente le nomina. Un modulo che non hai sottoscritto (Box Governance, Box Shield) viene letto come "non sottoscritto", mai "vuoto".

043. Far autorizzare l'applicazione da un amministratore #sec_209c1692

Un'applicazione Client Credentials Grant funziona solo se autorizzata nella tua azienda:

  1. scheda Autorizzazione dell'applicazione › Rivedi e invia;
  2. un amministratore Box: Console Amministrativa › Piattaforma › App Piattaforma, l'applicazione inviata › Autorizza (o Aggiungi con il suo Client ID).

Qualsiasi modifica delle portate o dell'accesso richiede una nuova autorizzazione (App Piattaforma › … › Riautorizza): finché non viene fatta, Box applica la vecchia configurazione.

054. Recuperare i tre valori #sec_6b0a65ee

ValoreDove trovarla
Enterprise IDAdmin Console › Account & Billing › Account Information (un numero) ; anche nel tab General Settings dell'applicazione
Client IDApplication › Configuration › OAuth 2.0 Credentials
Client SecretStesso posto ( Fetch Client Secret )

In REVIEWIT : Connessioni › Nuova connessione › Box , inserisci i tre valori. La verifica :

  1. ottiene il token dell'account di servizio ;
  2. verifica che questo account appartenga all'azienda inserita ;
  3. verifica che veda gli utenti dell'azienda ( App + Enterprise Access ).

Poi la prova dei diritti constata ogni portata con una lettura minima : Box non permette a un'applicazione di elencare le proprie portate.

065. Se la connessione viene rifiutata #sec_28cc585b

Messaggio di BoxCausaAzione
unauthorized_clientL'applicazione non è autorizzata nell'aziendaSezione 3
invalid_grant / invalid_clientSecret falso o rigenerato, o Enterprise ID che non è quello dell'autorizzazioneRicopiare il secret, verificare l'Enterprise ID
The grant type is unauthorizedL'applicazione non è in Client Credentials GrantCreare un'applicazione Server Authentication (Client Credentials Grant)
the app reaches the enterprise but cannot list its usersApp Access Only , o portata Manage users assenteSezione 2, poi riautorizzare (sezione 3)
insufficient_scopeManca una portataSelezionare la portata, poi riautorizzare

Il secret cambia solo se lo rigeneri : fallo ad ogni partenza di una persona che l'ha visto, poi sostituiscilo in REVIEWIT.

Esc
↑↓ naviga↵ apriVedi tutti i risultati →