Keep copies of collected logs and other add-in data in Amazon S3, set up by signing in to AWS from the firewall. No keys to copy:

You need:

How it works

 your browser                      Korthveil firewall                         AWS
 ┌──────────────────┐  code     ┌──────────────────────────┐  sign-in   ┌───────────────────────────┐
 │ approve the code │ ◀──────── │ 1 sign in (device code)  │ ─────────▶ │ IAM Identity Center       │
 │ (AWS login, MFA) │           │ 2 list accounts, roles   │            │ S3: buckets, folders      │
 └──────────────────┘           │ 3 bucket, folder         │ ─────────▶ │ IAM: user korthveil-...   │
                                │ 4 create its own user    │            │  policy: this folder only │
                                │   and key; test it       │            └───────────────────────────┘
                                │ 5 sign out               │
                                └──────────────────────────┘

What the firewall keeps from your sign-in: nothing.

Step 1: Find your access portal URL

In the AWS console, open IAM Identity Center › Settings. Note the AWS access portal URL (for example https://d-1234567890.awsapps.com/start) and the Region shown on the same page.

Step 2: Sign in from the firewall

Go to System › Network storage, panel Amazon S3 archive, tab Sign in with AWS (recommended):

Click Sign in with AWS.

The sign-in step
The sign-in step

The firewall shows a code. Click Open AWS sign-in, sign in as usual (with MFA), and check that the page shows the same code before you click Confirm and continue and Allow. The firewall notices within a few seconds.

The code to confirm in the browser
The code to confirm in the browser

Only approve codes you started yourself: anyone who approves a code gives that firewall their access.

Step 3: Choose the account and role

Choose the AWS account that should hold the archive, and a role (permission set) that may manage S3 and IAM.

Account and role
Account and role

Step 4: Choose or create the bucket

The list shows every bucket of the account with its region.

New buckets are private (all public access blocked) and encrypted (SSE-S3).

The bucket browser
The bucket browser

Step 5: Choose the folder

Browse into the bucket.

The key the firewall gets may use this folder and nothing else.

The folder browser
The folder browser

Step 6: Set up the archive

The archive settings
The archive settings

Click Finish. The firewall:

  1. creates the AWS user korthveil-<firewall>-<name> (path /korthveil/, tagged with the firewall's name);
  2. gives it a policy for this bucket folder only, and an access key;
  3. writes and deletes a test file to check the key works;
  4. adds the destination and schedule to pending changes;
  5. signs you out of AWS.
Done
Done

Step 7: Commit and test

Commit the pending changes. Then, under System › Schedules & delivery:

The first archive appears in the folder in S3. Restore archives under System › Backup & restore.

Later

To Do
Replace the key Run the setup again with the same name. The firewall makes a new key. The previous one keeps working until you commit; delete it afterwards in AWS (IAM › Users › korthveil-… › Security credentials).
Stop archiving Delete the schedule and destination, commit, then delete the IAM user korthveil-… in AWS.
Keep archives longer or cheaper In S3, add a lifecycle rule to the folder (for example to Glacier after 90 days). The firewall only adds files.
Use keys you already have Tab Enter access keys in the same panel.

Troubleshooting

Symptom Check
"the start URL is your AWS access portal address" Copy the AWS access portal URL exactly from IAM Identity Center › Settings.
The code page says the code is invalid or expired Codes last 10 minutes. Click Cancel and sign in again.
"AWS refused: the chosen role may not do this" The permission set needs S3 (list, create bucket) and IAM (create user, put user policy, create access key). Choose another role, or ask your AWS administrator.
"that bucket name is taken" Bucket names are global across AWS. Choose another.
"the new key could not write to the folder" A bucket policy or an SCP may deny the new user. Check the bucket's policy and your organization's SCPs.
Nothing happens after approving The firewall must reach oidc.<region>.amazonaws.com, portal.sso.<region>.amazonaws.com, iam.amazonaws.com, and s3.amazonaws.com over HTTPS. With outbound filtering on (Firewall › Outbound), allow them during the setup.

More: adr/0066 describes the design and its security; adr/0049 describes the archives.