# identity-provider-signals / okta / t1 "Standard" # # The quick start's five alerts, with named pipeline actors left out, plus an # alert on a session or API token used from somewhere new. Every event is # kept in a log group under your own key, the alert topic uses the same key, # and saved Logs Insights queries cover the first hour of a case. # # detections.tf has the alerts and the silence alarm, and queries.tf the # saved queries. # # The partner event bus keeps EventBridge's own encryption. AWS documents # customer managed keys for event buses without saying whether partner buses # take one, so this template does not set one. data "aws_caller_identity" "current" {} data "aws_partition" "current" {} locals { account = data.aws_caller_identity.current.account_id partition = data.aws_partition.current.partition source = "aws.partner/okta.com/${var.okta_org_name}/${var.stream_name}" log_group = "/aws/events/okta-system-log" tags = merge({ owner = var.owner environment = var.environment data_classification = "confidential" managed_by = "terraform" }, var.extra_tags) } resource "okta_log_stream" "eventbridge" { name = "AWS EventBridge ${var.aws_region}" type = "aws_eventbridge" status = "ACTIVE" settings { account_id = local.account region = var.aws_region event_source_name = var.stream_name } } # Accepting the partner event source. Events Okta sends before this exists # are dropped. resource "aws_cloudwatch_event_bus" "okta" { name = local.source event_source_name = local.source description = "Okta System Log for ${var.okta_org_name}" depends_on = [okta_log_stream.eventbridge] } # --------------------------------------------------------------------------- # One key for the log group and the topic. EventBridge publishes to the # topic, and CloudWatch alarms publish to it too. # --------------------------------------------------------------------------- data "aws_iam_policy_document" "key" { statement { sid = "AccountManagesKeyThroughIAM" actions = ["kms:*"] resources = ["*"] principals { type = "AWS" identifiers = ["arn:${local.partition}:iam::${local.account}:root"] } } statement { sid = "EventBridgeAndAlarmsPublish" actions = ["kms:Decrypt", "kms:GenerateDataKey*"] resources = ["*"] principals { type = "Service" identifiers = ["events.amazonaws.com", "cloudwatch.amazonaws.com"] } } statement { sid = "CloudWatchLogsEncryptsTheArchive" actions = ["kms:Encrypt*", "kms:Decrypt*", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:Describe*"] resources = ["*"] principals { type = "Service" identifiers = ["logs.${var.aws_region}.amazonaws.com"] } condition { test = "ArnLike" variable = "kms:EncryptionContext:aws:logs:arn" values = ["arn:${local.partition}:logs:${var.aws_region}:${local.account}:log-group:${local.log_group}"] } } } resource "aws_kms_key" "okta" { description = "Okta System Log archive and alert topic" enable_key_rotation = true deletion_window_in_days = 30 policy = data.aws_iam_policy_document.key.json } resource "aws_kms_alias" "okta" { name = "alias/okta-signals" target_key_id = aws_kms_key.okta.key_id } # --------------------------------------------------------------------------- # Every event, kept for investigations and for the silence alarm # --------------------------------------------------------------------------- resource "aws_cloudwatch_log_group" "okta" { name = local.log_group retention_in_days = var.log_retention_days kms_key_id = aws_kms_key.okta.arn } data "aws_iam_policy_document" "events_write_logs" { statement { actions = ["logs:CreateLogStream", "logs:PutLogEvents"] resources = ["${aws_cloudwatch_log_group.okta.arn}:*"] principals { type = "Service" identifiers = ["events.amazonaws.com", "delivery.logs.amazonaws.com"] } } } resource "aws_cloudwatch_log_resource_policy" "events_write_logs" { policy_name = "okta-system-log-from-eventbridge" policy_document = data.aws_iam_policy_document.events_write_logs.json } resource "aws_cloudwatch_event_rule" "archive" { name = "okta-archive" description = "Every Okta System Log event, into the log group." event_bus_name = aws_cloudwatch_event_bus.okta.name state = "ENABLED" event_pattern = jsonencode({ source = [local.source] }) } resource "aws_cloudwatch_event_target" "archive" { rule = aws_cloudwatch_event_rule.archive.name event_bus_name = aws_cloudwatch_event_bus.okta.name arn = aws_cloudwatch_log_group.okta.arn depends_on = [aws_cloudwatch_log_resource_policy.events_write_logs] } # --------------------------------------------------------------------------- # Alert topic # --------------------------------------------------------------------------- resource "aws_sns_topic" "alerts" { name = "okta-signals" kms_master_key_id = aws_kms_key.okta.arn } data "aws_iam_policy_document" "publish" { statement { sid = "OktaRulesPublish" actions = ["sns:Publish"] resources = [aws_sns_topic.alerts.arn] principals { type = "Service" identifiers = ["events.amazonaws.com"] } condition { test = "ArnLike" variable = "aws:SourceArn" values = ["arn:${local.partition}:events:${var.aws_region}:${local.account}:rule/${local.source}/okta-*"] } } statement { sid = "AlarmsPublish" actions = ["sns:Publish"] resources = [aws_sns_topic.alerts.arn] principals { type = "Service" identifiers = ["cloudwatch.amazonaws.com"] } condition { test = "StringEquals" variable = "aws:SourceAccount" values = [local.account] } } } resource "aws_sns_topic_policy" "alerts" { arn = aws_sns_topic.alerts.arn policy = data.aws_iam_policy_document.publish.json } resource "aws_sns_topic_subscription" "email" { for_each = toset(var.alert_emails) topic_arn = aws_sns_topic.alerts.arn protocol = "email" endpoint = each.value }