Skip to main content

S3 Integration — Implementation Summary

Actionable notes for engineers and operators implementing S3-backed storage.

Key components​

  • InternalAwsS3IntegrationInitializer — config & boot
  • AwsS3IntegrationUtil — helpers for buckets, regions, roles
  • S3StorageDriver — low-level implementation
  • FileUploadService — presigned multipart orchestrator
  • FileController — REST endpoints for init/upload/complete

Flow​

  1. Initialize internal account and bucket
  2. Initiate multipart session → return presigned URLs
  3. Upload parts directly to S3
  4. Complete the upload via API (ETags confirmation)

Common issues​

  • 403: permissions / role/bucket policy
  • Clock skew: presigned URL validations fail
  • Multipart errors: mismatch ETags or missing parts

See also: S3 AWS Integration Quick Ref