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, consultaMetodi di autenticazione.

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'app.

• Per la chiave API: un token di accesso generato dalla console dell'app Dropbox sul sito web di Dropbox.

• Per i requisiti di abbonamento ad Amazon Quick, consultaConfigura le integrazioni nella console.

Configurazione di Dropbox

Se utilizzi l'autenticazione predefinita dell'app OAuth, salta questa sezione e vai a. Configurazione del connettore in Amazon Quick

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 di Dropbox.

2. Scegli Crea app.

3. Per Scegli un'API, seleziona Accesso con ambito.

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

5. Inserisci il nome di un'app e scegli Crea app.

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

7. In OAuth 2, nella sezione URI di reindirizzamento, aggiungi l'URL di callback di Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Scegli la scheda Autorizzazioni e seleziona gli ambiti richiesti dalla tua integrazione. Per gli ambiti consigliati, consulta. Ambiti consigliati

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 sul sito web di Dropbox.

2. Scegli la tua app o creane una nuova, se necessario.

3. In OAuth 2, scegli Genera per creare un token di accesso.

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

2. Nella scheda Disponibile, trova Dropbox e scegli Connect.

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

2. Scegli la scheda Crea per il tuo team.

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

4. Inserisci un nome per il connettore. Facoltativamente, scegli + Aggiungi descrizione per aggiungere una descrizione.

5. Per Tipo di connessione, scegli Rete pubblica.

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

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

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

7. Scegli Next (Successivo).

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

9. Nella pagina Revisione, esamina le azioni disponibili per il connettore. Scegli Next (Successivo).

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

11. 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, consultaGestione delle integrazioni esistenti.

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