Configurazione Box

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 authentication (with JWT) (Autenticazione server con JWT).

    Seleziona Autenticazione server (con JWT)
    Seleziona Autenticazione server (con JWT).
  7. Fai clic su Crea app.

Configurare l'app Box

  1. Nella console per sviluppatori Box, scegli l'app della piattaforma e poi vai alla scheda Configurazione.

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

  3. Nella sezione Ambiti dell'applicazione, seleziona gli ambiti in base alle tue esigenze dalla seguente tabella:

    Modalità di connessione Ambito Finalità
    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.
    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à 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 Enterprise 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.

    Configurare l'app Box
    Configura l'app Box.

  4. 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.

      Aggiungere e gestire le chiavi pubbliche
      Gestisci le chiavi.
  5. Fai clic su Salva modifiche.

Autorizza l'app Box

  1. Nella console per sviluppatori di Box, scegli l'app della piattaforma e poi vai alla scheda Autorizzazione.
  2. Fai clic su Rivedi e invia.
  3. Nella finestra di dialogo Rivedi invio autorizzazione app, fai clic su Invia.

    Autorizza l'app Box
    Autorizza l'app Box.

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

    La richiesta di autorizzazione è stata inviata
    La richiesta di autorizzazione è stata inviata correttamente.

  4. Accedi a Gestore app della piattaforma di amministrazione di Box con il tuo account amministratore.

  5. Scegli l'app della piattaforma che hai configurato.

  6. Fai clic sui tre puntini () nella riga corrispondente.

  7. Seleziona Autorizza app dall'elenco a discesa.

  8. Nella finestra di dialogo Autorizza app, fai clic su Autorizza per completare la procedura di autorizzazione.

    Fai clic sul pulsante Autorizza nella finestra di dialogo Autorizza app.
    Fai clic su Autorizza.

Ottenere le informazioni di autenticazione di Box

Tieni a portata di mano le seguenti informazioni di autenticazione di Box:

  • ID enterprise: ottienilo dalla scheda Impostazioni generali.

    ottenere l'ID enterprise
    Ottieni l'ID azienda.

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

    ottenere la configurazione del client
    Ottieni la configurazione del client.

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

    aggiungere e gestire le chiavi pubbliche
    Aggiungi e gestisci chiavi pubbliche.