Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazione con Dropbox
Con il connettore di azione di Dropbox, puoi accedere alla piattaforma Dropbox direttamente in Amazon Quick tramite linguaggio naturale. Puoi caricare file, gestire strutture di cartelle, generare link di condivisione e cercare contenuti senza uscire da Amazon Quick.
Amazon Quick supporta diversi metodi di autenticazione per Dropbox. Scegli il metodo più adatto ai requisiti di sicurezza della tua organizzazione.
+ App **OAuth predefinita: utilizza un'applicazione** OAuth AWS gestita. Non sono necessarie credenziali aggiuntive. Ti autentichi direttamente con il tuo account Dropbox.
+ App **OAuth personalizzata: utilizza un'applicazione** OAuth gestita dal cliente e registrata in Dropbox. Questa opzione offre alla tua organizzazione il pieno controllo sulla configurazione OAuth.
+ **Chiave API**: utilizza un token di accesso Dropbox per l'autenticazione. Questo metodo è adatto per l'uso o per i test individuali.
Per ulteriori informazioni sui metodi di autenticazione supportati da Amazon Quick, consulta[Metodi di autenticazione](quick-action-auth.md).
## Prima di iniziare
Assicurati di disporre di quanto segue prima di configurare l'integrazione.
+ Un account Dropbox attivo con accesso ai file e alle cartelle che desideri utilizzare.
+ Per l'app **OAuth personalizzata: accedi alla console dell'app** [Dropbox sul sito web di Dropbox per creare un'](https://www.dropbox.com/developers/apps)app.
+ Per la **chiave API**: un token di accesso generato dalla [console dell'app Dropbox sul sito web di Dropbox](https://www.dropbox.com/developers/apps).
+ Per i requisiti di abbonamento ad Amazon Quick, consulta[Configura le integrazioni nella console](integration-console-setup-process.md).
## Configurazione di Dropbox
Se utilizzi l'autenticazione **predefinita dell'app OAuth**, salta questa sezione e vai a. [Configurazione del connettore in Amazon Quick](#dropbox-quicksuite-setup)
Per l'autenticazione personalizzata con app OAuth o chiave API, completa i passaggi applicabili in Dropbox prima di configurare Amazon Quick.
### Crea un'app Dropbox per l'app OAuth personalizzata
Crea un'app nella Console dell'app Dropbox per ottenere le credenziali client di cui hai bisogno per Amazon Quick.
1. Accedi al tuo account Dropbox e vai alla [Console dell'app Dropbox sul sito web](https://www.dropbox.com/developers/apps) di Dropbox.
1. Scegli **Crea app**.
1. **Per **Scegli un'API**, seleziona Accesso con ambito.**
1. Scegli il tipo di accesso di cui hai bisogno:
+ **Cartella dell'app**: fornisce l'accesso solo a una cartella specifica.
+ **Dropbox completo**: fornisce l'accesso a tutti i file e le cartelle.
1. Inserisci il nome di un'app e scegli **Crea app**.
1. Nella pagina delle impostazioni dell'app, registra i seguenti valori. Ne hai bisogno quando configuri Amazon Quick.
+ **Chiave dell'app**: questo è il tuo ID cliente.
+ **App segreta**: questo è il segreto del tuo cliente.
1. In **OAuth 2**, nella sezione URI di **reindirizzamento, aggiungi l'URL** di callback di Amazon Quick: `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`
1. Scegli la scheda **Autorizzazioni** e seleziona gli ambiti richiesti dalla tua integrazione. Per gli ambiti consigliati, consulta. [Ambiti consigliati](#dropbox-oauth-scopes)
### Genera un token di accesso per API Key
Genera un token di accesso dalla console dell'app Dropbox per l'autenticazione con chiave API.
1. Accedi al tuo account Dropbox e vai alla [Console dell'app Dropbox](https://www.dropbox.com/developers/apps) sul sito web di Dropbox.
1. Scegli la tua app o creane una nuova, se necessario.
1. In **OAuth 2**, scegli **Genera** per creare un token di accesso.
1. Copia e archivia in modo sicuro il token generato. Ne hai bisogno quando configuri Amazon Quick.
### Ambiti consigliati
Quando crei un'app Dropbox, configura i seguenti ambiti nella scheda **Autorizzazioni** in base alle azioni che desideri utilizzare.
**Ambiti consigliati da Dropbox**
| Scope | Description |
| --- | --- |
| account\_info.read | Legge le informazioni sull'account. |
| account\_info.write | Aggiorna le informazioni sull'account. |
| contacts.read | Legge le informazioni di contatto. |
| contacts.write | Aggiorna le informazioni di contatto. |
| events.read | Legge le voci del registro degli eventi. |
| events.write | Crea voci del registro degli eventi. |
| file\_requests.read | Legge le richieste di file. |
| file\_requests.write | Crea e gestisce le richieste di file. |
| files.content.read | Legge il contenuto dei file. |
| files.content.write | Crea, modifica ed elimina i file. |
| files.metadata.read | Legge i metadati di file e cartelle. |
| files.metadata.write | Modifica i metadati di file e cartelle. |
| files.permanent\_delete | Elimina definitivamente i file. |
| files.team\_metadata.read | Legge i metadati dei file del team. |
| files.team\_metadata.write | Modifica i metadati dei file del team. |
| groups.read | Legge le informazioni sul gruppo. |
| groups.write | Gestisce i gruppi. |
| members.delete | Rimuove i membri del team. |
| members.read | Legge le informazioni sui membri del team. |
| members.write | Gestisce i membri del team. |
| sessions.list | Elenca le sessioni attive. |
| sessions.modify | Modifica le sessioni attive. |
| sharing.read | Legge le impostazioni di condivisione e i link condivisi. |
| sharing.write | Crea e gestisce link condivisi e condivisione di cartelle. |
| team\_data.content.read | Legge i contenuti del team. |
| team\_data.content.write | Gestisce i contenuti del team. |
| team\_data.governance.read | Legge le impostazioni di governance dei dati del team. |
| team\_data.governance.write | Gestisce le impostazioni di governance dei dati del team. |
| team\_data.team\_space | Accede ai dati dello spazio del team. |
| team\_info.read | Legge le informazioni sul team. |
| team\_info.write | Aggiorna le informazioni sul team. |
## Configurazione del connettore in Amazon Quick
### Connect dalla scheda Available
Se desideri utilizzare l'autenticazione predefinita dell'app OAuth, puoi connetterti direttamente dalla scheda **Disponibile** senza configurazioni aggiuntive.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Nella scheda **Disponibile**, trova **Dropbox** e scegli **Connect**.
1. Completa il flusso di accesso a Dropbox e concedi le autorizzazioni richieste.
Per configurare invece un connettore con un'app OAuth personalizzata o una chiave API, utilizza la scheda **Crea per il tuo team** come descritto di seguito.
### Crea dalla scheda Crea per il tuo team
Dopo aver completato la configurazione Dropbox richiesta, crea il connettore in Amazon Quick.
1. Nella console Amazon Quick, scegli **Connettori**.
1. Scegli la scheda **Crea per il tuo team**.
1. Trova e scegli **Dropbox.**
**Nota**
Se esiste già un connettore Dropbox, viene visualizzata una finestra di dialogo con i connettori esistenti. Per utilizzare un connettore esistente, sceglilo. Per crearne uno nuovo, scegli **No, crea nuovo**.
1. Inserisci un **nome** per il connettore. Facoltativamente, scegli **\+ Aggiungi descrizione** per aggiungere una descrizione.
1. Per **Tipo di connessione**, scegli **Rete pubblica**.
1. Per la **configurazione OAuth**, scegli uno dei seguenti metodi di autenticazione e configura i campi richiesti.
1. Per l'app **OAuth predefinita:**
Non sono necessarie credenziali aggiuntive. Seleziona **Successivo** per continuare.
1. Per l'**app OAuth personalizzata**, configura i seguenti campi:
+ **URL di base** (opzionale): l'URL di base dell'API di Dropbox. Ad esempio: `https://api.dropboxapi.com`
+ **ID cliente**: la chiave dell'app Dropbox.
+ **Segreto del cliente**: il segreto dell'app Dropbox.
+ **URL del token: l'**endpoint del token. Ad esempio: `https://api.dropboxapi.com/oauth2/token`
+ **URL di autorizzazione: l'**endpoint di autorizzazione. Ad esempio: `https://www.dropbox.com/oauth2/authorize`
+ URL **di reindirizzamento: Pre-filled con l'URL** di callback di Amazon Quick.
1. Per **API Key**, configura i seguenti campi:
+ **URL di base** (opzionale): l'URL di base dell'API di Dropbox. Ad esempio: `https://api.dropboxapi.com`
+ **Chiave API**: il tuo token di accesso a Dropbox.
+ **Email** (opzionale): l'indirizzo email associato al tuo account Dropbox.
1. Scegli **Next (Successivo)**.
1. Se scegli l'app **OAuth predefinita o l'app OAuth** **personalizzata, si apre una finestra di autorizzazione** Dropbox. **Controlla le autorizzazioni richieste e scegli Consenti.**
1. Nella pagina **Revisione**, esamina le azioni disponibili per il connettore. Scegli **Next (Successivo)**.
1. Nella pagina **Pubblica**, scegli chi può accedere al connettore. Puoi attivare l'accesso per tutti i membri dell'organizzazione o cercare team o gruppi specifici.
1. Seleziona **Pubblica**.
## Operazioni disponibili
Dopo aver configurato il connettore, sono disponibili le seguenti azioni.
**Azioni disponibili in Dropbox**
| Categoria | Azione | Description |
| --- | --- | --- |
| File | Elenca i file | Elenca i file in una cartella. |
| File | Ottieni file | Legge il contenuto di un file. |
| File | File di importazione | Carica un file su Dropbox. |
| File | Cerca file | Cerca file o cartelle per nome o contenuto. |
| File | Aggiorna la posizione del file | Sposta un file o una cartella in una posizione diversa. |
| File | Ottieni un link temporaneo | Genera un link temporaneo per il download di un file. |
| File | Recupero dei metadati | Recupera i metadati per un file o una cartella. |
| File | Salva file da URL | Salva un file in Dropbox da un URL. |
| Cartelle | Create Folder | Crea una nuova cartella. |
| Cartelle | Elenca cartelle | Elenco delle cartelle a cui l'utente ha accesso. |
| Operazioni batch | Ottieni lo stato di trasferimento in Batch | Controlla lo stato di un'operazione di spostamento in batch. |
| Condivisione | Crea link condiviso | Crea un link condiviso per un file o una cartella. |
| Condivisione | Elenca i link condivisi | Elenca i link condivisi per un file o una cartella. |
| Condivisione | Aggiorna la condivisione delle cartelle | Condivide una cartella con altri utenti. |
| Condivisione | Elenca i file ricevuti | Elenca i file che altri utenti hanno condiviso con te. |
| Richieste di file | Crea richiesta di file | Crea una richiesta di file su cui altri possono caricare file. |
| Account | Ottieni utente | Recupera informazioni sull'utente autenticato. |
| Account | Ottieni l'utilizzo dello spazio | Recupera l'utilizzo dello spazio di archiviazione per l'account. |
**Nota**
Le azioni che è possibile utilizzare dipendono dai file e dalle cartelle accessibili all'utente autenticato.
## Gestione e risoluzione dei problemi
Per modificare, condividere o eliminare il connettore, consulta[Gestione delle integrazioni esistenti](integration-workflows.md#managing-existing-integrations).
### Problemi di autenticazione
+ **Sign-in fallisce (app OAuth predefinita o app OAuth personalizzata)**[: verifica che il tuo account Dropbox sia attivo e che tu possa accedere direttamente al sito web di Dropbox.](https://www.dropbox.com) Per l'app OAuth personalizzata, verifica che l'URL di reindirizzamento nell'app Dropbox corrisponda all'URL di callback Amazon Quick.
+ **Credenziali client non valide (app OAuth personalizzata)**: verifica che l'ID cliente e il segreto del cliente corrispondano alla chiave dell'app e ai valori segreti dell'app nella tua app Dropbox. Se hai rigenerato il segreto dell'app, aggiorna il valore in Amazon Quick.
+ **Chiave API rifiutata**: verifica che il token di accesso sia attivo. I token possono scadere o essere revocati nella console dell'app Dropbox.
+ **Autorizzazioni insufficienti**: verifica che la tua app Dropbox disponga degli ambiti di autorizzazione richiesti per le azioni che desideri utilizzare.