Configurazione Box

Anteprima privata: il datastore di importazione dati è in anteprima privata. Per utilizzare il datastore di importazione dati, devi essere presente nella lista consentita. Per essere aggiunto alla lista consentita, contatta il tuo team dell'account o il team di vendita.

Anteprima pubblica: le funzionalità di ricerca e azioni federate sono in Anteprima pubblica. Questa funzionalità è soggetta ai "Termini delle Offerte pre-GA" nella sezione Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per saperne di più, consulta le descrizioni della fase di lancio.

Questa pagina descrive come configurare una configurazione di terze parti prima di creare il datastore Box.

Crea un'app Box

1. Accedi alla console per sviluppatori Box con il tuo account amministratore.
2. Fai clic su Crea app per la piattaforma.
3. Seleziona Tipo di app come App personalizzata.
4. Inserisci il Nome dell'app.

5. Imposta le seguenti proprietà:

   • Scopo: integrazione.
   • Categorie: AI.
   • Sistema esterno: Google Cloud Gemini Enterprise.

6. Seleziona Authentication method (Metodo di autenticazione) come Server Auth - JWT (Autenticazione server - JWT).

7. Fai clic su Crea app.

Configurare l'app Box

1. Nella console per sviluppatori Box, seleziona l'app della piattaforma dalla pagina Le mie app della piattaforma.

   

   Pagina Le mie app della piattaforma in Box Developer Console.

2. Nella scheda Configurazione, segui questi passaggi:

   1. Nella sezione Livello di accesso alle app, seleziona App + Accesso aziendale.

      Nota: per recuperare file, commenti e attività dai singoli account utente è necessario l'accesso a App + Enterprise. Inoltre, questo livello di accesso è necessario per la funzionalità di sincronizzazione incrementale. Lo stream di eventi aziendale si basa su questo livello per identificare e recuperare in modo efficiente file, commenti e attività nuovi e modificati.

      

      Configura l'app Box.

   2. Nella sezione Ambiti dell'applicazione, seleziona gli ambiti in base alla modalità di connessione dalla seguente tabella:

      Modalità di connessione	Ambito	Purpose
      Ricerca federata	Read all files and folders stored in Box	Necessario per recuperare commenti e attività e per visualizzare l'anteprima dei file per la ricerca.
      Ricerca federata e azioni	Write all files and folders stored in Box	Necessario per copiare i file e anche per recuperare commenti e attività e per visualizzare l'anteprima dei file per la ricerca.
      Importazione dati	Read all files and folders stored in Box	Obbligatorio per l'importazione dati.
      	Manage users	Obbligatorio per recuperare l'elenco degli utenti, consentendo il recupero di file, commenti e attività dai singoli account utente per l'importazione. L'account di servizio amministratore non ha accesso intrinseco a tutti i file di proprietà degli utenti. L'intestazione as-user consente al sistema di effettuare richieste API come utente specifico per accedere ai suoi dati.
      	Manage enterprise properties	Necessario per la funzionalità di sincronizzazione incrementale, in quanto facilita l'utilizzo del flusso di eventi aziendale per monitorare le modifiche per l'importazione.
      	Manage groups	Obbligatorio per recuperare l'elenco dei gruppi e dei relativi membri. Questo è fondamentale per controllo dell'accesso durante l'importazione.

      Nota :se intendi utilizzare l'datastore solo per la ricerca e non per eseguire azioni che modificano i contenuti in Box, puoi limitare l'ambito a Leggi tutti i file e le cartelle archiviati in Box. L'ambito Scrivi tutti i file e le cartelle archiviati in Box è necessario per le azioni che comportano l'aggiornamento dei contenuti in Box.

3. Nella sezione Aggiungi e gestisci chiavi pubbliche, fai clic su Genera una coppia di chiavi pubblica/privata.

   • La chiave pubblica viene caricata automaticamente nella console con un ID, utilizzato durante la creazione di una connessione.
   • Puoi scaricare un file di configurazione con la chiave privata e la passphrase. Assicurati di conservare questo file per un utilizzo futuro.
   • Se vuoi generare la tua chiave, consulta la guida alla configurazione della coppia di chiavi Box.

4. Fai clic su Salva modifiche.

Autorizza l'app Box

Per autorizzare l'app Box dalla console per gli sviluppatori, procedi nel seguente modo:

1. Nella console per gli sviluppatori di Box, seleziona l'app della piattaforma, quindi vai alla scheda Autorizzazione.
2. Fai clic su Rivedi e invia.

3. Nella finestra di dialogo Rivedi invio autorizzazione app, fai clic su Invia.

   Se la richiesta di autorizzazione viene inviata correttamente, viene visualizzato il seguente messaggio di conferma:

   

   La richiesta di autorizzazione è stata inviata correttamente.

Per autorizzare l'app Box dal gestore delle app della piattaforma di amministrazione Box:

1. Accedi a Gestore app della piattaforma di amministrazione di Box con il tuo account amministratore.
2. Scegli l'app della piattaforma che hai configurato.
3. Fai clic sui tre puntini (…) nella riga corrispondente.
4. Seleziona Autorizza app dall'elenco a discesa.
5. Nella finestra di dialogo Autorizza app, fai clic su Autorizza per completare la procedura di autorizzazione.

Ottenere le informazioni di autenticazione di Box

Per ottenere le informazioni di autenticazione di Box:

1. Nella console per sviluppatori Box, seleziona l'app della piattaforma dalla pagina Le mie app della piattaforma.

• ID enterprise: ottienilo dalla scheda Impostazioni generali.

  

  Ottieni l'ID azienda.

• ID client e client secret: ottienili dalla scheda Configurazione in Credenziali OAuth 2.0.

  

  Ottieni la configurazione del client.

• Chiave privata, ID chiave e Passphrase: questi parametri sono stati generati e scaricati in un file locale dalla scheda Configurazione nella sezione Aggiungi e gestisci chiavi pubbliche durante la configurazione dell'app.

  

  Aggiungi e gestisci chiavi pubbliche.