Integración con Dropbox

Con el conector de acción de Dropbox, puedes acceder a la plataforma de Dropbox directamente en Amazon Quick mediante un lenguaje natural. Puede cargar archivos, gestionar estructuras de carpetas, generar enlaces para compartir y buscar contenido sin salir de Amazon Quick.

Amazon Quick admite varios métodos de autenticación para Dropbox. Elige el método que mejor se adapte a los requisitos de seguridad de tu organización.

• Aplicación OAuth predeterminada: utiliza una aplicación OAuth AWS gestionada. No se necesitan credenciales adicionales. Te autenticas directamente con tu cuenta de Dropbox.

• Aplicación OAuth personalizada: utiliza una aplicación OAuth gestionada por el cliente que está registrada en Dropbox. Esta opción le da a tu organización el control total sobre la configuración de OAuth.

• Clave de API: utiliza un token de acceso de Dropbox para la autenticación. Este método es adecuado para uso individual o para pruebas.

Para obtener más información sobre los métodos de autenticación que admite Amazon Quick, consulteMétodos de autenticación.

Antes de empezar

Asegúrese de disponer de lo siguiente antes de configurar la integración.

• Una cuenta de Dropbox activa con acceso a los archivos y carpetas que quieras usar.

• Para una aplicación OAuth personalizada: accede a la consola de aplicaciones de Dropbox en el sitio web de Dropbox para crear una aplicación.

• Para la clave de API: un token de acceso que se genera desde la consola de aplicaciones de Dropbox en el sitio web de Dropbox.

• Para conocer los requisitos de suscripción a Amazon Quick, consulteConfigurar integraciones en la consola.

Configuración de Dropbox

Si utilizas la autenticación por defecto de la aplicación OAuth, omite esta sección y ve a. Configuración del conector en Amazon Quick

Para autenticar una aplicación OAuth personalizada o una clave de API, sigue los pasos correspondientes en Dropbox antes de configurar Amazon Quick.

Crea una aplicación de Dropbox para una aplicación OAuth personalizada

Crea una aplicación en la consola de aplicaciones de Dropbox para obtener las credenciales de cliente que necesitas para Amazon Quick.

1. Inicia sesión en tu cuenta de Dropbox y accede a la consola de aplicaciones de Dropbox en el sitio web de Dropbox.

2. Seleccione Crear una aplicación.

3. En Elige una API, selecciona Acceso limitado.

4. Elige el tipo de acceso que necesitas:

   • Carpeta de aplicaciones: proporciona acceso solo a una carpeta específica.

   • Dropbox completo: proporciona acceso a todos los archivos y carpetas.

5. Introduce el nombre de la aplicación y selecciona Crear aplicación.

6. En la página de configuración de la aplicación, registre los siguientes valores. Los necesitas cuando configuras Amazon Quick.

   • Clave de aplicación: es tu ID de cliente.

   • Secreto de la aplicación: este es el secreto de su cliente.

7. En OAuth 2, en la sección URI de redireccionamiento, añade la URL de devolución de llamada rápida de Amazon: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Selecciona la pestaña Permisos y selecciona los ámbitos que requiere tu integración. Para conocer los ámbitos recomendados, consulte. Alcances recomendados

Genere un token de acceso para la clave de API

Genera un token de acceso desde la consola de aplicaciones de Dropbox para autenticar la clave de API.

1. Inicia sesión en tu cuenta de Dropbox y accede a la consola de aplicaciones de Dropbox en el sitio web de Dropbox.

2. Elige tu aplicación o crea una nueva si es necesario.

3. En OAuth 2, selecciona Generar para crear un token de acceso.

4. Copia y almacena de forma segura el token generado. Lo necesitas cuando configuras Amazon Quick.

Alcances recomendados

Al crear una aplicación de Dropbox, configura los siguientes ámbitos en la pestaña Permisos en función de las acciones que quieras usar.

Ámbitos recomendados por Dropbox

