Skip to main content

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.

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.

Ingestion Models

scheduled polling based on latency requirements.

1. AWS OFA Log Adapter

Scanning the bucket continuously to new incoming log files and processing with AWS OFA Log Adapter