Overview
This document outlines the architectural patterns and security requirements for ingesting and processing log files stored in Amazon S3 via the onefirewall Virtual Machine.Prerequisites & Core Requirements
Security First
Avoid static long-term credentials (IAM Access Keys) wherever possible in favor of short-lived tokens.
Least Privilege
Restrict permissions strictly to
s3:GetObject and s3:ListBucket on the designated log prefixes.Authentication Patterns
The authentication model depends on whether the onefirewall VM is hosted natively inside AWS or in an external environment.- AWS Native (EC2)
- Non-AWS / On-Premises
IAM Instance Profiles
If the VM is running inside AWS as an EC2 instance, do not use access keys. Attach an IAM Role directly to the VM instance profile.- Mechanism: AWS Instance Metadata Service (IMDSv2) automatically issues short-lived security credentials.
- Rotation: Managed automatically by AWS without application downtime.
- Code Integration: AWS SDKs pick up the role credentials transparently.