Alcance	Description (Descripción)
account_info.read	Lee la información de la cuenta.
account_info.write	Actualiza la información de la cuenta.
contacts.read	Lee la información de contacto.
contacts.write	Actualiza la información de contacto.
events.read	Lee las entradas del registro de eventos.
events.write	Crea entradas de registro de eventos.
file_requests.read	Lee las solicitudes de archivos.
file_requests.write	Crea y gestiona las solicitudes de archivos.
files.content.read	Lee el contenido del archivo.
files.content.write	Crea, modifica y elimina archivos.
files.metadata.read	Lee los metadatos de archivos y carpetas.
files.metadata.write	Edita los metadatos de archivos y carpetas.
files.permanent_delete	Elimina archivos de forma permanente.
files.team_metadata.read	Lee los metadatos de los archivos del equipo.
files.team_metadata.write	Edita los metadatos de los archivos del equipo.
groups.read	Lee la información del grupo.
groups.write	Administra grupos.
members.delete	Elimina a los miembros del equipo.
members.read	Lee la información de los miembros del equipo.
members.write	Administra a los miembros del equipo.
sessions.list	Muestra las sesiones activas.
sessions.modify	Modifica las sesiones activas.
sharing.read	Lee la configuración de uso compartido y los enlaces compartidos.
sharing.write	Crea y gestiona los enlaces compartidos y el uso compartido de carpetas.
team_data.content.read	Lee el contenido del equipo.
team_data.content.write	Administra el contenido del equipo.
team_data.governance.read	Lee la configuración de gobierno de los datos del equipo.
team_data.governance.write	Administra la configuración de gobierno de los datos del equipo.
team_data.team_space	Accede a los datos del espacio del equipo.
team_info.read	Lee la información del equipo.
team_info.write	Actualiza la información del equipo.

Configuración del conector en Amazon Quick

Conectarse desde la pestaña Disponible

Si quieres usar la autenticación de la aplicación OAuth predeterminada, puedes conectarte directamente desde la pestaña Disponible sin necesidad de realizar ninguna configuración adicional.

1. En la consola Amazon Quick, selecciona Connectors.

2. En la pestaña Disponible, busca Dropbox y selecciona Connect.

3. Completa el proceso de inicio de sesión de Dropbox y concede los permisos solicitados.

Para configurar un conector con una aplicación OAuth personalizada o una clave de API, usa la pestaña Crear para tu equipo, tal y como se describe a continuación.

Crea desde la pestaña Crear para tu equipo

Tras completar cualquier configuración de Dropbox requerida, crea el conector en Amazon Quick.

1. En la consola Amazon Quick, selecciona Connectors.

2. Selecciona la pestaña Crear para tu equipo.

3. Busca y elige Dropbox.

   nota

   Si ya existe un conector de Dropbox, aparecerá un cuadro de diálogo con los conectores existentes. Para usar un conector existente, elíjalo. Para crear uno nuevo, elija No, crear nuevo.

4. Introduzca un nombre para el conector. Si lo desea, elija + Añadir descripción para añadir una descripción.

5. En Tipo de conexión, elija Red pública.

6. Para la configuración de OAuth, elija uno de los siguientes métodos de autenticación y configure los campos obligatorios.

   1. Para la aplicación OAuth predeterminada:

      No se necesitan credenciales adicionales. Elija Siguiente para continuar.

   2. Para la aplicación OAuth personalizada, configura los siguientes campos:

      • URL base (opcional): la URL base de la API de Dropbox. Ejemplo: https://api.dropboxapi.com

      • ID de cliente: la clave de aplicación de tu aplicación de Dropbox.

      • Secreto de cliente: el secreto de aplicación de tu aplicación de Dropbox.

      • URL del token: el punto final del token. Ejemplo: https://api.dropboxapi.com/oauth2/token

      • URL de autorización: el punto final de autorización. Ejemplo: https://www.dropbox.com/oauth2/authorize

      • URL de redireccionamiento: Pre-filled con la URL de devolución de llamada rápida de Amazon.

   3. Para la clave de API, configure los siguientes campos:

      • URL base (opcional): la URL base de la API de Dropbox. Ejemplo: https://api.dropboxapi.com

      • Clave de API: tu token de acceso a Dropbox.

      • Correo electrónico (opcional): la dirección de correo electrónico asociada a tu cuenta de Dropbox.

