¿Cómo configuro un bucket de Amazon S3?
- Crea un bucket de S3 en la región de AWS que elijas. Mantén habilitado Block Public Access y usa Bucket owner enforced como Object Ownership para tener un bucket privado. Anota el nombre y la región del bucket.
- Configura una identidad de AWS dedicada para Transloadit, restringida al bucket y al prefijo de destino. Sigue la política de permisos de /s3/store, incluidos sus permisos adicionales para etiquetas, detección de la región y cifrado. No uses claves de acceso de la cuenta raíz.
- Guarda una credencial de Template de Amazon S3 con el ID de clave de acceso (
key), la clave de acceso secreta (secret),bucketybucket_region. Mantén los secretos de AWS en backends de confianza. Para credenciales de AWS de corta duración, sigue las indicaciones sobre credenciales temporales del Robot. - Haz referencia al nombre de la credencial en tu Template y establece explícitamente
acl: "bucket-default". Si omitesacl, se usa el valor predeterminadopublic-readdel Robot;privatetambién envía una ACL. El siguiente ejemplo omite el encabezado de ACL y escribe bajo el prefijouploads/de la política:
{
"steps": {
":original": {
"robot": "/upload/handle"
},
"exported": {
"robot": "/s3/store",
"use": ":original",
"credentials": "YOUR_S3_CREDENTIALS",
"acl": "bucket-default",
"path": "uploads/${unique_prefix}/${file.url_name}"
}
}
}
- Sustituye
YOUR_S3_CREDENTIALSpor el nombre de la credencial guardada. Guardar credenciales no autoriza las subidas: autentica a los usuarios y autoriza las subidas en tu backend, y haz que la Signature Authentication sea obligatoria para los flujos de navegador firmados. Sigue las indicaciones para proteger credenciales e Instructions antes de exponer un flujo de subida. - Prueba el Template con un archivo no sensible, revisa el Assembly Status completado y verifica el objeto en tu bucket. Una URL de resultado devuelta no concede acceso público de lectura. El permiso de escritura puede sobrescribir claves existentes; elige rutas únicas y considera usar el control de versiones de S3 para poder recuperar datos.
Más información
- Para obtener más detalles sobre los Templates y la seguridad, consulta nuestra documentación de Templates.
- Para obtener más información sobre cómo guardar en S3, por ejemplo, cómo personalizar los nombres de archivo, consulta la documentación de 🤖/s3/store.
- Para subir archivos desde tu propia aplicación Node.js, sigue el tutorial de subida a Amazon S3. Los tutoriales de almacenamiento de archivos (English) también cubren flujos de trabajo con curl y rclone.