Como conectar um bucket do Amazon S3
Este tutorial mostra como dar à Dattos acesso a um bucket do Amazon S3, para que os processos busquem arquivos de entrada e entreguem arquivos exportados nele. Para entender a integração como um todo, veja Repositórios de arquivos: quais a Dattos conecta e como cadastrar.
O que você precisa
Acesso ao console da AWS com permissão para criar usuários e políticas no IAM (ou alguém do time de nuvem que faça isso).
O bucket já criado. A Dattos não cria buckets: se o nome informado não existir, a conexão falha.
1. Crie as pastas no bucket
No S3, pastas são prefixos do nome dos arquivos. Para que a pasta apareça na lista da Dattos mesmo vazia, crie-a antes no console: abra o bucket e, na aba Objects, clique em Create folder. Por exemplo, dattos/entrada/extratos e dattos/saida/relatorios.
2. Crie o acesso para a Dattos na AWS
No console do IAM, abra Users e crie um usuário exclusivo para a Dattos. Ele não precisa de acesso ao console da AWS.
Dê a esse usuário uma política que permita, só no bucket que a Dattos vai usar, listar o conteúdo (
s3:ListBucket) e ler, gravar e apagar arquivos (s3:GetObject,s3:PutObjectes3:DeleteObject). Um jeito simples é abrir o usuário, ir em Permissions › Add permissions › Create inline policy, escolher o editor JSON e colar a política do exemplo abaixo.Ainda no usuário, abra a aba Security credentials e, em Access keys, clique em Create access key.
A AWS mostra uma página de boas práticas e pede o caso de uso. Escolha Other e avance.
Clique em Create access key. Na página seguinte, clique em Show para ver o Secret access key ou em Download .csv file para baixar os dois valores. É a única vez que a AWS mostra o segredo; se ele se perder, apague a chave e crie outra.
Por que a AWS alerta sobre a chave de acesso: ela é uma credencial de longo prazo, e a AWS recomenda credenciais temporárias sempre que possível. A Dattos usa chave de acesso para conectar ao S3, então proteja a chave com estas medidas: usuário exclusivo, permissão só no bucket da Dattos e troca periódica da chave.
Exemplo de política, trocando nome-do-bucket pelo nome do seu bucket:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": ["s3:ListBucket"],
"Resource": "arn:aws:s3:::nome-do-bucket"
},
{
"Effect": "Allow",
"Action": ["s3:GetObject", "s3:PutObject", "s3:DeleteObject"],
"Resource": "arn:aws:s3:::nome-do-bucket/*"
}
]
}A permissão de apagar é necessária porque a Dattos move os arquivos lidos para subpastas de controle (.processing, .processed e .error). No S3, mover um arquivo é copiar e apagar o original.
3. Cadastre a credencial na Dattos
Clique no ícone de engrenagem e abra Geral › Credenciais.
Clique em + Nova credencial e, na aba Armazenamento, escolha Amazon S3.
Preencha os campos:
Campo | O que informar | Obrigatório |
|---|---|---|
Nome da credencial | Um nome que identifique o bucket, como "S3 Financeiro - extratos" | Sim |
Access Key ID | O identificador da chave criada no passo 2 | Sim |
Secret Access Key | O segredo da chave criada no passo 2 | Sim |
Nome do Bucket | Só o nome do bucket, sem | Sim |
Região | A região onde o bucket foi criado, no formato da AWS (por exemplo, | Sim |
Prefixo | Opcional. Limita a Dattos a uma parte do bucket, por exemplo | Não |
Perfis de privacidade | Quem pode usar esta credencial nos processos | Sim |
Clique em Salvar.
O Amazon S3 não tem o botão Testar conexão. Para conferir o acesso, siga o próximo passo.
4. Confira e ligue o bucket a um processo
Abra um processo Turbo AI com o fluxo publicado e vá em Diretório de Origem.
Clique em Editar na fonte desejada, depois em Adicionar destino.
Em Integração de Armazenamento, escolha a credencial que você criou.
Se as pastas do bucket aparecerem em Pastas de Importação, o acesso está certo. Escolha a pasta e salve.
O passo a passo completo, inclusive da saída, está em Integração com repositórios de arquivos: diretórios de origem e de saída.
Como ver os arquivos do bucket
A Dattos mostra as pastas, mas não os arquivos. Para conferir se o arquivo chegou, se foi para .processed ou para .error, ou se a exportação foi entregue, abra o bucket no console do S3, na aba Objects, com um usuário da sua empresa que tenha acesso de leitura.
Problemas comuns
O que você vê | Causa provável |
|---|---|
Mensagem de que o bucket ou container não foi encontrado | O Nome do Bucket está errado ou o bucket não existe |
Erro ao carregar as pastas | Chave errada, chave desativada na AWS, região diferente da do bucket ou falta da permissão de listar |
As pastas aparecem, mas a execução termina com erro ao ler ou mover o arquivo | Faltam as permissões de leitura, gravação ou exclusão de arquivos |
Uma pasta não aparece na lista | A pasta está fora do Prefixo informado ou ainda não foi criada no bucket |