Configurazione Box

Anteprima privata: la creazione e l'utilizzo di un datastore mediante importazione dati sono in anteprima privata. Per utilizzare il datastore di importazione dati, devi essere nella lista consentita. Per essere aggiunto alla lista consentita, contatta il tuo team dedicato all'account o il team di vendita.

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

Creare un'app Box

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

5. Imposta le seguenti proprietà:

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

6. Seleziona Autenticazione server - JWT come Metodo di autenticazione.

7. Fai clic su Crea app.

Configurare l'app Box

1. Nella Box Developer Console, seleziona l' app della piattaforma dalla pagina Le mie app della piattaforma.

   

   Pagina Le mie app della piattaforma nella Box Developer Console.

2. Nella scheda Configurazione, procedi nel seguente modo:

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

      Nota: App + Accesso aziendale è necessario per recuperare file, commenti e attività dai singoli account utente. Inoltre, questo livello di accesso è necessario per la funzionalità di sincronizzazione incrementale. Il flusso di eventi aziendali si basa su questo livello per identificare e recuperare in modo efficiente file, commenti e attività nuovi e modificati.

      

      Configurare 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	Scopo
      Ricerca federata	Read all files and folders stored in Box	Obbligatorio 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	Obbligatorio per copiare, caricare e scaricare file, recuperare commenti e attività e visualizzare l'anteprima dei file per la ricerca.
      Importazione dati	Read all files and folders stored in Box	Obbligatorio per 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 dell'amministratore non ha intrinsecamente accesso a tutti i file di proprietà dell'utente. 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 aziendali per monitorare le modifiche per l'importazione.
      	Manage groups	Obbligatorio per recuperare l'elenco dei gruppi e dei relativi membri. Questo è fondamentale per il controllo dell'accesso durante l'importazione.

      Nota: se intendi utilizzare il 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 è obbligatorio per le azioni che comportano l'aggiornamento dei contenuti in Box. Per ulteriori informazioni, consulta la sezione Azioni

3. Nella sezione Aggiungi e gestisci chiavi pubbliche, fai clic 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.

Autorizzare l'app Box

Per autorizzare l'app Box dalla Developer Console:

1. Nella Box Developer Console, seleziona l' app della piattaforma e 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 di Box:

1. Accedi al gestore delle 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 Box Developer Console, seleziona l' app della piattaforma dalla pagina Le mie app della piattaforma.

• ID azienda: ottienilo dalla scheda Impostazioni generali.

  

  Ottenere l'ID azienda.

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

  

  Ottenere la configurazione del client.

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

  

  Aggiungere e gestire chiavi pubbliche.