Preparare un identificativo Box
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:
- Crea Platform App › Custom App;
- metodo di autenticazione Server Authentication (Client Credentials Grant);
- 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:
| Portata | Cosa apre a REVIEWIT |
|---|---|
| Leggere tutti i file e le cartelle memorizzate in Box | Cartelle condivise, collaborazioni, link condivisi, hub |
| Gestire utenti | Utenti gestiti, amministratori, collaboratori esterni, utenti dell'applicazione |
| Gestire gruppi | Gruppi, membri, amministratori di gruppo |
| Gestire proprietà aziendali | Registro di amministrazione (ultima connessione), domini autorizzati, barriere di informazione, collegamenti Slack e Teams, hub aziendali |
| Gestire politiche di ritenzione | Politiche di ritenzione (Box Governance) |
| Gestire conservazioni legali | Conservazioni 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:
- scheda Autorizzazione dell'applicazione › Rivedi e invia;
- 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
| Valore | Dove trovarla |
|---|---|
| Enterprise ID | Admin Console › Account & Billing › Account Information (un numero) ; anche nel tab General Settings dell'applicazione |
| Client ID | Application › Configuration › OAuth 2.0 Credentials |
| Client Secret | Stesso posto ( Fetch Client Secret ) |
In REVIEWIT : Connessioni › Nuova connessione › Box , inserisci i tre valori. La verifica :
- ottiene il token dell'account di servizio ;
- verifica che questo account appartenga all'azienda inserita ;
- 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 Box | Causa | Azione |
|---|---|---|
| unauthorized_client | L'applicazione non è autorizzata nell'azienda | Sezione 3 |
| invalid_grant / invalid_client | Secret falso o rigenerato, o Enterprise ID che non è quello dell'autorizzazione | Ricopiare il secret, verificare l'Enterprise ID |
| The grant type is unauthorized | L'applicazione non è in Client Credentials Grant | Creare un'applicazione Server Authentication (Client Credentials Grant) |
| the app reaches the enterprise but cannot list its users | App Access Only , o portata Manage users assente | Sezione 2, poi riautorizzare (sezione 3) |
| insufficient_scope | Manca una portata | Selezionare 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.