콘텐츠로 이동

Identity

identity/는 팀원 IAM User와 그룹 소속, 자격증명 기본 정책을 관리한다. state key는 identity/terraform.tfstate다.

관리하는 것 다른 절차로 관리하는 것
IAM User 생성·삭제, 권한 경계와 태그 콘솔 로그인 프로필과 초기 비밀번호
선언한 그룹 생성과 정책 연결 장기 액세스 키 발급
사용자별 그룹 소속 bootstrap의 CI 역할과 platform의 서비스 역할
셀프 서비스 자격증명·MFA 강제 정책 기존 외부 그룹의 생성과 정책

명단과 정책 모델

members.yaml의 키가 사용자 이름이다. groups와 tags만 허용하며 사용자 이름은 영숫자·점·밑줄·하이픈, 최대 64자로 검증한다.

hong:
  groups: [KintounReadOnly]
  tags:
    Owner: hong@example.com

groups.yaml에 선언한 그룹은 이 루트가 만들고 policy_arns를 연결한다. 명단에서 참조하지만 선언하지 않은 그룹은 AWS에서 조회하므로 미리 존재해야 한다.

KintounReadOnly:
  policy_arns:
    - arn:aws:iam::aws:policy/ReadOnlyAccess

그룹으로 업무 권한을 부여하고 사용자에게는 자격증명 기본 정책을 직접 연결한다. 사용자 그룹 소속은 aws_iam_user_group_membership으로 관리하므로, 코드 밖에서 추가한 그룹 연결까지 모두 정리한다고 가정하지 않는다. 권한 회수 때는 실제 소속을 확인한다.

SSM 접속 정책

ssm_access.tf는 인스턴스 태그로 SSM 접속 대상을 고르는 정책을 만든다. 새 인스턴스는 태그만 붙이면 되고 정책과 groups.yaml은 바꾸지 않는다.

정책 대상 인스턴스 세션 문서
kintoun-secops-infra-ssm-port-forwarding SSMPortForward = "true" AWS-StartPortForwardingSession
kintoun-secops-infra-ssm-shell-attack SSMShell = "attack" SSM-SessionManagerRunShell
kintoun-secops-infra-ssm-shell-siem SSMShell = "siem" SSM-SessionManagerRunShell

kintoun-secops-infra-ssm-tag-guard는 members.yaml의 모든 사용자에게 직접 연결되며 두 태그 키의 ec2:CreateTags와 ec2:DeleteTags를 거부한다. 태그는 Terraform 배포 롤만 바꿀 수 있다. 접속 대상 조회와 새 인스턴스 추가 절차는 SSM 접속 권한에 있다.

주요 입력과 출력

입력 기본값과 영향
project_name kintoun-secops-infra. 태그·정책 이름에 사용
permissions_boundary_arn 모든 사용자의 권한 상한
iam_path /. 변경 시 자원별 plan과 실제 ARN을 확인
enforce_mfa true. MFA 미인증 세션에 등록·비밀번호 변경 등 예외 외 동작 거부
force_destroy_users false. 로그인 프로필·키·MFA가 남은 사용자는 삭제가 실패한다. 명단 실수로 계정이 지워지는 것을 막기 위함

출력은 member_arns, member_groups, managed_group_arns, self_service_policy_arn, require_mfa_policy_arn이다. member_groups는 명단에 선언한 소속을 보여 주며 외부에서 추가한 전체 소속을 조회한 값은 아니다. MFA 강제를 끄면 require_mfa_policy_arn은 null이다.

운영 절차