Skip to main content

Amazon Inspector - Classic

Thumbnail icon
Newer version available

You're viewing legacy documentation. For information about our newer app for Amazon Inspector, which leverages findings from AWS Security Hub, see Amazon Inspector.

Amazon Inspector allows you to monitor your AWS resources for potential security risks. The Sumo Logic App for Amazon Inspector provides preconfigured searches and Dashboards that give you instant access to an overview of Amazon Inspector as well as details on assessments, runs, and findings.

The App uses a Lambda function to collect assessment run events (notifications) directly from the Amazon Inspector service, which then retrieves further details via the Inspector API, and finally sends them over to a Sumo Logic HTTP Source endpoint.

For more information on Amazon Inspector notifications, see: Amazon Inspector Classic assessment templates and assessment runs.

Sample Log

Amazon Inspector CreateResourceGroup action
{
"eventVersion": "1.03",
"userIdentity": {
"type": "AssumedRole",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::444455556666:user/Alice",
"accountId": "444455556666",
"accessKeyId": "AKIAI44QH8DHBEXAMPLE",
"sessionContext": {
"attributes": {
"mfaAuthenticated": "false",
"creationDate": "2016-04-14T17:05:54Z"
},
"sessionIssuer": {
"type": "Role",
"principalId": "AIDACKCEVSQ6C2EXAMPLE",
"arn": "arn:aws:iam::444455556666:user/Alice",
"accountId": "444455556666",
"userName": "Alice"
}
}
},
"eventTime": "2016-04-14T17:12:34Z",
"eventSource": "inspector.amazonaws.com",
"eventName": "CreateResourceGroup",
"awsRegion": "us-west-2",
"sourceIPAddress": "205.251.233.179",
"userAgent": "console.amazonaws.com",
"requestParameters": {
"resourceGroupTags": [
{
"key": "Name",
"value": "ExampleEC2Instance"
}
]
},
"responseElements": {
"resourceGroupArn": "arn:aws:inspector:us-west-2:444455556666:resourcegroup/0-oclRMp8B"
},
"requestID": "148256d2-0264-11e6-a9b5-b98a7d3b840f",
"eventID": "e5ea533e-eede-46cc-94f6-0d08e6306ff0",
"eventType": "AwsApiCall",
"apiVersion": "v20160216",
"recipientAccountId": "444455556666"
}

Collecting Data for the Amazon Inspector Classic App

For information about our newer app for Amazon Inspector, which leverages findings from AWS Security Hub, see Amazon Inspector.

This section provides instructions for configuring data collection for the Amazon Inspector App.

Step 1: Configure Collection in Sumo Logic

To collect data for the Amazon Inspector App, do the following:

  1. Configure a Hosted Collector.
  2. Configure an HTTP Source.

Step 2: Configure Amazon Inspector

On Amazon Inspector, perform these tasks under the same AWS region:

  1. Create an Amazon SNS topic to receive assessment template events.
  2. Configure the Amazon Inspector to send findings to the SNS topic.
  3. Create an appropriate role to execute a Lambda function and read Inspector data.
  4. Set up a Lambda function to fetch data and send to the Sumo Logic HTTP Source endpoint.

Details are provided in the following sections.

Step 3: Create an Amazon SNS Topic

  1. Log in to the Amazon Console.
  2. Click Services. In the dropdown go to Application Integration > Simple Notification Service (SNS).
  3. On the SNS Dashboard, select Topics on the left side.
  4. A new window opens, select Create topic button.
  5. In the new window, enter the following details:
    • Name: Enter a topic name.
    • Access Policy: Select Advance.
    • JSON Editor: Replace the existing text with the following.
{
"Version": "2008-10-17",
"Id": "inspector-sns-publish-policy",
"Statement": [
{
"Sid": "inspector-sns-publish-statement",
"Effect": "Allow",
"Principal": {
"Service": "inspector.amazonaws.com"
},
"Action": "SNS:Publish",
"Resource": "arn:aws:sns:*"
}
]
}
  1. Click Create Topic button.

Step 4: Configure Amazon Inspector

  1. In the Amazon Console, click Services. In the opened dropdown, go to Security, Identity & Compliance > Inspector.
  2. Select assessment templates on the left side.
  3. A new window opens, select each assessment template you want to monitor.
  4. Expand each row and find the section called SNS topics.
  5. Click the Edit icon and select the SNS topic you created in the previous section.
  6. Click Save.

Step 5: Create a Role

  1. In the Amazon Console, click Services. In the opened dropdown, go to Security, Identity & Compliance > IAM.
  2. Select Roles on the left side. A new window open, click the Create role button.
  3. Select Lambda and then click Next: Permissions button.
  4. In the Attach permissions policy section, search and select AWSLambdaBasicExecutionRole and AmazonInspectorReadOnlyAccess policies.
  5. Select Next: Tags button.
  6. Select Next: Review button.
  7. In the Review section, Enter the role name Lambda-Inspector and click the Create role button.

