# forensic-workstation / gcp / t1 "Standard" # # The quick start's isolated network, plus: DNS that answers only Google API # names, every query logged, alerts when anything on the workstation reaches # out or looks up another name, and admin rights limited to this workstation. locals { region = join("-", slice(split("-", var.zone), 0, 2)) restricted = "199.36.153.4/30" } resource "google_project_service" "needed" { for_each = toset(["compute.googleapis.com", "iap.googleapis.com", "dns.googleapis.com", "logging.googleapis.com", "monitoring.googleapis.com"]) project = var.project_id service = each.value disable_on_destroy = false } resource "google_compute_network" "forensics" { project = var.project_id name = "forensics-isolated" auto_create_subnetworks = false delete_default_routes_on_create = true depends_on = [google_project_service.needed] } resource "google_compute_subnetwork" "forensics" { project = var.project_id name = "forensics-isolated" network = google_compute_network.forensics.id region = local.region ip_cidr_range = var.cidr private_ip_google_access = true log_config { aggregation_interval = "INTERVAL_5_SEC" flow_sampling = 1.0 metadata = "INCLUDE_ALL_METADATA" } } resource "google_compute_route" "restricted_apis" { project = var.project_id name = "forensics-restricted-apis" network = google_compute_network.forensics.id dest_range = local.restricted next_hop_gateway = "default-internet-gateway" } resource "google_dns_managed_zone" "googleapis" { project = var.project_id name = "forensics-googleapis" dns_name = "googleapis.com." visibility = "private" description = "Google APIs through restricted.googleapis.com only" private_visibility_config { networks { network_url = google_compute_network.forensics.id } } } resource "google_dns_record_set" "restricted" { project = var.project_id managed_zone = google_dns_managed_zone.googleapis.name name = "restricted.googleapis.com." type = "A" ttl = 300 rrdatas = ["199.36.153.4", "199.36.153.5", "199.36.153.6", "199.36.153.7"] } resource "google_dns_record_set" "all_apis" { project = var.project_id managed_zone = google_dns_managed_zone.googleapis.name name = "*.googleapis.com." type = "CNAME" ttl = 300 rrdatas = ["restricted.googleapis.com."] } # DNS: firewall rules do not cover lookups, which go to the metadata server. # Cloud DNS answers private zones first, then sends every other name to the # alternative name server. That address is reserved and nothing answers on # it, so every name outside Google's APIs fails, and every query is logged. resource "google_compute_address" "dns_sink" { project = var.project_id name = "forensics-dns-sink" region = local.region subnetwork = google_compute_subnetwork.forensics.id address_type = "INTERNAL" description = "Reserved so nothing can answer here. Every lookup outside Google APIs is sent to it and fails." } resource "google_dns_policy" "forensics" { project = var.project_id name = "forensics-dns" enable_logging = true alternative_name_server_config { target_name_servers { ipv4_address = google_compute_address.dns_sink.address forwarding_path = "private" } } networks { network_url = google_compute_network.forensics.id } } resource "google_compute_firewall" "allow_apis" { project = var.project_id name = "forensics-allow-restricted-apis" network = google_compute_network.forensics.id direction = "EGRESS" priority = 1000 destination_ranges = [local.restricted] allow { protocol = "tcp" ports = ["443"] } } resource "google_compute_firewall" "deny_out" { project = var.project_id name = "forensics-deny-all-egress" network = google_compute_network.forensics.id direction = "EGRESS" priority = 65000 destination_ranges = ["0.0.0.0/0"] deny { protocol = "all" } log_config { metadata = "INCLUDE_ALL_METADATA" } } resource "google_compute_firewall" "iap_ssh" { project = var.project_id name = "forensics-allow-iap-ssh" network = google_compute_network.forensics.id direction = "INGRESS" priority = 1000 source_ranges = ["35.235.240.0/20"] target_tags = ["forensic-workstation"] allow { protocol = "tcp" ports = ["22"] } } locals { signals = { refused-connection = { filter = "logName:\"compute.googleapis.com%2Ffirewall\" AND jsonPayload.disposition=\"DENIED\" AND jsonPayload.rule_details.reference:\"forensics-deny-all-egress\"" doc = "Something on the forensic workstation tried to connect somewhere it may not. The firewall log names the destination; a sample may be calling home." } # The regular expression is anchored, so googleapis.com.attacker.example. still # alerts. Cloud Logging matches RE2 and does not anchor by default: # https://cloud.google.com/logging/docs/view/logging-query-language outside-lookup = { filter = "resource.type=\"dns_query\" AND jsonPayload.queryName!~\"(^|[.])googleapis[.]com[.]$\"" doc = "Something on the forensic workstation looked up a name outside Google's APIs. The DNS query log names it." } } } resource "google_logging_metric" "signal" { for_each = local.signals project = var.project_id name = "forensics-${each.key}" filter = each.value.filter metric_descriptor { metric_kind = "DELTA" value_type = "INT64" } depends_on = [google_project_service.needed] } resource "google_monitoring_notification_channel" "email" { for_each = toset(var.alert_emails) project = var.project_id display_name = "Forensic workstation: ${each.value}" type = "email" labels = { email_address = each.value } } resource "google_monitoring_alert_policy" "signal" { for_each = local.signals project = var.project_id display_name = "Forensic workstation: ${each.key}" combiner = "OR" notification_channels = [for c in google_monitoring_notification_channel.email : c.id] conditions { display_name = each.key condition_threshold { filter = "metric.type=\"logging.googleapis.com/user/${google_logging_metric.signal[each.key].name}\"" comparison = "COMPARISON_GT" threshold_value = 0 duration = "0s" aggregations { alignment_period = "300s" per_series_aligner = "ALIGN_SUM" cross_series_reducer = "REDUCE_SUM" } } } documentation { content = "${each.value.doc} In Logs Explorer: ${each.value.filter}" } }