¿Cómo configuro una aplicación de Dropbox?
Crea una aplicación de Dropbox, elige los permisos que necesita tu flujo de trabajo y conéctala mediante las credenciales de Template. Transloadit gestiona la redirección OAuth y el intercambio de tokens; no necesitas crear tu propio callback ni pegar un token de acceso temporal en tu Template.
Crea la aplicación
Inicia sesión en la consola de aplicaciones de Dropbox con la cuenta que será propietaria de la aplicación. Selecciona Create app y luego Scoped access.
Elige App folder cuando el flujo de trabajo solo necesite archivos de la carpeta de la propia aplicación. Elige Full Dropbox solo cuando necesite archivos en otras ubicaciones de la cuenta conectada. Dale un nombre a la aplicación y selecciona Create app.
Con el acceso App folder, las rutas del Robot son relativas a la carpeta de la aplicación, no a la raíz de la cuenta de Dropbox. No incluyas en la ruta del Robot la ruta desde la raíz de la cuenta hasta esa carpeta.
Elige los permisos
Abre la pestaña Permissions de la aplicación y activa los ámbitos necesarios para tu flujo de trabajo:
| Flujo de trabajo | Ámbitos |
|---|---|
| Importar archivos con /dropbox/import | files.metadata.read y files.content.read |
| Exportar archivos con /dropbox/store | files.content.write |
Exportar con create_sharing_link: true | Activa también sharing.write |
Para importar desde un espacio de equipo de Dropbox Business con acceso
Full Dropbox, asegúrate de que esté seleccionado
account_info.read para que Transloadit pueda resolver el espacio de nombres de los archivos
de la cuenta. Si el flujo de trabajo importa y exporta archivos, activa ambos conjuntos de permisos
de archivos. Selecciona Submit para guardar los cambios antes
de conectar la aplicación.
Registra la URI de redirección
En la pestaña Settings de la aplicación, busca OAuth 2 y agrega el siguiente valor exacto en Redirect URIs:
https://webapi.transloadit.com/credentials/dropbox
Selecciona Add para registrar la URI. Este es el callback de Transloadit, no una URL de tu sitio web. Ten a mano los valores de App key y App secret de la aplicación para el siguiente paso; nunca incluyas el secreto en el código del navegador, en capturas de pantalla ni en Templates compartidos.
Conecta la aplicación a Transloadit
Sigue las instrucciones de Cómo crear credenciales de Template en el Workspace que ejecutará tus Assemblies. Elige Dropbox como servicio, asigna a la credencial un Nombre reconocible y completa los campos Clave de la aplicación de Dropbox y Secreto de la aplicación de Dropbox con los valores de la configuración de tu aplicación.
Selecciona Crear para abrir la página de autorización de Dropbox. Inicia sesión en la cuenta de
Dropbox cuyos archivos usará el flujo de trabajo y aprueba el acceso solicitado. Dropbox te redirige
a Transloadit, que guarda la credencial. Confirma que aparezca en la página Credenciales del
Workspace antes de usar su nombre como valor de credentials del Robot.
Crear una aplicación no es lo mismo que autorizarla. Si cancelas la autorización o se produce un error, no des por hecho que la credencial se guardó. Revisa la URI de redirección y los permisos de la aplicación y luego inicia de nuevo la conexión. Revisa la cuenta y el acceso solicitado en la pantalla de consentimiento de Dropbox; aprueba solo el acceso que tengas intención de conceder.
Cambiar los permisos de la aplicación más adelante no agrega esos permisos a una autorización existente. Crea una nueva credencial de Template y vuelve a aprobar el acceso; luego, actualiza tus Templates para que usen su nuevo nombre. Retira las credenciales sustituidas solo después de confirmar que ningún flujo de trabajo las sigue usando. Si Transloadit te pide que confirmes tu contraseña de nuevo, completa ese paso antes de reiniciar la conexión.
Para obtener detalles sobre la configuración y la autorización de aplicaciones de Dropbox, consulta su guía de inicio rápido y su guía de OAuth.