AWS Connection
Read-only keys BackupLens uses to monitor your AWS Backup
—
ℹ️Select the AWS Region(s) that hold your backup vaults. Most single-Region customers pick one.
How to create the service account
One-time setup in your AWS account — takes about 2 minutes
What BackupLens needs: a dedicated IAM user with
read-only access to AWS Backup and Cost Explorer. It can never modify,
delete, or restore anything in your account.
- In the AWS Console open IAM → Users → Create user. Name it
backuplens-monitor. Do not give it console access. - Attach these permissions:
- A single custom policy of read actions only. Nothing in it can create, modify, start or delete anything.
- Required — these are the exact read actions BackupLens calls:
backup:ListBackupJobs · backup:ListBackupPlans · backup:ListBackupVaults · backup:ListCopyJobs · backup:ListRestoreJobs · backup:ListProtectedResources · ce:GetCostAndUsage · ce:GetCostForecast · sts:GetCallerIdentity
- Recommended — for per-job and per-vault drill-down detail on the dashboard:
backup:ListBackupSelections · backup:GetBackupSelection · backup:GetBackupPlan · backup:ListLegalHolds · backup:GetLegalHold · backup:ListRestoreTestingPlans · backup:ListRestoreTestingSelections · backup:ListReportPlans · backup:ListFrameworks · backup:DescribeFramework · backup:ListRecoveryPointsByBackupVault · backup:ListTags · backup:DescribeRegionSettings
- VMware / Backup Gateway customers: to show real VM names instead of vm-000… IDs, also allow backup-gateway:ListVirtualMachines, ListHypervisors, ListGateways and ListTagsForResource — all read-only.
- We deliberately do not use the AWS managed policy AWSBackupOperatorAccess: it also grants StartBackupJob, StartCopyJob and StartRestoreJob. BackupLens never writes, so every action is listed individually and your security team can verify that none of them modify anything.
- Open the new user → Security credentials → Create access key → choose Application running outside AWS.
- Copy the Access key ID and Secret access key into the form above, pick your Region(s), and press Save credentials — we verify them with AWS before storing them (encrypted).
Or run this script (fastest)
Paste into AWS CloudShell — it creates the service account and prints your keys
In the AWS Console, click the CloudShell icon (terminal symbol in the top bar), paste this, press Enter,
and copy the two values it prints into the form above. Requires permission to create IAM users (an admin runs it once).
#!/bin/bash
# BackupLens service-account setup (read-only monitoring)
set -e
U=backuplens-monitor
aws iam create-user --user-name $U >/dev/null
aws iam put-user-policy --user-name $U --policy-name backuplens-readonly --policy-document '{"Version":"2012-10-17","Statement":[
{"Sid":"BackupRead","Effect":"Allow","Action":["backup:ListBackupJobs","backup:ListBackupVaults","backup:ListBackupPlans","backup:ListProtectedResources","backup:ListRecoveryPointsByBackupVault","backup:ListBackupSelections","backup:GetBackupSelection","backup:GetBackupPlan","backup:ListCopyJobs","backup:ListRestoreJobs","backup:ListLegalHolds","backup:GetLegalHold","backup:ListRestoreTestingPlans","backup:ListRestoreTestingSelections","backup:ListReportPlans","backup:ListFrameworks","backup:DescribeFramework","backup:ListTags","backup:DescribeRegionSettings"],"Resource":"*"},
{"Sid":"CostRead","Effect":"Allow","Action":["ce:GetCostAndUsage","ce:GetCostForecast"],"Resource":"*"},
{"Sid":"GatewayRead","Effect":"Allow","Action":["backup-gateway:ListVirtualMachines","backup-gateway:ListHypervisors","backup-gateway:ListGateways","backup-gateway:ListTagsForResource"],"Resource":"*"},
{"Sid":"Identity","Effect":"Allow","Action":"sts:GetCallerIdentity","Resource":"*"}]}'
OUT=$(aws iam create-access-key --user-name $U --query 'AccessKey.[AccessKeyId,SecretAccessKey]' --output text)
echo ""
echo "================ COPY THESE INTO BACKUPLENS ================"
echo "Access Key ID: $(echo $OUT | cut -d' ' -f1)"
echo "Secret Access Key: $(echo $OUT | cut -d' ' -f2)"
echo "=============================================================="
echo "(The secret is shown ONLY once — paste it into BackupLens now.)"