Cómo conectar un bucket de Amazon S3
Este tutorial muestra cómo conceder a Dattos acceso a un bucket de Amazon S3 para que los procesos busquen archivos de entrada y entreguen en él los archivos exportados. Para entender la integración en su conjunto, consulta Repositorios de archivos: cuáles conecta Dattos y cómo registrarlos.
Qué necesitas
Acceso a la consola de AWS con permiso para crear usuarios y políticas en IAM (o alguien del equipo de nube que pueda hacerlo).
El bucket ya debe estar creado. Dattos no crea buckets: si el nombre indicado no existe, la conexión falla.
1. Crea las carpetas en el bucket
En S3, las carpetas son prefijos del nombre de los archivos. Para que la carpeta aparezca en la lista de Dattos aunque esté vacía, créala antes en la consola: abre el bucket y, en la pestaña Objects, haz clic en Create folder. Por ejemplo, dattos/entrada/extratos y dattos/saida/relatorios.
2. Crea el acceso para Dattos en AWS
En la consola de IAM, abre Users y crea un usuario exclusivo para Dattos. No necesita acceso a la consola de AWS.
Asigna a este usuario una política que le permita, solo en el bucket que usará Dattos, listar el contenido (
s3:ListBucket) y leer, escribir y eliminar archivos (s3:GetObject,s3:PutObjectys3:DeleteObject). Una forma sencilla es abrir el usuario, ir a Permissions › Add permissions › Create inline policy, elegir el editor JSON y pegar la política del ejemplo siguiente.En el usuario, abre la pestaña Security credentials y, en Access keys, haz clic en Create access key.
AWS muestra una página de buenas prácticas y pregunta por el caso de uso. Elige Other y continúa.
Haz clic en Create access key. En la página siguiente, haz clic en Show para ver la Secret access key o en Download .csv file para descargar ambos valores. AWS solo muestra el secreto una vez; si lo pierdes, elimina la clave y crea otra.
Por qué AWS muestra una alerta sobre la clave de acceso: es una credencial de larga duración, y AWS recomienda usar credenciales temporales siempre que sea posible. Dattos usa una clave de acceso para conectarse a S3, así que protégela con estas medidas: un usuario exclusivo, permiso solo en el bucket de Dattos y cambio periódico de la clave.
Ejemplo de política; reemplaza nome-do-bucket por el nombre de tu 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/*"
}
]
}El permiso para eliminar es necesario porque Dattos mueve los archivos leídos a subcarpetas de control (.processing, .processed y .error). En S3, mover un archivo implica copiarlo y eliminar el original.
3. Registra la credencial en Dattos
Haz clic en el icono de engranaje y abre General › Credenciales.
Haz clic en + Nueva credencial y, en la pestaña Almacenamiento, elige Amazon S3.
Completa los campos:
Campo | Qué indicar | Obligatorio |
|---|---|---|
Nombre de la credencial | Un nombre que identifique el bucket, como «S3 Finanzas - extractos» | Sí |
Access Key ID | El identificador de la clave creada en el paso 2 | Sí |
Secret Access Key | El secreto de la clave creada en el paso 2 | Sí |
Nombre del bucket | Solo el nombre del bucket, sin | Sí |
Región | La región donde se creó el bucket, en el formato de AWS (por ejemplo, | Sí |
Prefijo | Opcional. Limita Dattos a una parte del bucket, por ejemplo | No |
Perfiles de privacidad | Quién puede usar esta credencial en los procesos | Sí |
Haz clic en Guardar.
Amazon S3 no tiene el botón Probar conexión. Para comprobar el acceso, sigue el paso siguiente.
4. Comprueba y vincula el bucket a un proceso
Abre un proceso de Turbo AI con el flujo publicado y ve a Directorio de origen.
Haz clic en Editar en la fuente deseada y, después, en Añadir destino.
En Integración de almacenamiento, elige la credencial que creaste.
Si las carpetas del bucket aparecen en Carpetas de importación, el acceso está configurado correctamente. Elige la carpeta y guarda.
Encontrarás los pasos completos, incluida la configuración de la salida, en Integración con repositorios de archivos: directorios de origen y de salida.
Cómo ver los archivos del bucket
Dattos muestra las carpetas, pero no los archivos. Para comprobar si el archivo llegó, si se movió a .processed o a .error, o si se entregó la exportación, abre el bucket en la consola de S3, en la pestaña Objects, con un usuario de tu empresa que tenga acceso de lectura.
Problemas comunes
Qué ves | Causa probable |
|---|---|
Mensaje que indica que no se encontró el bucket o el contenedor | El Nombre del bucket es incorrecto o el bucket no existe |
Error al cargar las carpetas | La clave es incorrecta, está desactivada en AWS, la región no coincide con la del bucket o falta el permiso para listar |
Las carpetas aparecen, pero la ejecución termina con un error al leer o mover el archivo | Faltan los permisos para leer, escribir o eliminar archivos |
No aparece una carpeta en la lista | La carpeta está fuera del Prefijo indicado o todavía no se ha creado en el bucket |