# evidence-capture / gcp / t1 "Standard" # # The quick start's responder, with: a record of each VM and its hash saved to # a retention-locked bucket before anything changes, one responder per region, # a custom role with only the permissions it uses, quarantine rules on # every network, and each step published to a status topic. resource "google_project_service" "needed" { for_each = toset([ "cloudfunctions.googleapis.com", "run.googleapis.com", "eventarc.googleapis.com", "cloudbuild.googleapis.com", "artifactregistry.googleapis.com", "pubsub.googleapis.com", "compute.googleapis.com", "storage.googleapis.com", ]) project = var.project_id service = each.value disable_on_destroy = false } # Deny-all, in and out, at the highest priority, on every network. resource "google_compute_firewall" "quarantine_in" { for_each = toset(var.networks) project = var.project_id name = "incident-quarantine-deny-in-${each.value}" network = each.value direction = "INGRESS" priority = 0 target_tags = ["incident-quarantine"] source_ranges = ["0.0.0.0/0"] deny { protocol = "all" } log_config { metadata = "INCLUDE_ALL_METADATA" } } resource "google_compute_firewall" "quarantine_out" { for_each = toset(var.networks) project = var.project_id name = "incident-quarantine-deny-out-${each.value}" network = each.value direction = "EGRESS" priority = 0 target_tags = ["incident-quarantine"] destination_ranges = ["0.0.0.0/0"] deny { protocol = "all" } # Every attempt the isolated VM makes to reach out is recorded: a lead on # where it was talking. log_config { metadata = "INCLUDE_ALL_METADATA" } } resource "random_id" "suffix" { byte_length = 4 } # Evidence: the VM's record and its hash, protected for the retention period. resource "google_storage_bucket" "evidence" { project = var.project_id name = "incident-evidence-${random_id.suffix.hex}" location = var.evidence_location uniform_bucket_level_access = true public_access_prevention = "enforced" force_destroy = false versioning { enabled = true } retention_policy { retention_period = var.evidence_retention_days * 86400 is_locked = var.lock_retention } } resource "google_pubsub_topic" "status" { project = var.project_id name = "incident-responder-status" depends_on = [google_project_service.needed] } # Only what the function calls. The predefined compute roles grant hundreds # of permissions, including deleting the VM it exists to keep. resource "google_project_iam_custom_role" "responder" { project = var.project_id role_id = "incidentEvidenceResponder" title = "Incident evidence responder" description = "Protects, detaches, snapshots, tags, and labels a VM under investigation. Cannot delete or stop anything." permissions = [ "compute.instances.get", "compute.instances.setDeletionProtection", "compute.instances.setTags", "compute.instances.setLabels", "compute.instanceGroupManagers.get", "compute.instanceGroupManagers.update", "compute.disks.get", "compute.disks.createSnapshot", "compute.snapshots.create", "compute.snapshots.get", "compute.snapshots.setLabels", "compute.zoneOperations.get", "compute.regionOperations.get", "compute.globalOperations.get", ] } resource "google_service_account" "responder" { project = var.project_id account_id = "incident-responder" display_name = "Preserves and isolates VMs labelled incident=" } resource "google_project_iam_member" "responder" { for_each = toset([ google_project_iam_custom_role.responder.name, "roles/eventarc.eventReceiver", "roles/run.invoker", ]) project = var.project_id role = each.value member = "serviceAccount:${google_service_account.responder.email}" } # Write, never read or delete: the responder adds evidence and nothing else. resource "google_storage_bucket_iam_member" "responder_writes" { bucket = google_storage_bucket.evidence.name role = "roles/storage.objectCreator" member = "serviceAccount:${google_service_account.responder.email}" } resource "google_pubsub_topic_iam_member" "responder_publishes" { project = var.project_id topic = google_pubsub_topic.status.id role = "roles/pubsub.publisher" member = "serviceAccount:${google_service_account.responder.email}" } data "archive_file" "function" { type = "zip" source_dir = "${path.module}/function" output_path = "${path.module}/.build/function.zip" } resource "google_storage_bucket" "source" { project = var.project_id name = "incident-responder-src-${random_id.suffix.hex}" location = var.evidence_location uniform_bucket_level_access = true public_access_prevention = "enforced" force_destroy = true } resource "google_storage_bucket_object" "function" { name = "function-${data.archive_file.function.output_md5}.zip" bucket = google_storage_bucket.source.name source = data.archive_file.function.output_path } resource "google_cloudfunctions2_function" "responder" { for_each = toset(var.regions) project = var.project_id name = "incident-responder-${each.value}" location = each.value build_config { runtime = "python312" entry_point = "handler" source { storage_source { bucket = google_storage_bucket.source.name object = google_storage_bucket_object.function.name } } } service_config { max_instance_count = 5 timeout_seconds = 540 available_memory = "512M" ingress_settings = "ALLOW_INTERNAL_ONLY" service_account_email = google_service_account.responder.email environment_variables = { EVIDENCE_BUCKET = google_storage_bucket.evidence.name STATUS_TOPIC = google_pubsub_topic.status.id } } event_trigger { trigger_region = each.value event_type = "google.cloud.audit.log.v1.written" # No retries: a retry would snapshot again under a new name. A run that # stops early shows as a missing "done" message on the status topic. retry_policy = "RETRY_POLICY_DO_NOT_RETRY" service_account_email = google_service_account.responder.email event_filters { attribute = "serviceName" value = "compute.googleapis.com" } event_filters { attribute = "methodName" value = "v1.compute.instances.setLabels" } } depends_on = [google_project_service.needed, google_project_iam_member.responder] } # So the incident channel, or you, can read progress. resource "google_pubsub_subscription" "status" { project = var.project_id name = "incident-responder-status" topic = google_pubsub_topic.status.id expiration_policy { ttl = "" } }