Terraform과 AWS Secrets Manager로 구현한 보안 인프라 자동화

Context

EC2 인스턴스 배포 시 .env 파일 기반의 환경 변수 관리 방식 사용. 민감 정보 노출 위험과 수동 설정으로 인한 관리 효율성 저하 문제 발생.

Technical Solution

• AWS Secrets Manager를 도입하여 API 키와 DB 자격 증명 등 민감 정보를 중앙 집중식으로 관리하는 구조
• Terraform을 이용해 EC2, IAM Role, Security Group을 코드로 정의하고 배포하는 IaC 파이프라인 구축
• AWS SDK를 Node.js 애플리케이션에 통합하여 런타임에 필요한 시크릿 정보를 동적으로 호출하는 로직 구현
• IAM Instance Profile을 통해 EC2 인스턴스에 Secrets Manager 접근 권한을 부여하는 최소 권한 원칙 적용
• Terraform 설정 파일을 data, output, provider, resource 등으로 분리하여 모듈화와 유지보수성을 높인 파일 구조 설계
• userdata.sh 스크립트를 활용해 인스턴스 생성 시 애플리케이션 설치 및 실행 과정을 자동화한 프로비저닝 방식

Key Takeaway

애플리케이션 코드와 인프라 설정을 완전히 분리하고 외부 시크릿 관리 서비스를 결합하여 보안성과 배포 재현성을 동시에 확보하는 설계 전략.