Integração com o Dropbox

Com o conector de ação do Dropbox, você pode acessar a plataforma do Dropbox diretamente no Amazon Quick por meio de linguagem natural. Você pode fazer upload de arquivos, gerenciar estruturas de pastas, gerar links de compartilhamento e pesquisar conteúdo sem sair do Amazon Quick.

O Amazon Quick oferece suporte a vários métodos de autenticação para o Dropbox. Escolha o método que melhor se adapta aos requisitos de segurança da sua organização.

• Aplicativo OAuth padrão — usa um aplicativo OAuth AWS gerenciado. Nenhuma credencial adicional é necessária. Você se autentica diretamente com sua conta do Dropbox.

• Aplicativo OAuth personalizado — usa um aplicativo OAuth gerenciado pelo cliente que está registrado no Dropbox. Essa opção dá à sua organização controle total sobre a configuração do OAuth.

• Chave de API — usa um token de acesso do Dropbox para autenticação. Este método é adequado para uso ou teste individual.

Para obter mais informações sobre os métodos de autenticação compatíveis com o Amazon Quick, consulteMétodos de autenticação.

Antes de começar

Verifique se você tem o seguinte antes de configurar a integração.

• Uma conta ativa do Dropbox com acesso aos arquivos e pastas que você deseja usar.

• Para um aplicativo OAuth personalizado: acesso ao console do aplicativo do Dropbox no site do Dropbox para criar um aplicativo.

• Para chave de API: um token de acesso que é gerado a partir do console de aplicativos do Dropbox no site do Dropbox.

• Para obter os requisitos de assinatura do Amazon Quick, consulteConfigurar integrações no console.

Configurando o Dropbox

Se você estiver usando a autenticação padrão do aplicativo OAuth, pule esta seção e acesse. Configurando o conector no Amazon Quick

Para autenticação personalizada do aplicativo OAuth ou da chave de API, conclua as etapas aplicáveis no Dropbox antes de configurar o Amazon Quick.

Crie um aplicativo do Dropbox para um aplicativo OAuth personalizado

Crie um aplicativo no console de aplicativos do Dropbox para obter as credenciais de cliente que você precisa para o Amazon Quick.

1. Acesse sua conta do Dropbox e acesse o console de aplicativos do Dropbox no site do Dropbox.

2. Escolha Criar aplicação.

3. Em Escolher uma API, selecione Acesso com escopo.

4. Escolha o tipo de acesso que você precisa:

   • Pasta do aplicativo — fornece acesso somente a uma pasta específica.

   • Dropbox completo — Fornece acesso a todos os arquivos e pastas.

5. Insira o nome do aplicativo e escolha Criar aplicativo.

6. Na página de configurações do aplicativo, registre os seguintes valores. Você precisa deles ao configurar o Amazon Quick.

   • Chave do aplicativo — Esse é o seu ID de cliente.

   • Segredo do aplicativo — Este é o segredo do seu cliente.

7. Em OAuth 2, na seção URIs de redirecionamento, adicione a URL de retorno de chamada do Amazon Quick: https://{region}.quicksight.aws.amazon.com/sn/oauthcallback

8. Escolha a guia Permissões e selecione os escopos que sua integração exige. Para obter os escopos recomendados, consulteEscopos recomendados.

Gere um token de acesso para a chave de API

Gere um token de acesso no console do aplicativo do Dropbox para autenticação com chave de API.

1. Acesse sua conta do Dropbox e acesse o console de aplicativos do Dropbox no site do Dropbox.

2. Escolha seu aplicativo ou crie um novo, se necessário.

3. Em OAuth 2, escolha Gerar para criar um token de acesso.

4. Copie e armazene com segurança o token gerado. Você precisa dele ao configurar o Amazon Quick.

Escopos recomendados

Ao criar um aplicativo do Dropbox, configure os seguintes escopos na guia Permissões com base nas ações que você deseja usar.

Escopos recomendados pelo Dropbox

