EC2 Instance Stack | Gather Log4j Information

To check the change type version, use this command:

aws amscm list-change-type-version-summaries --filter Attribute=ChangeTypeId,Value=CT_ID

INLINE CREATE:

Issue the create RFC command with execution parameters provided inline (escape quotation marks when providing execution parameters inline), and then submit the returned RFC ID. For example, you can replace the contents with something like this:

Version 2.0:

Scan all instances:

aws amscm create-rfc --change-type-id "ct-19f40lfm5umy8" --change-type-version "2.0" --title "Log4j Investigation" --execution-parameters "{\"DocumentName\":\"AWSManagedServices-GatherLog4jInformation\",\"Region\":\"us-east-1\",\"Parameters\":{\"S3Bucket\":[\"s3://BUCKET_NAME\"]},\"TargetParameterName\": \"InstanceId\",\"Targets\": [{\"Key\": \"AWS::EC2::Instance\",\"Values\": [\"*\"]}],\"MaxConcurrency\": \"10\",\"MaxErrors\": \"100%\"}"

Scan a list of instances:

aws amscm create-rfc --change-type-id "ct-19f40lfm5umy8" --change-type-version "2.0" --title "Log4j Investigation" --execution-parameters "{\"DocumentName\":\"AWSManagedServices-GatherLog4jInformation\",\"Region\":\"us-east-1\",\"Parameters\":{\"S3Bucket\":[\"s3://BUCKET_NAME\"]},\"TargetParameterName\": \"InstanceId\",\"Targets\": [{\"Key\": \"ParameterValues\",\"Values\": [\"INSTANCE_ID_1\",\"INSTANCE_ID_2\",\"INSTANCE_ID_3\",\"INSTANCE_ID_4\",\"INSTANCE_ID_5\"]}],\"MaxConcurrency\": \"10\",\"MaxErrors\": \"100%\"}"

TEMPLATE CREATE:

1. Output the execution parameters for this change type to a JSON file; this example names it GatherLog4jInfoParams.json:

   aws amscm get-change-type-version --change-type-id "ct-19f40lfm5umy8" --query "ChangeTypeVersion.ExecutionInputSchema" --output text > GatherLog4jInfoParams.json

2. Modify and save the GatherLog4jInfoParams file, retaining only the parameters that you want to change. For example, you can replace the contents with something like this:

   Version 2.0:

   Scan all instances:

   {
     "DocumentName": "AWSManagedServices-GatherLog4jInformation",
     "Region": "us-east-1",
     "Parameters": {
       "S3Bucket": [
         "s3://BUCKET_NAME"
       ]
     },
     "TargetParameterName": "InstanceId",
     "Targets": [
       {
         "Key": "AWS::EC2::Instance",
         "Values": [
           "*"
         ]
       }
     ],
     "MaxConcurrency": "10",
     "MaxErrors": "100%"
   }

   Scan a list of instances:

   {
     "DocumentName": "AWSManagedServices-GatherLog4jInformation",
     "Region": "us-east-1",
     "Parameters": {
       "S3Bucket": [
         "s3://BUCKET_NAME"
       ]
     },
     "TargetParameterName": "InstanceId",
     "Targets": [
       {
         "Key": "ParameterValues",
         "Values": [
           "INSTANCE_ID_1",
           "INSTANCE_ID_2",
           "INSTANCE_ID_3",
           "INSTANCE_ID_4",
           "INSTANCE_ID_5"
         ]
       }
     ],
     "MaxConcurrency": "10",
     "MaxErrors": "100%"
   }

3. Output the RFC template to a file in your current folder; this example names it GatherLog4jInfoRfc.json:

   aws amscm create-rfc --generate-cli-skeleton > GatherLog4jInfoRfc.json

4. Modify and save the GatherLog4jInfoRfc.json file. For example, you can replace the contents with something like this:

   {
   "ChangeTypeVersion":    "2.0",
   "ChangeTypeId":         "ct-19f40lfm5umy8",
   "Title":                "Log4j Investigation"
   }

5. Create the RFC, specifying the GatherLog4jInfoRfc file and the GatherLog4jInfoParams file:

   aws amscm create-rfc --cli-input-json file://GatherLog4jInfoRfc.json  --execution-parameters file://GatherLog4jInfoParams.json

1. From any page or AWS Region in the AWS Management Console, open the AWS CloudShell to run the script shown next. Ensure that you are logged into the AWS Management Console with the AWSManagedServicesReadOnlyRole role.

   # Specify the S3 bucket and AWS region that contains the individual CSV files:
   BUCKET_NAME="YOUR BUCKET HERE"
   BUCKET_REGION="THE BUCKET REGION HERE"
   
   # Aggregate the CSV files:
   mkdir -p log4j-report
   aws s3 cp s3://$BUCKET_NAME/ams/log4j-scan/ ./log4j-report --recursive --include "*.csv"
   echo "aws_account_id,region,scan_time,instance_id,scan_type,location" > log4j-report/report.csv
   for i in `find log4j-report -type f \( -iname "*.csv" ! -iname "report.csv" \)`; do awk 'FNR > 1' $i >> log4j-report/report.csv; done
   
   # Upload the report to the same S3 bucket:
   file_name="report_$(date -d "today" +"%Y%m%d%H%M").csv"
   aws s3 cp log4j-report/report.csv s3://$BUCKET_NAME/ams/log4j-reports/$file_name
   
   # Open the following URL and select \"Download\" to download the report:
   echo "Report uploaded to: https://s3.console.aws.amazon.com/s3/object/$BUCKET_NAME?region=$BUCKET_REGION&prefix=ams/log4j-reports/$file_name"

   The script outputs the S3 URL to download the report from.

2. Copy and open the URL and then choose Download