Step 6: Create a Lambda Function

  1. In the Amazon Console, click Services. In the opened dropdown, go to Compute > Lambda.
  2. Click Create function button.
  3. In the Author from Scratch section:
    • Function name: Enter function name.
    • Runtime: Select the Python 3.7 runtime.
    • Choose or create an execution role: Select Use an existing role radio button. Select the role created in Step 5.
  4. Click Create function button.
  5. Click the Add trigger button.
    • Select SNS Service.
    • Select the SNS topic you created in create an Amazon SNS Topic as trigger.
  6. Click the Add button.
  7. Click the Function name and go to the Function code section.
  8. Go to https://raw.githubusercontent.com/SumoLogic/sumologic-aws-lambda/main/inspector/python/inspector.py and copy-paste the code in the editor.
  9. Edit the code to enter the URL of the Sumo Logic endpoint ( line 14) that will receive data from the HTTP Source.
  10. Click Save at the top.
  11. Scroll down and go to Edit basic settings and configure the rest of the settings as follows:
    • Handler: lambda_function.sumo_inspector_handler
    • Memory (MB): 128
    • Timeout: 10 minutes
  12. Click Save.

Installing the Amazon Inspector Classic App

Now that you have set up collection for Amazon Inspector, install the Sumo Logic App for Amazon Inspector to use the pre-configured Searches and dashboards that provide visibility into your environment for real-time analysis of overall usage.

To install the app:

  1. From the Sumo Logic navigation, select App Catalog.
  2. In the Search Apps field, search for and then select your app.
  3. Optionally, you can scroll down to preview the dashboards included with the app. Then, click Install App (sometimes this button says Add Integration).
    note

    If your app has multiple versions, you'll need to select the version of the service you're using before installation.

  4. On the next configuration page, under Select Data Source for your App, complete the following fields:
    • Data Source. Select one of the following options:
      • Choose Source Category and select a source category from the list; or
      • Choose Enter a Custom Data Filter, and enter a custom source category beginning with an underscore. For example, _sourceCategory=MyCategory.
    • Folder Name. You can retain the existing name or enter a custom name of your choice for the app.
    • All Folders (optional). Default location is the Personal folder in your Library. If desired, you can choose a different location and/or click New Folder to add it to a new folder.
  5. Click Next.
  6. Look for the dialog confirming that your app was installed successfully.
    app-success.png

Once an app is installed, it will appear in your Personal folder or the folder that you specified. From here, you can share it with other users in your organization. Dashboard panels will automatically start to fill with data matching the time range query received since you created the panel. Results won't be available immediately, but within about 20 minutes, you'll see completed graphs and maps.

Viewing Inspector Classic Dashboards

Overview

amazon_inspector_app_overview

Events by Template. Displays events by template in a stacked bar chart for the last seven days.

Top 5 Findings. Displays the top 5 findings in a bar chart for the last seven days.

Finding Severity by InstanceID. Shows the finding severity by InstanceID in a stacked bar chart for the last seven days.

Top 5 Rules Packages by Findings. Provides details on the top 5 Rules Packages by findings in a bar chart for the last seven days.

Finding Severity by Template. Displays the severity of findings by template in a bar chart for the last seven days.

Trend of Findings by RulesPackage. Shows the trend of findings by RulesPackage in a trend line chart on a timeline for the last seven days.

Last Run by Template. Shows the last run by template in a table chart, including details on the template, lastrun, lastevent, and timestamp for the last seven days.

Trend of Findings by Template. Shows the trend of findings by template in a trend line chart on a timeline for the last seven days.

Findings

amazon_inspector_findings

Finding Severity Over Time. Shows the finding severity over time in a stacked column chart on a timeline for the last seven days.

Outlier Indicator of Non-Information Findings. Displays the indicator of non-informational findings in an outlier chart for the last seven days.

Templates Not Run in a Day. Provides information on templates that have not been run in a day in a table chart, including details on the template, last event, and last event date for the last seven days.

Finding Details. Displays complete finding details in a table chart, including information on the finding title, description, create date, template, run, and finding severity for the last seven days.

Finding Severity by Template and Run. Shows the details of finding severity by template and run in a table chart including information on the template, run, create date, and medium or informational severity for the last seven days.

Persistent Findings. Displays persistent findings in a table chart, including details on the finding title, template, finding severity, and number of runs for the last seven days.

Status
Legal
Privacy Statement
Terms of Use

Copyright © 2024 by Sumo Logic, Inc.