Escopo	Description
account_info.read	Lê as informações da conta.
account_info.write	Atualiza as informações da conta.
contacts.read	Lê as informações de contato.
contacts.write	Atualiza as informações de contato.
events.read	Lê as entradas do registro de eventos.
events.write	Cria entradas de registro de eventos.
file_requests.read	Lê solicitações de arquivo.
file_requests.write	Cria e gerencia solicitações de arquivos.
files.content.read	Lê o conteúdo do arquivo.
files.content.write	Cria, modifica e exclui arquivos.
files.metadata.read	Lê os metadados de arquivos e pastas.
files.metadata.write	Edita metadados de arquivos e pastas.
files.permanent_delete	Exclui arquivos permanentemente.
files.team_metadata.read	Lê os metadados do arquivo da equipe.
files.team_metadata.write	Edita os metadados do arquivo da equipe.
groups.read	Lê as informações do grupo.
groups.write	Gerencia grupos.
members.delete	Remove os membros da equipe.
members.read	Lê as informações dos membros da equipe.
members.write	Gerencia os membros da equipe.
sessions.list	Lista as sessões ativas.
sessions.modify	Modifica as sessões ativas.
sharing.read	Lê as configurações de compartilhamento e os links compartilhados.
sharing.write	Cria e gerencia links compartilhados e compartilhamento de pastas.
team_data.content.read	Lê o conteúdo da equipe.
team_data.content.write	Gerencia o conteúdo da equipe.
team_data.governance.read	Lê as configurações de governança de dados da equipe.
team_data.governance.write	Gerencia as configurações de governança de dados da equipe.
team_data.team_space	Acessa os dados do espaço da equipe.
team_info.read	Lê as informações da equipe.
team_info.write	Atualiza as informações da equipe.

Configurando o conector no Amazon Quick

Conecte-se a partir da guia Disponível

Se quiser usar a autenticação padrão do aplicativo OAuth, você pode se conectar diretamente da guia Disponível sem configuração adicional.

1. No console do Amazon Quick, escolha Conectores.

2. Na guia Disponível, encontre o Dropbox e escolha Conectar.

3. Conclua o fluxo de login do Dropbox e conceda as permissões solicitadas.

Para configurar um conector com o aplicativo OAuth personalizado ou a chave de API, use a guia Criar para sua equipe, conforme descrito abaixo.

Crie a partir da guia Criar para sua equipe

Depois de concluir qualquer configuração necessária do Dropbox, crie o conector no Amazon Quick.

1. No console do Amazon Quick, escolha Conectores.

2. Escolha a guia Criar para sua equipe.

3. Encontre e escolha o Dropbox.

   nota

   Se um conector do Dropbox já existir, uma caixa de diálogo será exibida com seus conectores existentes. Para usar um conector existente, escolha-o. Para criar um novo, escolha Não, criar novo.

4. Insira um nome para seu conector. Opcionalmente, escolha + Adicionar descrição para adicionar uma descrição.

5. Em Tipo de conexão, escolha Rede pública.

6. Para Configuração do OAuth, escolha um dos métodos de autenticação a seguir e configure os campos obrigatórios.

   1. Para o aplicativo OAuth padrão:

      Nenhuma credencial adicional é necessária. Escolha Próximo para continuar.

   2. Para o aplicativo OAuth personalizado, configure os seguintes campos:

      • URL base (opcional) — A URL base da API do Dropbox. Exemplo: https://api.dropboxapi.com

      • ID do cliente — A chave do aplicativo do seu aplicativo do Dropbox.

      • Segredo do cliente — O segredo do aplicativo do Dropbox.

      • URL do token — O endpoint do token. Exemplo: https://api.dropboxapi.com/oauth2/token

      • URL de autorização — O endpoint de autorização. Exemplo: https://www.dropbox.com/oauth2/authorize

      • URL de redirecionamento — Pre-filled com o URL de retorno de chamada do Amazon Quick.

   3. Para a chave de API, configure os seguintes campos:

      • URL base (opcional) — A URL base da API do Dropbox. Exemplo: https://api.dropboxapi.com

      • Chave de API — Seu token de acesso ao Dropbox.

      • E-mail (opcional) — O endereço de e-mail associado à sua conta do Dropbox.

