AWS Inspector
Collects vulnerability findings from Amazon Inspector v2 to monitor security issues across EC2 instances, ECR container images, and Lambda functions.
Sync Type: Incremental
Details
Amazon Inspector is an automated vulnerability management service that continuously scans AWS workloads for software vulnerabilities and unintended network exposure. This input connector retrieves security findings from Inspector v2 in your AWS account.
Functionality
On each sync, Monad connects to Amazon Inspector in the specified region and retrieves vulnerability findings, sorted by their last observed time (LastObservedAt).
The input keeps a checkpoint of the latest LastObservedAt it has sent, and later syncs request only findings observed at or after that checkpoint.
If Backfill Start Time is not set, the first sync starts from now and no past findings are fetched.
Only findings with status ACTIVE are requested.
When a finding changes to CLOSED or SUPPRESSED, that change is never emitted, so a finding's last record from Monad always shows it as active; use Inspector itself to confirm whether a finding has been closed.
The checkpoint has no lookback window, so a finding whose LastObservedAt is earlier than the checkpoint but becomes visible in Inspector only after a sync has run is not collected.
Requirements
- IAM Role Assumption / Static Credentials
- Example permission to attach to the role/user:
Code
Configuration
The following configuration defines the input parameters. Each field's specifications, such as type, requirements, and descriptions, are detailed below.
Settings
| Setting | Type | Required | Default | Description |
|---|---|---|---|---|
role_arn | string | No | - | The ARN of the IAM role to assume for accessing AWS resources. |
region | string | Yes | us-east-1 | The AWS region to use. Allowed values: us-east-1, us-east-2, us-west-1, us-west-2, af-south-1, ap-east-1, ap-south-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-southeast-1, ap-southeast-2, ca-central-1, ca-west-1, cn-north-1, cn-northwest-1, eu-central-1, eu-west-1, eu-west-2, eu-west-3, eu-north-1, eu-south-1, me-south-1, sa-east-1, us-gov-east-1, us-gov-west-1. |
severities | array of string | No | - | Severity levels of findings to fetch (Informational, Low, Medium, High, Critical). Allowed values: INFORMATIONAL, LOW, MEDIUM, HIGH, CRITICAL. |
use_synthetic_data | bool | No | false | Generate synthetic data for testing, instead of connecting to a real data source. Defaults to an hourly cron schedule for cron-based inputs. |
backfill_start_time | date | No | - | The date to start fetching data from. If not specified, no past records will be fetched. |
Secrets (Static Credentials Only)
| Secret | Type | Required | Description |
|---|---|---|---|
access_key | secret | No | The Access Key from AWS to authenticate with AWS |
secret_key | secret | No | The Secret Key from AWS to authenticate with AWS |
Authentication: Choose either Role ARN (recommended) or static credentials. See AWS Authentication Guide for setup instructions.
Related Articles
Sample Record
Code
Sync frequency
By default this input polls approximately every 10 seconds, with each sync beginning after the previous one completes. A cron schedule configured on the pipeline overrides this cadence. See Input Sync Frequency for details.
Community transforms
The Monad Transforms Repository has ready-made transforms for this input. Import one into your organization, then add it to a pipeline after this input.
| Format | Transform |
|---|---|
| OCSF v1.9.0 | AWS Inspector Findings to OCSF v1.9.0 |
| ECS v9.5.0 | AWS Inspector Findings to ECS v9.5.0 |
| CEF | AWS Inspector Findings to CEF |
CEF transforms emit an intermediate record; add the CEF Serializer transform after one to produce the CEF:0 string.