7. Elija Siguiente.

8. Si seleccionas la aplicación OAuth predeterminada o la aplicación OAuth personalizada, se abrirá una ventana de autorización de Dropbox. Revisa los permisos solicitados y selecciona Permitir.

9. En la página de revisión, revise las acciones disponibles para el conector. Elija Siguiente.

10. En la página de publicación, elija quién puede acceder al conector. Puedes activar el acceso para todos los miembros de tu organización o buscar equipos o grupos específicos.

11. Elija Publicar.

Acciones disponibles

Tras configurar el conector, estarán disponibles las siguientes acciones.

Acciones disponibles en Dropbox

Categoría	Action	Description (Descripción)
Archivos	Lista de archivos	Muestra los archivos de una carpeta.
Archivos	Obtener archivo	Lee el contenido de un archivo.
Archivos	Importar archivo	Carga un archivo a Dropbox.
Archivos	Busca archivos	Busca archivos o carpetas por nombre o contenido.
Archivos	Actualizar la ubicación del archivo	Mueve un archivo o una carpeta a una ubicación diferente.
Archivos	Obtenga un enlace temporal	Genera un enlace de descarga temporal para un archivo.
Archivos	Obtención de metadatos	Recupera los metadatos de un archivo o una carpeta.
Archivos	Guarda el archivo desde la URL	Guarda un archivo en Dropbox desde una URL.
Carpetas	Crear carpeta	Crea una carpeta nueva.
Carpetas	Lista de carpetas	Lista de carpetas a las que tiene acceso el usuario.
Operaciones por lotes	Obtenga el estado de Batch Move	Comprueba el estado de una operación de traslado de lotes.
Uso compartido	Crear enlace compartido	Crea un enlace compartido para un archivo o una carpeta.
Uso compartido	Enumere los enlaces compartidos	Muestra los enlaces compartidos de un archivo o una carpeta.
Uso compartido	Actualiza el uso compartido de carpetas	Comparte una carpeta con otros usuarios.
Uso compartido	Listar los archivos recibidos	Muestra los archivos que otros usuarios han compartido contigo.
Solicitudes de archivos	Solicitud de creación de archivos	Crea una solicitud de archivo para que otros usuarios puedan subir archivos.
Cuenta	Obtener usuario	Recupera información sobre el usuario autenticado.
Cuenta	Obtenga el uso del espacio	Recupera el uso del espacio de almacenamiento de la cuenta.

nota

Las acciones que puede utilizar dependen de los archivos y carpetas a los que pueda acceder el usuario autenticado.

Administración y solución de problemas

Para editar, compartir o eliminar el conector, consulteAdministrar las integraciones existentes.

Problemas de autenticación

• Sign-in falla (aplicación OAuth predeterminada o aplicación OAuth personalizada): verifica que tu cuenta de Dropbox esté activa y que puedas iniciar sesión directamente en el sitio web de Dropbox. En el caso de la aplicación OAuth personalizada, confirma que la URL de redireccionamiento de tu aplicación de Dropbox coincide con la URL de devolución rápida de Amazon.

• Credenciales de cliente no válidas (aplicación OAuth personalizada): comprueba que el ID de cliente y el secreto de cliente coincidan con los valores de clave y secreto de aplicación de tu aplicación de Dropbox. Si has regenerado el secreto de la aplicación, actualiza el valor en Amazon Quick.

• Clave de API rechazada: compruebe que su token de acceso esté activo. Los tokens pueden caducar o revocarse en la consola de aplicaciones de Dropbox.

• Permisos insuficientes: verifica que tu aplicación de Dropbox tenga los permisos necesarios para las acciones que quieres usar.