data "archive_file" "responder" { type = "zip" source_file = "${path.module}/responder.py" output_path = "${path.module}/.build/responder.zip" } data "aws_iam_policy_document" "assume" { statement { actions = ["sts:AssumeRole"] principals { type = "Service" identifiers = ["lambda.amazonaws.com"] } } } resource "aws_iam_role" "responder" { name = "${var.name}-responder" assume_role_policy = data.aws_iam_policy_document.assume.json } # The responder can record, protect, snapshot, capture, and isolate. It cannot # delete, stop, or terminate anything, and it can only run the one document. data "aws_iam_policy_document" "responder" { statement { sid = "PreserveAndIsolate" actions = [ "ec2:DescribeInstances", "ec2:DescribeSecurityGroups", "ec2:ModifyInstanceAttribute", "ec2:CreateSnapshots", "ec2:CreateTags", "ec2:CreateSecurityGroup", "ec2:RevokeSecurityGroupEgress", "ec2:ModifyNetworkInterfaceAttribute", "autoscaling:DescribeAutoScalingInstances", "autoscaling:DetachInstances", "ssm:DescribeInstanceInformation", ] resources = ["*"] } statement { sid = "RunOnlyTheCaptureDocument" actions = ["ssm:SendCommand"] resources = [aws_ssm_document.memory.arn, "arn:${data.aws_partition.current.partition}:ec2:*:${local.account}:instance/*"] } statement { sid = "WriteManifests" actions = ["s3:PutObject"] resources = ["${aws_s3_bucket.evidence.arn}/incidents/*"] } statement { sid = "UseEvidenceKey" actions = ["kms:GenerateDataKey", "kms:Decrypt"] resources = [aws_kms_key.evidence.arn] } statement { sid = "KeepFailedEvents" actions = ["sqs:SendMessage"] resources = [aws_sqs_queue.failed.arn] } statement { sid = "ReportStatus" actions = ["sns:Publish"] resources = [aws_sns_topic.status.arn] } statement { sid = "OwnLogs" actions = ["logs:CreateLogStream", "logs:PutLogEvents"] resources = ["${aws_cloudwatch_log_group.responder.arn}:*"] } } resource "aws_iam_role_policy" "responder" { name = "preserve-and-isolate" role = aws_iam_role.responder.id policy = data.aws_iam_policy_document.responder.json } resource "aws_cloudwatch_log_group" "responder" { name = "/aws/lambda/${var.name}-responder" retention_in_days = 365 kms_key_id = aws_kms_key.evidence.arn } resource "aws_lambda_function" "responder" { function_name = "${var.name}-responder" role = aws_iam_role.responder.arn runtime = "python3.13" handler = "responder.handler" filename = data.archive_file.responder.output_path source_code_hash = data.archive_file.responder.output_base64sha256 timeout = 300 kms_key_arn = aws_kms_key.evidence.arn depends_on = [aws_cloudwatch_log_group.responder] # If the responder fails, the triggering event lands here. In an incident, a # containment request that vanished silently is worse than one that failed # loudly. dead_letter_config { target_arn = aws_sqs_queue.failed.arn } environment { variables = { EVIDENCE_BUCKET = aws_s3_bucket.evidence.id MEMORY_DOCUMENT = aws_ssm_document.memory.name TOOL_KEY = var.avml_key STATUS_TOPIC = aws_sns_topic.status.arn } } } # Trigger one: the incident tag is added to an instance. resource "aws_cloudwatch_event_rule" "incident_tag" { name = "${var.name}-incident-tag" description = "An EC2 instance was tagged incident=." event_pattern = jsonencode({ source = ["aws.tag"] "detail-type" = ["Tag Change on Resource"] detail = { service = ["ec2"] "resource-type" = ["instance"] "changed-tag-keys" = ["incident"] } }) } # Trigger two: memory capture has finished, whether it worked or not. resource "aws_cloudwatch_event_rule" "capture_done" { name = "${var.name}-capture-done" description = "The memory capture command reached a final state." event_pattern = jsonencode({ source = ["aws.ssm"] "detail-type" = ["EC2 Command Invocation Status-change Notification"] detail = { "document-name" = [aws_ssm_document.memory.name] status = [{ "anything-but" = ["Pending", "InProgress", "Delayed"] }] } }) } resource "aws_cloudwatch_event_target" "incident_tag" { rule = aws_cloudwatch_event_rule.incident_tag.name arn = aws_lambda_function.responder.arn } resource "aws_cloudwatch_event_target" "capture_done" { rule = aws_cloudwatch_event_rule.capture_done.name arn = aws_lambda_function.responder.arn } resource "aws_lambda_permission" "incident_tag" { statement_id = "AllowIncidentTag" action = "lambda:InvokeFunction" function_name = aws_lambda_function.responder.function_name principal = "events.amazonaws.com" source_arn = aws_cloudwatch_event_rule.incident_tag.arn } resource "aws_lambda_permission" "capture_done" { statement_id = "AllowCaptureDone" action = "lambda:InvokeFunction" function_name = aws_lambda_function.responder.function_name principal = "events.amazonaws.com" source_arn = aws_cloudwatch_event_rule.capture_done.arn } resource "aws_sqs_queue" "failed" { name = "${var.name}-failed" kms_master_key_id = aws_kms_key.evidence.id message_retention_seconds = 1209600 # 14 days, the most SQS allows }