agent-bom-scan-infra

name	agent-bom-scan-infra
description	Scan infrastructure-as-code, cloud configurations, and find secrets. Use when: "check terraform", "scan kubernetes", "IaC", "find secrets", "scan dockerfile", "cloud security", "misconfigurations".
version	0.96.3
license	Apache-2.0
compatibility	Requires Python 3.11+. Install via pipx or pip. Optional: kubectl for Kubernetes checks. Cloud checks use locally configured credentials (AWS/Azure/GCP/Snowflake) when explicitly invoked.
metadata	{"author":"msaad00","homepage":"https://github.com/msaad00/agent-bom","source":"https://github.com/msaad00/agent-bom","pypi":"https://pypi.org/project/agent-bom/","scorecard":"https://securityscorecards.dev/viewer/?uri=github.com/msaad00/agent-bom","tests":7239,"install":{"pipx":"agent-bom","pip":"agent-bom","docker":"ghcr.io/msaad00/agent-bom:0.96.3"},"openclaw":{"requires":{"bins":[],"env":[],"credentials":"none"},"credential_policy":"Zero credentials required for IaC and secrets scanning. Cloud checks (AWS/Azure/GCP/Snowflake) optionally accept cloud credentials — only used locally to call cloud APIs, never transmitted elsewhere.","credential_handling":"Use local scanner redaction before reporting secrets. Optional cloud credentials stay in the operator environment and must not be printed, persisted, or forwarded.","optional_env":[{"name":"AWS_PROFILE","purpose":"AWS CIS benchmark checks — uses boto3 with your local AWS profile","required":false},{"name":"AZURE_TENANT_ID","purpose":"Azure CIS benchmark checks (azure-mgmt-* SDK)","required":false},{"name":"AZURE_CLIENT_ID","purpose":"Azure CIS benchmark checks — service principal client ID","required":false},{"name":"AZURE_CLIENT_SECRET","purpose":"Azure CIS benchmark checks — service principal secret","required":false},{"name":"GOOGLE_APPLICATION_CREDENTIALS","purpose":"GCP CIS benchmark checks (google-cloud-* SDK)","required":false},{"name":"SNOWFLAKE_ACCOUNT","purpose":"Snowflake CIS benchmark checks","required":false},{"name":"SNOWFLAKE_USER","purpose":"Snowflake CIS benchmark checks","required":false},{"name":"SNOWFLAKE_PRIVATE_KEY_PATH","purpose":"Snowflake key-pair auth (CI/CD)","required":false},{"name":"SNOWFLAKE_AUTHENTICATOR","purpose":"Snowflake auth method (default: externalbrowser SSO)","required":false}],"optional_bins":["kubectl"],"emoji":"🏗","homepage":"https://github.com/msaad00/agent-bom","source":"https://github.com/msaad00/agent-bom","license":"Apache-2.0","os":["darwin","linux","windows"],"data_flow":"IaC and secrets scanning is purely local — no network calls. Cloud benchmark checks (optional, user-initiated) call cloud provider APIs (AWS/Azure/GCP/Snowflake) using locally configured credentials. No data is stored or transmitted beyond the cloud provider's own API.","file_reads":["user-specified IaC directories (Terraform, CloudFormation, Kubernetes YAML)","user-specified Dockerfiles","user-specified cloud configuration files"],"file_writes":[],"network_endpoints":[{"url":"https://*.amazonaws.com","purpose":"AWS CIS benchmark checks — read-only API calls (IAM, S3, CloudTrail, etc.)","auth":true,"optional":true},{"url":"https://management.azure.com","purpose":"Azure CIS benchmark checks — read-only API calls (Azure Resource Manager)","auth":true,"optional":true},{"url":"https://*.googleapis.com","purpose":"GCP CIS benchmark checks — read-only API calls (Cloud Resource Manager, IAM, etc.)","auth":true,"optional":true},{"url":"https://*.snowflakecomputing.com","purpose":"Snowflake CIS benchmark checks — read-only API calls (ACCOUNT_USAGE views)","auth":true,"optional":true}],"telemetry":false,"persistence":false,"privilege_escalation":false,"always":false,"autonomous_invocation":"restricted"}}

agent-bom-scan-infra — Infrastructure & Cloud Security Scanner

Scans infrastructure-as-code (Terraform, CloudFormation, Kubernetes), finds secrets in config files, and runs cloud CIS benchmarks against AWS, Azure, GCP, and Snowflake.

Install

pipx install agent-bom
agent-bom iac infra/         # scan Terraform/CloudFormation/K8s
agent-bom cloud aws          # AWS CIS benchmark
agent-bom cloud azure        # Azure CIS benchmark
agent-bom cloud gcp          # GCP CIS benchmark
agent-bom scan --snowflake --snowflake-cis-benchmark
agent-bom secrets .          # find secrets in current directory

When to Use

• "check terraform" / "scan terraform"
• "scan kubernetes" / "K8s security"
• "IaC" / "infrastructure as code"
• "find secrets" / "secret scanning"
• "scan dockerfile"
• "cloud security" / "CIS benchmark"
• "misconfigurations"

Commands

# Scan IaC directory
agent-bom iac infra/

# Run cloud CIS benchmark
agent-bom cloud aws
agent-bom cloud azure
agent-bom cloud gcp
agent-bom scan --snowflake --snowflake-cis-benchmark

# Find secrets in files
agent-bom secrets .

Tools

Tool	Description
iac	Scan Terraform, CloudFormation, Kubernetes YAML for misconfigurations
cloud	CIS benchmark checks (AWS, Azure v3.0, GCP v3.0, Snowflake)
secrets	Find secrets and credentials in files and directories

Examples

# Scan IaC directory for misconfigurations
iac(path="infra/")

# Run AWS CIS benchmark
cloud(provider="aws")

# Find secrets in project
secrets(path=".")

Guardrails

• Confirm with the user before running cloud CIS benchmarks — these make live read-only API calls to AWS/Azure/GCP using the user's locally configured credentials.
• IaC and secrets scanning is purely local — no network calls.
• Do not modify any infrastructure files.
• Ask the user before scanning paths outside their home or project directory.
• Cloud credentials are used only to call the cloud provider's own APIs and are never transmitted elsewhere.