Como configuro um app do Dropbox?
Crie um app do Dropbox, escolha as permissões necessárias para seu fluxo de trabalho e conecte-o por meio de Credenciais de Template. A Transloadit cuida do redirecionamento OAuth e da troca de tokens; você não precisa criar seu próprio callback nem colar um token de acesso temporário no seu Template.
Criar o app
Faça login no Dropbox App Console com a conta à qual o app pertencerá. Selecione Create app e depois Scoped access.
Escolha App folder quando o fluxo de trabalho precisar apenas de arquivos na pasta do próprio app. Escolha Full Dropbox somente quando ele precisar de arquivos em outros locais da conta conectada. Dê um nome ao app e selecione Create app.
Com acesso App folder, os caminhos do Robot são relativos à pasta do app, não à raiz da conta do Dropbox. Não inclua no caminho do Robot o caminho completo da pasta do app a partir da raiz da conta.
Escolher permissões
Abra a aba Permissions do app e habilite os escopos necessários para seu fluxo de trabalho:
| Fluxo de trabalho | Escopos |
|---|---|
| Importar arquivos com /dropbox/import | files.metadata.read e files.content.read |
| Exportar arquivos com /dropbox/store | files.content.write |
Exportar com create_sharing_link: true | Habilite também sharing.write |
Para importações de um espaço de equipe do Dropbox Business com acesso
Full Dropbox, verifique se
account_info.read está selecionado para que a Transloadit possa resolver o namespace de
arquivos da conta. Se o fluxo de trabalho importar e exportar arquivos, habilite os dois conjuntos de
permissões de arquivos. Selecione Submit para
salvar as alterações antes de conectar o app.
Registrar o URI de redirecionamento
Na aba Settings do app, encontre OAuth 2 e adicione o seguinte valor exato em Redirect URIs:
https://webapi.transloadit.com/credentials/dropbox
Selecione Add para registrá-lo. Este é o callback da Transloadit, não uma URL do seu site. Tenha à mão os valores de App key e App secret do app para a próxima etapa; nunca inclua esse segredo em código executado no navegador, capturas de tela ou Templates compartilhados.
Conectar o app à Transloadit
Siga Como criar Credenciais de Template no Workspace que executará suas Assemblies. Escolha Dropbox como serviço, dê à credencial um Nome fácil de identificar e preencha Chave do app do Dropbox e Segredo do app do Dropbox com os valores das configurações do seu app.
Selecione Criar para abrir a página de autorização do Dropbox. Faça login na conta do Dropbox
cujos arquivos o fluxo de trabalho usará e aprove o acesso solicitado. O Dropbox redireciona você de
volta à Transloadit, que salva a credencial. Confirme que ela aparece na página Credenciais do
Workspace antes de usar o nome da credencial como valor de credentials do Robot.
Criar um app não é o mesmo que autorizá-lo. Se você cancelar a autorização ou encontrar um erro, não presuma que a credencial foi salva. Confira o URI de redirecionamento e as permissões do app e inicie a conexão novamente. Revise a conta e o acesso solicitado na tela de consentimento do Dropbox; aprove apenas o acesso que pretende conceder.
Alterar as permissões do app posteriormente não adiciona essas permissões a uma autorização existente. Crie uma nova Credencial de Template e aprove o acesso novamente. Em seguida, atualize seus Templates para usar o novo nome dessa credencial. Retire de uso as credenciais substituídas somente depois de confirmar que nenhum fluxo de trabalho ainda as utiliza. Se a Transloadit pedir que você confirme sua senha novamente, conclua essa etapa antes de reiniciar a conexão.
Para obter detalhes sobre a configuração e a autorização de apps do Dropbox, consulte o guia de início rápido e o guia de OAuth do Dropbox.