AWS Inspector
App Vendor: Amazon Web Services
App Category: Vulnerability Management
Connector Version: 1.0.0
API Version: 1.0.0
About App
Amazon inspector is an automated security assessment service that helps improve the security and compliance of applications deployed on AWS.
The AWS Inspector app is configured with the Orchestrate application to perform the following actions:
Action Name | Description |
|---|---|
List Assessment Runs | This action retrieves the assessment runs from a list of templates. |
List Findings | This action retrieves a list of findings from assessment runs. |
Describe Findings | This action retrieves the details of a finding. |
List Assessment Targets | This action retrieves a list of assessment targets. |
Get Assessment Report | This action retrieves an assessment report. |
List Assessment Templates | This action retrieves a list of assessment templates. |
List Assessment Run Agents | This action retrieves a list of assessment-run agents. |
Start Assessment Run | This action starts an assessment run. |
Describe Assessment Targets | This action describes an assessment target. |
List Exclusions | These action list exclusions that are generated by the assessment run. |
Preview Agents | This action retrieves the preview of the agents installed on the EC2 instances |
Configuration Parameters
The following configuration parameters are required for the AWS Inspector app to communicate with the AWS Inspector enterprise application. The parameters can be configured by creating instances in the app.
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Access Key ID | Enter the access key to identify with AWS Inspector. | Text | Required | |
Secret Access Key | Enter the secret access key. | Text | Required | |
Region Name | Enter the region of the AWS inspector instance. | Text | Required |
Action: List Assessment Runs
This action retrieves the assessment runs from a list of templates.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN Templates | Enter the Amazon Resource Name (ARN) templates. | List | Required | |
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate. | Text | Optional | |
Name Pattern | Enter a name pattern to match and retrieve results. | Text | Optional | |
States | Enter the state of the runs to filter by. | List | Optional | Default value: completed |
Action: List findings
This action retrieves a list of findings from assessment runs.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN Templates | Enter the ARN templates to retrieve findings. | List | Required | |
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate. | Text | Optional | |
Get All | Choose to handle pagination and get all findings in a series of internal calls | Boolean | Optional | Allowed values:
|
Action: Describe Findings
This action retrieves the details of a finding.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN Templates | Enter the ARN templates of the findings to retrieve their details. | List | Required |
Action: List Assessment Targets
This action retrieves a list of assessment targets.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate. | Text | Optional | |
Name Pattern | Enter a name pattern to match and retrieve results. | Text | Optional |
Action: Get Assessment Report
This action retrieves an assessment report.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN Templates | Enter the ARN templates to retrieve an assessment report. | Text | Required | |
Report File Format | Enter the file format (HTML or PDF) of the assessment report to generate. | Text | Optional | |
Report Type | Enter the report type to generate. | Text | Optional |
Action: List Assessment Templates
This action retrieves a list of assessment templates.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Assessment Target ARNs | Enter a list of ARNs that specifies the assessment targets whose assessment templates you want to list. | List | Required | |
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate | Text | Optional | |
Name Pattern | Enter a name pattern to match and retrieve results. | Text | Optional |
Action: List Assessment Run Agents
This action retrieves a list of assessment run agents.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Assessment Target ARNs | Enter a list of ARNs that specifies the assessment targets whose assessment templates you want to list. | List | Required | |
Agent Health | Enter the current health state of the agent. | Text | Required | Allowed values:
|
Agent Health Code | Enter the health state of the agent. | Text | Required | Allowed values:
|
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate | Text | Optional |
Action: Start Assessment Run
This action starts an assessment run.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN Templates | Enter the ARN templates. | Text | Required | |
Assessment Run Name | Enter a unique name for an assessment run. | Text | Optional |
Action: Describe Assessment Targets
This action describes an assessment target.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
ARN templates | Enter the ARN templates that you need to describe. | List | Required |
Action: List Exclusions
This action lists exclusions that are generated by the assessment run.
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Assessment Target ARNs | Enter the ARNs that specify the assessment targets whose assessment templates you want to list. | Text | Required | |
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate | Text | Optional |
Action: Preview agents
This action retrieves the preview of the agents installed on the EC2 instances
Action Input Parameters
Parameter | Description | Field Type | Required/Optional | Comments |
|---|---|---|---|---|
Preview Agents ARN | Enter the ARNs that specify the assessment targets you want to preview | Text | Required | |
Max Items | Enter the maximum number of results to be retrieved. | Integer | Optional | |
Next Token | Enter the next token to get another page of responses to effectively paginate. | Text | Optional |