Centro assistenza di Workiva

Con il connettore Box®, puoi utilizzare i comandi per interagire con le unità Box, ad esempio per:

• Cercare e gestire i file
• Creare ed eliminare cartelle
• Recuperare URL per file e cartelle

Nota: Questo connettore è stato realizzato da Workiva e si collega a un sistema di terze parti. Sebbene il nostro team di assistenza possa aiutare a configurare questo connettore all'interno del tuo spazio di lavoro, non siamo in grado di risolvere i problemi o di fornire assistenza in altro modo per qualsiasi problema che abbia origine al di fuori della piattaforma Workiva.

Prerequisiti

Per configurare il connettore, avrai bisogno di:

• Un'app Box personalizzata per l'integrazione dell'account di servizio
• L'ID aziendale, l'ID e il segreto del cliente e la chiave privata dell'app personalizzata

Creare un'integrazione dell'account di servizio in Box

Prima di configurare il connettore Box, crea un'applicazione Box personalizzata per l'integrazione dell'account di servizio. Per configurare la coppia di chiavi pubbliche/private dell'app, avrai bisogno di: 

• OpenSSL
• Un editor di testo semplice, come Blocco note di Windows
• Autenticazione a due fattori (2FA) abilitata in Box

Passo 1: Creare un'applicazione Box personalizzata

1. Da Dev Console in Box, clicca su Create New App.
2. Seleziona Custom App e clicca su Next.
   
3. Alla voce Metodo di autenticazione, seleziona OAuth 2.0 con JWT e clicca Avanti.
   
4. Inserisci un nome univoco per identificare l'app, ad esempio Workiva Box App, e clicca su Create App e poi su View Your App.
   

Passo 2: Creare la coppia di chiavi RSA dell'app

Per proteggere la connessione, il connettore Box si autentica utilizzando la coppia di chiavi pubbliche/private Rivest-Shamir-Adleman (RSA) dell'app personalizzata. Per creare questa coppia di chiavi in OpenSSL, inserisci i seguenti comandi:

openssl genrsa -out private.pem 2048
openssl rsa -in private.pem -outform PEM -pubout -out public.pem

Questi comandi generano due file:

• private.pem, che contiene la chiave client utilizzata dal connettore per l'autenticazione con Box
• public.pem, che l'app personalizzata richiede per la sua configurazione

Passo 3: Configurare l'app personalizzata

1. Da Dev Console in Box, seleziona Configurazione per l'app personalizzata.
2. In Metodo di autenticazione, verifica che sia selezionato OAuth 2.0 con JWT .
   
3. In Accesso alle applicazioni, seleziona Enterprise e clicca su Salva le modifiche.
   
4. In un editor di testo semplice, apri il file public.pem e copiane l'intero contenuto, compresa la riga di intestazione -----BEGIN PUBLIC KEY-----, la riga di piè di pagina -----END PUBLIC KEY----- e tutti gli spazi intermedi.
5. Da Dev Console in Box, seleziona Configurazione per l'app personalizzata e clicca su Aggiungi una chiave pubblica sotto Aggiungi e gestisci le chiavi pubbliche.
   
   
6. Incolla l'intero contenuto del file public.pem e clicca su Verify and Save.
7. Quando ti viene richiesto, inserisci il codice 2FA del tuo account Box e clicca su Submit.
8. In OAuth 2.0 Credentials, copia l'ID cliente dell'app personalizzata.
   

Passo 4: Autorizzare l'app personalizzata in Box

1. Da Admin Console in Box, clicca su Apps.
2. Nella scheda Custom Apps, clicca su Authorize New App.
3. Incolla l'ID client dell'app personalizzata e clicca su Next.
4. In Autorizzazione app, verifica che l'applicazione sia autorizzata per Tutti gli utenti e clicca su Autorizza.

Passo 5: Aggiungere l'id dell'account del servizio come collaboratore a una cartella di Box

1. Da Dev Console in Box, seleziona Configurazione per l'app personalizzata.
2. Copia l'ID del servizio.
3. Vai alla cartella Box che verrà condivisa. Nella sezione Condivisione, cerca la sezione Collaboratori e clicca su Invita persone per aggiungere l'id dell'account di servizio.
   

Configura il connettore Box

Nota: Per rendere il connettore disponibile per l'uso nelle catene della tua organizzazione, un amministratore della sicurezza dell'org deve prima abilitarlo da Configurazione.

1. Da Builder catena, clicca su Connessioni compare_arrows e poi su Crea in alto a destra.
2. In Connettore Connessione, seleziona Box e il CloudRunner predefinito.
   
3. In Informazioni di base, inserisci un nome e una descrizione unici per identificare la connessione.
4. In Proprietà, inserisci i dettagli della connessione:
   
   

   Proprietà	Dettagli
   ID client	Inserisci l'ID client dell'app personalizzata di Box da utilizzare come integrazione dell'account di servizio del connettore. Nota: Da Dev Console in Box, l'ID del cliente appare sotto Credenziali OAuth 2.0 nella scheda Configurazione dell'app personalizzata.
   Segreto del client	Inserisci il segreto del cliente dell'app personalizzata.  Nota: Da Dev Console in Box, il segreto del cliente appare sotto OAuth 2.0 Credentials nella scheda Configuration dell'app personalizzata.
   Chiave del cliente	Inserisci l'intero contenuto del file private.pem creato per l'app personalizzata, compresa la riga di intestazione -----BEGIN RSA PRIVATE KEY-----, la riga di piè di pagina -----END RSA PRIVATE KEY-----, ed eventuali spazi intermedi.
   ID azienda	Inserisci l'ID aziendale dell'app personalizzata. Nota: Da Dev Console in Box, l'ID dell'impresa appare sotto Informazioni sull'app nella scheda Generale dell'app personalizzata.

   Nota: Tutte le credenziali sensibili vengono automaticamente crittografate e memorizzate con la crittografia Advanced Encryption Standard (AES)-256.

5. Seleziona gli ambienti da utilizzare per la connessione e clicca su Salva.
6. Per testare la connessione, crea ed esegui una catena con il comando Get Folder Info del connettore e verifica che restituisca un output valido.

Risoluzione dei problemi

Se la connessione a Box fallisce:

• Assicurati che l'app personalizzata sia autorizzata in Box.
• Verifica l'ID cliente e il segreto inseriti dall'app personalizzata per il connettore. Da Dev Console in Box, l'ID e il segreto del cliente appaiono sotto OAuth 2.0 Credentials nella scheda Configuration dell'app personalizzata. Per ripristinare le credenziali, clicca su Reset. 
• Assicurati che i contenuti e dei file public.pem e private.pem dell'app personalizzata siano inseriti rispettivamente nelle configurazioni dell'app e del connettore. Includi la riga di intestazione, la riga di piè di pagina ed eventuali spazi intermedi. Se necessario, crea una nuova coppia di chiavi pubbliche/private in OpenSSL e inseriscine il contenuto nelle configurazioni dell'app e del connettore.
• Verifica l'enterprise ID dell'app personalizzata inserito per il connettore. Da Dev Console in Box, l'ID dell'impresa appare sotto App Info nella scheda General dell'app personalizzata.
• Verifica che la cartella condivisa abbia l'ID dell'account del servizio aggiunto come collaboratore.