Comment configurer une application Dropbox ?
Créez une application Dropbox, choisissez les autorisations nécessaires à votre flux de travail et connectez-la via des informations d’identification de Template. Transloadit gère la redirection OAuth et l’échange de jetons ; vous n’avez pas besoin de créer votre propre mécanisme de rappel ni de coller un jeton d’accès temporaire dans votre Template.
Créer l’application
Connectez-vous à la Dropbox App Console avec le compte qui sera propriétaire de l’application. Sélectionnez Create app, puis Scoped access.
Choisissez App folder si le flux de travail n’a besoin que des fichiers du dossier propre à l’application. Ne choisissez Full Dropbox que s’il a besoin de fichiers situés ailleurs dans le compte connecté. Nommez l’application et sélectionnez Create app.
Avec l’accès App folder, les chemins du Robot sont relatifs au dossier de l’application, et non à la racine du compte Dropbox. N’incluez pas dans le chemin du Robot le chemin menant à ce dossier depuis la racine du compte.
Choisir les autorisations
Ouvrez l’onglet Permissions de l’application et activez les portées nécessaires à votre flux de travail :
| Flux de travail | Portées |
|---|---|
| Importer des fichiers avec /dropbox/import | files.metadata.read et files.content.read |
| Exporter des fichiers avec /dropbox/store | files.content.write |
Exporter avec create_sharing_link: true | Activer aussi sharing.write |
Pour les importations depuis un espace d’équipe Dropbox Business avec un accès
Full Dropbox, vérifiez que
account_info.read est sélectionné afin que Transloadit puisse résoudre l’espace de
noms des fichiers du compte. Si le flux de travail importe et exporte des fichiers, activez les
deux ensembles d’autorisations sur les fichiers. Sélectionnez
Submit pour enregistrer les modifications
avant de connecter l’application.
Enregistrer l’URI de redirection
Dans l’onglet Settings de l’application, repérez OAuth 2 et ajoutez la valeur exacte suivante sous Redirect URIs :
https://webapi.transloadit.com/credentials/dropbox
Sélectionnez Add pour l’enregistrer. Il s’agit de l’URL de rappel de Transloadit, et non d’une URL de votre site web. Gardez les valeurs des champs App key et App secret de l’application à portée de main pour l’étape suivante ; n’incluez jamais le secret dans le code du navigateur, dans des captures d’écran ou dans des Templates partagés.
Connecter l’application à Transloadit
Suivez le guide Comment créer un ensemble d’informations d’identification de Template dans le Workspace qui exécutera vos Assemblies. Choisissez Dropbox comme service, donnez à l’ensemble d’informations d’identification un Nom reconnaissable et renseignez les champs Clé d’application Dropbox et Secret d’application Dropbox avec les valeurs figurant dans les paramètres de votre application.
Sélectionnez Créer pour ouvrir la page d’autorisation de Dropbox. Connectez-vous au compte
Dropbox dont le flux de travail utilisera les fichiers, puis approuvez l’accès demandé. Dropbox
vous redirige vers Transloadit, qui enregistre l’ensemble d’informations d’identification.
Vérifiez qu’il apparaît sur la page Informations d’identification du Workspace avant d’utiliser
son nom comme valeur du paramètre credentials du Robot.
Créer une application ne revient pas à l’autoriser. Si vous annulez l’autorisation ou rencontrez une erreur, ne supposez pas que l’ensemble d’informations d’identification a été enregistré. Vérifiez l’URI de redirection et les autorisations de l’application, puis relancez la connexion. Examinez le compte et l’accès demandé sur l’écran de consentement de Dropbox ; n’approuvez que l’accès que vous souhaitez accorder.
Modifier ultérieurement les autorisations de l’application ne les ajoute pas à une autorisation déjà accordée. Créez un nouvel ensemble d’informations d’identification de Template et approuvez à nouveau l’accès, puis mettez à jour vos Templates pour utiliser son nouveau nom. Retirez les ensembles d’informations d’identification remplacés uniquement après avoir vérifié qu’aucun flux de travail ne les utilise encore. Si Transloadit vous demande de confirmer à nouveau votre mot de passe, effectuez cette étape avant de relancer la connexion.
Pour plus de détails sur la configuration et l’autorisation des applications Dropbox, consultez le guide de démarrage rapide et le guide OAuth de Dropbox.