Configure Inspector Inputs for the Splunk Add-on for AWS¶
Complete the steps to configure Inspector inputs for the Splunk Add-on for Amazon Web Services (AWS):
- You must manage accounts for the add-on as a prerequisite. See Manage accounts for the Splunk Add-on for AWS.
- Configure AWS services for the Inspector input.
- Configure AWS permissions for the Inspector input.
- Configure Inspector inputs either through Splunk Web or configuration files.
Configure Amazon Inspector Permissions¶
AWS Service | Permissions |
---|---|
Inspector | Describe* List* |
See the following sample inline policy to configure Inspector input permissions:
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"inspector:Describe*",
"inspector:List*"
],
"Resource": "*"
}
]
}
For more information, see https://docs.aws.amazon.com/inspector/v1/userguide/security_iam_service-with-iam.html.
Configure an Inspector Input using Splunk Web¶
To configure inputs using Splunk Web:
- Click Splunk Add-on for AWS in the navigation bar on Splunk Web home.
- Click Create New Input > Inspector.
- Use the following table to complete the fields for the new input in Splunk Web or in the .conf file:
Argument in configuration file | Field in Splunk Web | Description |
---|---|---|
account |
AWS Account | The AWS account or EC2 IAM role the Splunk platform uses to access your Inspector findings. In Splunk Web, select an account from the drop-down list. In aws_inspector_tasks.conf, enter the friendly name of one of the AWS accounts that you configured on the Configuration page or the name of the automatically discovered EC2 IAM role. |
aws_iam_role |
Assume Role | The IAM role to assume, see The IAM role to assume, see Manage AWS IAM Roles for Splunk Add-on for AWS. |
regions |
AWS Region | The AWS region that contains the data. In aws_inspector_tasks.conf, enter region IDs in a comma-separated list. |
sourcetype |
Source type | A source type for the events. Enter a value only if you want to override the default of aws:inspector . Event extraction relies on the default value of source type. If you change the default value, you must update props.conf as well. |
index |
Index | The index name where the Splunk platform puts the Inspector findings. The default is main. |
polling_interval |
Polling interval | The number of seconds to wait before the Splunk platform runs the command again. The default is 300 seconds. |
Configure a Inspector Input using Configuration Files¶
To configure the input using configuration files, create
$SPLUNK_HOME/etc/apps/Splunk_TA_aws/local/aws_inspector_tasks.conf
using the following template:
[<input_name>]
account = <value>
aws_iam_role = <value>
regions = <value>
sourcetype = <value>
polling_interval = <value>
index = <value>
Here is an example stanza of AWS Inspector Input:
[inspector_data]
account = splunkapp2
index = default
polling_interval = 300
regions = ap-south-1
sourcetype = aws:inspector