Intégration à Dropbox

Grâce au connecteur d'action Dropbox, vous pouvez accéder à la plateforme Dropbox directement dans Amazon Quick via le langage naturel. Vous pouvez télécharger des fichiers, gérer les structures de dossiers, générer des liens de partage et rechercher du contenu sans quitter Amazon Quick.

Amazon Quick prend en charge plusieurs méthodes d'authentification pour Dropbox. Choisissez la méthode qui répond le mieux aux exigences de sécurité de votre entreprise.

• Application OAuth par défaut — Utilise une application OAuth AWS gérée. Aucune information d'identification supplémentaire n'est requise. Vous vous authentifiez directement avec votre compte Dropbox.

• Application OAuth personnalisée : utilise une application OAuth gérée par le client et enregistrée dans Dropbox. Cette option donne à votre organisation le contrôle total de la configuration OAuth.

• Clé d'API : utilise un jeton d'accès Dropbox pour l'authentification. Cette méthode convient à une utilisation ou à des tests individuels.

Pour plus d'informations sur les méthodes d'authentification prises en charge par Amazon Quick, consultezMéthodes d’authentification.

Avant de commencer

Assurez-vous de disposer des éléments suivants avant de configurer l'intégration.

• Un compte Dropbox actif avec accès aux fichiers et dossiers que vous souhaitez utiliser.

• Pour l'application OAuth personnalisée : accédez à la console d'application Dropbox sur le site Web de Dropbox pour créer une application.

• Pour la clé d'API : jeton d'accès généré depuis la console d'application Dropbox sur le site Web de Dropbox.

• Pour connaître les exigences relatives à l'abonnement Amazon Quick, consultezConfiguration des intégrations dans la console.

Configuration de Dropbox

Si vous utilisez l'authentification par défaut de l'application OAuth, ignorez cette section et passez à. Configuration du connecteur dans Amazon Quick

Pour l'authentification par application OAuth personnalisée ou par clé API, suivez les étapes applicables dans Dropbox avant de configurer Amazon Quick.

Création d'une application Dropbox pour une application OAuth personnalisée

Créez une application dans la console d'application Dropbox pour obtenir les informations d'identification client dont vous avez besoin pour Amazon Quick.

1. Connectez-vous à votre compte Dropbox et accédez à la console d'application Dropbox sur le site Web de Dropbox.

2. Sélectionnez Créer une application.

3. Pour Choisir une API, sélectionnez Accès délimité.

4. Choisissez le type d'accès dont vous avez besoin :

   • Dossier d'applications : permet d'accéder uniquement à un dossier spécifique.

   • Dropbox complet : permet d'accéder à tous les fichiers et dossiers.

5. Entrez le nom de l'application et choisissez Créer une application.

6. Sur la page des paramètres de l'application, enregistrez les valeurs suivantes. Vous en avez besoin lorsque vous configurez Amazon Quick.

   • Clé d'application : il s'agit de votre identifiant client.

   • Secret de l'application — Il s'agit du secret de votre client.

7. Sous OAuth 2, dans la section Redirect URI, ajoutez l'URL de rappel Amazon Quick : https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Choisissez l'onglet Autorisations et sélectionnez les étendues requises par votre intégration. Pour les portées recommandées, voirÉscopes recommandés.

Générer un jeton d'accès pour la clé d'API

Générez un jeton d'accès depuis la console d'application Dropbox pour l'authentification par clé d'API.

1. Connectez-vous à votre compte Dropbox et accédez à la console d'application Dropbox sur le site Web de Dropbox.

2. Choisissez votre application ou créez-en une nouvelle si nécessaire.

3. Sous OAuth 2, choisissez Generate pour créer un jeton d'accès.

4. Copiez et stockez en toute sécurité le jeton généré. Vous en avez besoin lorsque vous configurez Amazon Quick.

Éscopes recommandés

Lorsque vous créez une application Dropbox, configurez les étendues suivantes dans l'onglet Autorisations en fonction des actions que vous souhaitez utiliser.

Éscopes recommandés par Dropbox

