# brokered-shell-access / aws / t1 "Standard" # # Session Manager with the session itself encrypted under your own key, # transcripts encrypted and kept for a set period, time limits, an operator # policy that only reaches tagged instances, and port forwarding left out # because its traffic cannot be recorded. data "aws_caller_identity" "current" {} data "aws_region" "current" {} data "aws_partition" "current" {} locals { tags = merge({ owner = var.owner environment = var.environment data_classification = "confidential" managed_by = "terraform" }, var.extra_tags) account = data.aws_caller_identity.current.account_id region = data.aws_region.current.region partition = data.aws_partition.current.partition group = "/ssm/sessions/${var.name}" } 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 = "CloudWatchLogsEncryptsTranscripts" actions = ["kms:Encrypt*", "kms:Decrypt*", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:Describe*"] resources = ["*"] principals { type = "Service" identifiers = ["logs.${local.region}.amazonaws.com"] } condition { test = "ArnLike" variable = "kms:EncryptionContext:aws:logs:arn" values = ["arn:${local.partition}:logs:${local.region}:${local.account}:log-group:${local.group}"] } } } resource "aws_kms_key" "sessions" { description = "Session Manager sessions and transcripts for ${var.name}" enable_key_rotation = true deletion_window_in_days = 30 policy = data.aws_iam_policy_document.key.json } resource "aws_s3_bucket" "sessions" { bucket_prefix = "${var.name}-transcripts-" } resource "aws_s3_bucket_public_access_block" "sessions" { bucket = aws_s3_bucket.sessions.id block_public_acls = true block_public_policy = true ignore_public_acls = true restrict_public_buckets = true } resource "aws_s3_bucket_versioning" "sessions" { bucket = aws_s3_bucket.sessions.id versioning_configuration { status = "Enabled" } } resource "aws_s3_bucket_server_side_encryption_configuration" "sessions" { bucket = aws_s3_bucket.sessions.id rule { apply_server_side_encryption_by_default { sse_algorithm = "aws:kms" kms_master_key_id = aws_kms_key.sessions.arn } bucket_key_enabled = true } } resource "aws_s3_bucket_lifecycle_configuration" "sessions" { bucket = aws_s3_bucket.sessions.id rule { id = "retention" status = "Enabled" filter {} expiration { days = var.retention_days } noncurrent_version_expiration { noncurrent_days = 30 } abort_incomplete_multipart_upload { days_after_initiation = 1 } } } resource "aws_cloudwatch_log_group" "sessions" { name = local.group retention_in_days = var.retention_days kms_key_id = aws_kms_key.sessions.arn } resource "aws_ssm_document" "preferences" { name = "SSM-SessionManagerRunShell" document_type = "Session" document_format = "JSON" content = jsonencode({ schemaVersion = "1.0" description = "Encrypted, recorded, time-limited sessions." sessionType = "Standard_Stream" inputs = { s3BucketName = aws_s3_bucket.sessions.bucket s3KeyPrefix = "sessions/" s3EncryptionEnabled = true cloudWatchLogGroupName = aws_cloudwatch_log_group.sessions.name cloudWatchEncryptionEnabled = true cloudWatchStreamingEnabled = true kmsKeyId = aws_kms_key.sessions.key_id idleSessionTimeout = tostring(var.idle_timeout_minutes) maxSessionDuration = tostring(var.max_session_minutes) runAsEnabled = false } }) } data "aws_iam_policy_document" "ec2_trust" { statement { actions = ["sts:AssumeRole"] principals { type = "Service" identifiers = ["ec2.amazonaws.com"] } } } resource "aws_iam_role" "instance" { name = "${var.name}-instance" assume_role_policy = data.aws_iam_policy_document.ec2_trust.json } resource "aws_iam_role_policy_attachment" "core" { role = aws_iam_role.instance.name policy_arn = "arn:${local.partition}:iam::aws:policy/AmazonSSMManagedInstanceCore" } resource "aws_iam_role_policy" "transcripts" { name = "write-session-transcripts" role = aws_iam_role.instance.id policy = jsonencode({ Version = "2012-10-17" Statement = [ { Effect = "Allow", Action = ["s3:PutObject"], Resource = "${aws_s3_bucket.sessions.arn}/sessions/*" }, { Effect = "Allow", Action = ["s3:GetEncryptionConfiguration"], Resource = aws_s3_bucket.sessions.arn }, { Effect = "Allow", Action = ["logs:CreateLogStream", "logs:PutLogEvents", "logs:DescribeLogStreams"], Resource = "${aws_cloudwatch_log_group.sessions.arn}:*" }, { Effect = "Allow", Action = ["logs:DescribeLogGroups"], Resource = "*" }, { Effect = "Allow", Action = ["kms:Decrypt", "kms:GenerateDataKey"], Resource = aws_kms_key.sessions.arn }, ] }) } resource "aws_iam_instance_profile" "instance" { name = "${var.name}-instance" role = aws_iam_role.instance.name } resource "aws_security_group" "no_inbound" { name_prefix = "${var.name}-no-inbound-" description = "No inbound rules. Shell access goes through Session Manager." vpc_id = var.vpc_id egress { description = "HTTPS out, for the Systems Manager agent" from_port = 443 to_port = 443 protocol = "tcp" cidr_blocks = ["0.0.0.0/0"] } } # Attach this to the people allowed in. They reach tagged instances only, # through the recorded shell document only, and can end only their own # sessions. Port forwarding documents are not listed, because what passes # through a forwarded port is never recorded. data "aws_iam_policy_document" "operator" { statement { sid = "StartRecordedShellOnTaggedInstances" actions = ["ssm:StartSession"] resources = [ "arn:${local.partition}:ec2:${local.region}:${local.account}:instance/*", ] condition { test = "StringEquals" variable = "ssm:resourceTag/${var.access_tag.key}" values = [var.access_tag.value] } } statement { sid = "UseOnlyTheRecordedShellDocument" actions = ["ssm:StartSession"] resources = [aws_ssm_document.preferences.arn] } statement { sid = "EndOwnSessions" actions = ["ssm:TerminateSession", "ssm:ResumeSession"] resources = ["arn:${local.partition}:ssm:*:*:session/$${aws:userid}-*"] } statement { sid = "UseTheSessionKey" actions = ["kms:GenerateDataKey"] resources = [aws_kms_key.sessions.arn] } } resource "aws_iam_policy" "operator" { name = "${var.name}-operator" description = "Recorded shell sessions on instances tagged ${var.access_tag.key}=${var.access_tag.value}." policy = data.aws_iam_policy_document.operator.json }