Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# Integración con Dropbox
<a name="dropbox-integration"></a>

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, consulte[Métodos de autenticación](quick-action-auth.md).

## Antes de empezar
<a name="dropbox-integration-prerequisites"></a>

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](https://www.dropbox.com/developers/apps) 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](https://www.dropbox.com/developers/apps) en el sitio web de Dropbox.
+ Para conocer los requisitos de suscripción a Amazon Quick, consulte[Configurar integraciones en la consola](integration-console-setup-process.md).

## Configuración de Dropbox
<a name="dropbox-source-setup"></a>

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](#dropbox-quicksuite-setup)

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
<a name="dropbox-register-oauth"></a>

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](https://www.dropbox.com/developers/apps) en el sitio web de Dropbox.

1. Seleccione **Crear una aplicación**.

1. En **Elige una API**, selecciona **Acceso limitado**.

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

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

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

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

1. Selecciona la pestaña **Permisos** y selecciona los ámbitos que requiere tu integración. Para conocer los ámbitos recomendados, consulte. [Alcances recomendados](#dropbox-oauth-scopes)

### Genere un token de acceso para la clave de API
<a name="dropbox-create-token"></a>

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](https://www.dropbox.com/developers/apps) en el sitio web de Dropbox.

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

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

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

### Alcances recomendados
<a name="dropbox-oauth-scopes"></a>

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
<a name="dropbox-quicksuite-setup"></a>

### Conectarse desde la pestaña Disponible
<a name="dropbox-quick-connect"></a>

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

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

1. 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
<a name="dropbox-full-setup"></a>

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

1. En la consola Amazon Quick, selecciona **Connectors**.

1. Selecciona la pestaña **Crear para tu equipo**.

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

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

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

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

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

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

1. Elija **Siguiente**.

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

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

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

1. Elija **Publicar**.

## Acciones disponibles
<a name="dropbox-integration-actions"></a>

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
<a name="dropbox-integration-troubleshooting"></a>

Para editar, compartir o eliminar el conector, consulte[Administrar las integraciones existentes](integration-workflows.md#managing-existing-integrations).

### Problemas de autenticación
<a name="dropbox-troubleshooting-auth"></a>
+ **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](https://www.dropbox.com) 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.