Scope	Description
account_info.read	Lit les informations du compte.
account_info.write	Met à jour les informations du compte.
contacts.read	Lit les informations de contact.
contacts.write	Met à jour les informations de contact.
events.read	Lit les entrées du journal des événements.
events.write	Crée des entrées dans le journal des événements.
file_requests.read	Lit les demandes de fichiers.
file_requests.write	Crée et gère les demandes de fichiers.
files.content.read	Lit le contenu du fichier.
files.content.write	Crée, modifie et supprime des fichiers.
files.metadata.read	Lit les métadonnées des fichiers et des dossiers.
files.metadata.write	Modifie les métadonnées des fichiers et des dossiers.
files.permanent_delete	Supprime définitivement les fichiers.
files.team_metadata.read	Lit les métadonnées des fichiers d'équipe.
files.team_metadata.write	Modifie les métadonnées des fichiers d'équipe.
groups.read	Lit les informations du groupe.
groups.write	Gère les groupes.
members.delete	Supprime des membres de l'équipe.
members.read	Lit les informations relatives aux membres de l'équipe.
members.write	Gère les membres de l'équipe.
sessions.list	Répertorie les sessions actives.
sessions.modify	Modifie les sessions actives.
sharing.read	Lit les paramètres de partage et les liens partagés.
sharing.write	Crée et gère les liens partagés et le partage de dossiers.
team_data.content.read	Lit le contenu de l'équipe.
team_data.content.write	Gère le contenu de l'équipe.
team_data.governance.read	Lit les paramètres de gouvernance des données de l'équipe.
team_data.governance.write	Gère les paramètres de gouvernance des données de l'équipe.
team_data.team_space	Accède aux données de l'espace de l'équipe.
team_info.read	Lit les informations de l'équipe.
team_info.write	Met à jour les informations de l'équipe

Configuration du connecteur dans Amazon Quick

Se connecter depuis l'onglet Disponible

Si vous souhaitez utiliser l'authentification par défaut de l'application OAuth, vous pouvez vous connecter directement depuis l'onglet Disponible sans configuration supplémentaire.

1. Dans la console Amazon Quick, choisissez Connectors.

2. Dans l'onglet Disponible, recherchez Dropbox et choisissez Connect.

3. Terminez le processus de connexion à Dropbox et accordez les autorisations demandées.

Pour configurer un connecteur avec une application OAuth personnalisée ou une clé d'API à la place, utilisez l'onglet Créer pour votre équipe, comme décrit ci-dessous.

Créez à partir de l'onglet Créer pour votre équipe

Une fois que vous avez terminé toute configuration requise de Dropbox, créez le connecteur dans Amazon Quick.

1. Dans la console Amazon Quick, choisissez Connectors.

2. Choisissez l'onglet Créer pour votre équipe.

3. Recherchez et choisissez Dropbox.

   Note

   S'il existe déjà un connecteur Dropbox, une boîte de dialogue contenant vos connecteurs existants s'affiche. Pour utiliser un connecteur existant, choisissez-le. Pour en créer un nouveau, choisissez Non, créer un nouveau.

4. Entrez un nom pour votre connecteur. Choisissez éventuellement + Ajouter une description pour ajouter une description.

5. Pour Type de connexion, sélectionnez Réseau public.

6. Pour la configuration OAuth, choisissez l'une des méthodes d'authentification suivantes et configurez les champs obligatoires.

   1. Pour l'application OAuth par défaut :

      Aucune information d'identification supplémentaire n'est requise. Choisissez Next (Suivant) pour continuer.

   2. Pour l'application OAuth personnalisée, configurez les champs suivants :

      • URL de base (facultatif) : URL de base de l'API Dropbox. Exemple : https://api.dropboxapi.com

      • ID client : clé d'application de votre application Dropbox.

      • Secret du client : secret de l'application associé à votre application Dropbox.

      • URL du jeton : point de terminaison du jeton. Exemple : https://api.dropboxapi.com/oauth2/token

      • URL d'autorisation : point de terminaison d'autorisation. Exemple : https://www.dropbox.com/oauth2/authorize

      • URL de redirection : Pre-filled avec l'URL de rappel Amazon Quick.

   3. Pour la clé d'API, configurez les champs suivants :

      • URL de base (facultatif) : URL de base de l'API Dropbox. Exemple : https://api.dropboxapi.com

      • Clé API : votre jeton d'accès Dropbox.

      • E-mail (facultatif) : adresse e-mail associée à votre compte Dropbox.