7. Escolha Próximo.

8. Se você escolher o aplicativo OAuth padrão ou o aplicativo OAuth personalizado, uma janela de autorização do Dropbox será aberta. Revise as permissões solicitadas e escolha Permitir.

9. Na página Revisar, revise as ações disponíveis para o conector. Escolha Próximo.

10. Na página Publicar, escolha quem pode acessar o conector. Você pode ativar o acesso para todos em sua organização ou pesquisar equipes ou grupos específicos.

11. Selecione Publish.

Ações disponíveis

Depois de configurar o conector, as ações a seguir estarão disponíveis.

Ações disponíveis do Dropbox

Categoria	Ação	Description
Arquivos	Listar arquivos	Lista os arquivos em uma pasta.
Arquivos	Obter arquivo	Lê o conteúdo de um arquivo.
Arquivos	Importar arquivo	Carrega um arquivo para o Dropbox.
Arquivos	Pesquisar arquivos	Pesquisa arquivos ou pastas por nome ou conteúdo.
Arquivos	Atualizar localização do arquivo	Move um arquivo ou pasta para um local diferente.
Arquivos	Obter link temporário	Gera um link de download temporário para um arquivo.
Arquivos	Obter metadados	Recupera metadados de um arquivo ou pasta.
Arquivos	Salvar arquivo do URL	Salva um arquivo no Dropbox a partir de uma URL.
Pastas	Criar pasta	Cria uma pasta.
Pastas	Listar pastas	Lista de pastas às quais o usuário tem acesso.
Operações em lote	Obter status de movimentação em lote	Verifica o status de uma operação de movimentação em lote.
Compartilhar	Criar link compartilhado	Cria um link compartilhado para um arquivo ou pasta.
Compartilhar	Listar links compartilhados	Lista links compartilhados para um arquivo ou pasta.
Compartilhar	Atualizar compartilhamento de pastas	Compartilha uma pasta com outros usuários.
Compartilhar	Listar arquivos recebidos	Lista os arquivos que outros usuários compartilharam com você.
Solicitações de arquivo	Criar solicitação de arquivo	Cria uma solicitação de arquivo para que outras pessoas façam upload de arquivos.
Conta	Obter usuário	Recupera informações sobre o usuário autenticado.
Conta	Obtenha o uso do espaço	Recupera o uso do espaço de armazenamento da conta.

nota

As ações que você pode usar dependem dos arquivos e pastas acessíveis ao usuário autenticado.

Gerenciamento e solução de problemas

Para editar, compartilhar ou excluir seu conector, consulteGerenciando integrações existentes.

Problemas de autenticação

• Sign-in falha (aplicativo OAuth padrão ou aplicativo OAuth personalizado) — Verifique se sua conta do Dropbox está ativa e se você pode acessar diretamente o site do Dropbox. Para o aplicativo OAuth personalizado, confirme se a URL de redirecionamento em seu aplicativo do Dropbox corresponde à URL de retorno de chamada do Amazon Quick.

• Credenciais de cliente inválidas (aplicativo OAuth personalizado) — Verifique se o ID do cliente e o segredo do cliente correspondem aos valores da chave e do segredo do aplicativo em seu aplicativo do Dropbox. Se você regenerou o segredo do aplicativo, atualize o valor no Amazon Quick.

• Chave de API rejeitada — verifique se seu token de acesso está ativo. Os tokens podem expirar ou ser revogados no console de aplicativos do Dropbox.

• Permissões insuficientes — Verifique se seu aplicativo do Dropbox tem os escopos de permissão necessários para as ações que você deseja usar.