7. Choisissez Suivant.

8. Si vous avez choisi l'application OAuth par défaut ou l'application OAuth personnalisée, une fenêtre d'autorisation Dropbox s'ouvre. Passez en revue les autorisations demandées et choisissez Autoriser.

9. Sur la page Révision, passez en revue les actions disponibles pour le connecteur. Choisissez Suivant.

10. Sur la page Publier, choisissez qui peut accéder au connecteur. Vous pouvez activer l'accès pour tous les membres de votre organisation ou rechercher des équipes ou des groupes spécifiques.

11. Choisissez Publier.

Actions disponibles

Après avoir configuré le connecteur, les actions suivantes sont disponibles.

Actions disponibles dans Dropbox

Catégorie	Action	Description
Fichiers	Fichiers de liste	Répertorie les fichiers d'un dossier.
Fichiers	Obtenir le fichier	Lit le contenu d'un fichier.
Fichiers	Importer un fichier	Télécharge un fichier dans Dropbox.
Fichiers	Rechercher des fichiers	Recherche des fichiers ou des dossiers par nom ou par contenu.
Fichiers	Mettre à jour l'emplacement du fichier	Déplace un fichier ou un dossier vers un autre emplacement.
Fichiers	Obtenir un lien temporaire	Génère un lien de téléchargement temporaire pour un fichier.
Fichiers	Obtention des métadonnées	Récupère les métadonnées d'un fichier ou d'un dossier.
Fichiers	Enregistrer le fichier à partir de l'URL	Enregistre un fichier dans Dropbox à partir d'une URL.
Dossiers	Create Folder	Crée un nouveau dossier.
Dossiers	Dossiers de liste	Liste des dossiers auxquels l'utilisateur a accès.
Opérations par lots	Obtenir le statut du transfert par lots	Vérifie l'état d'une opération de transfert par lots.
Partage	Créer un lien partagé	Crée un lien partagé pour un fichier ou un dossier.
Partage	Répertorier les liens partagés	Répertorie les liens partagés pour un fichier ou un dossier.
Partage	Mettre à jour le partage de dossiers	Partage un dossier avec d'autres utilisateurs.
Partage	Lister les fichiers reçus	Répertorie les fichiers que d'autres utilisateurs ont partagés avec vous.
Demandes de fichiers	Demande de création de fichier	Crée une demande de fichier dans laquelle d'autres personnes peuvent télécharger des fichiers.
Compte	Obtenir un utilisateur	Récupère les informations relatives à l'utilisateur authentifié.
Compte	Obtenir l'utilisation de l'espace	Récupère l'espace de stockage utilisé pour le compte.

Note

Les actions que vous pouvez utiliser dépendent des fichiers et des dossiers accessibles à l'utilisateur authentifié.

Gestion et résolution des problèmes

Pour modifier, partager ou supprimer votre connecteur, consultezGestion des intégrations existantes.

Problèmes d’authentification

• Sign-in échoue (application OAuth par défaut ou application OAuth personnalisée) : vérifiez que votre compte Dropbox est actif et que vous pouvez vous connecter directement au site Web de Dropbox. Pour l'application OAuth personnalisée, vérifiez que l'URL de redirection de votre application Dropbox correspond à l'URL de rappel Amazon Quick.

• Informations d'identification client non valides (application OAuth personnalisée) : vérifiez que l'ID client et le code secret du client correspondent à la clé d'application et aux valeurs de secret d'application de votre application Dropbox. Si vous avez régénéré le secret de l'application, mettez à jour la valeur dans Amazon Quick.

• Clé d'API rejetée — Vérifiez que votre jeton d'accès est actif. Les jetons peuvent expirer ou être révoqués dans la console d'application Dropbox.

• Autorisations insuffisantes : vérifiez que votre application Dropbox dispose des zones d'autorisation requises pour les actions que vous souhaitez utiliser.