AWS 액세스 키 교체: CI 중단 없이 사용처를 옮기고 폐기하는 절차
AI Editter
액세스 키를 바꾼 직후 배포는 성공했는데 월요일 배치가 실패할 수 있습니다. 새 키를 저장한 위치보다 구 키를 계속 쓰는 위치를 얼마나 찾았는지가 교체의 성패를 좌우합니다.
이 글은 사용처가 알려진 IAM 사용자 액세스 키의 계획된 교체를 다룹니다. 유출이 의심되는 키는 가동 유지보다 신속한 비활성화와 사고 대응이 우선일 수 있으므로, 평상시의 전환 대기 절차를 그대로 적용하지 않습니다.
키를 만들기 전에 사용처 표를 채운다
| 사용처 | 자격 증명 위치 | 실행 주기 | 검증 |
|---|---|---|---|
| CI 배포 | 저장소·환경의 비밀 저장소 | 배포 시 | 시험 배포 |
| 예약 배치 | 승인된 비밀 저장소·환경 설정 | 일·주·월 | 해당 작업 실행 |
| EC2 앱 | 환경·파일·프로파일 등 | 상시 | 앱 요청 |
| 개발자 도구 | 로컬 프로파일 | 비정기 | 계정·권한 확인 |
액세스 키 ID를 기준으로 사용처를 찾되 비밀 키 값을 출력하거나 채팅·로그에 붙이지 않습니다. 저장소 검색에서도 비밀값 자체를 수집하는 대신 파일 경로와 변수 이름, 참조 구조를 확인합니다.
IAM의 마지막 사용 정보는 유용하지만 앞으로 실행될 월간 작업의 존재까지 증명하지는 않습니다. 실행 기록과 운영 목록을 함께 대조합니다.
두 키를 함께 사용할 전환 구간을 준비
IAM 사용자는 키 개수 제한이 있으므로 기존 키 상태를 먼저 확인합니다. 새 키를 만들기 위해 사용 중인 키를 임의로 삭제하지 않습니다. 필요 없는 키인지 확인하고 정리하는 절차가 선행돼야 합니다.
AWS의 액세스 키 업데이트 문서는 새 키 생성, 애플리케이션 업데이트, 구 키 사용 확인, 비활성화, 최종 삭제의 흐름을 안내합니다. 비밀 키는 생성 시 보관 기회를 놓치면 다시 조회할 수 없으므로 승인된 비밀 저장소에 직접 저장합니다.
새 키에는 기존 IAM 사용자의 권한이 적용됩니다. 교체 자체가 과도한 권한을 줄여 주는 것은 아닙니다. 권한 정리도 필요하다면 별도 변경으로 검증해 문제 원인을 구분하기 쉽게 만듭니다.
한 사용처씩 바꾸고 실제 API를 확인
시험 환경이나 영향이 작은 작업부터 새 키를 참조하도록 바꿉니다. 변수 이름을 바꿨는데 프로세스가 이전 환경값을 계속 들고 있을 수 있으므로 재시작·재배포 조건을 확인합니다.
aws sts get-caller-identity --profile rotation-test
이 명령은 시험 프로파일이 어느 계정과 주체로 인증되는지 확인합니다. 비밀 키를 보여 주지는 않지만, 결과의 계정 정보도 공개 로그에 불필요하게 남기지 않습니다. 이 호출이 성공했다고 S3 업로드나 배포 권한까지 검증된 것은 아닙니다.
사용처별로 실제 필요한 최소 작업을 수행합니다. 읽기 작업, 시험 경로에 파일 쓰기, 제한된 배포처럼 결과를 확인할 수 있는 절차를 선택합니다. 운영 데이터에 불필요한 변경을 만드는 시험은 피합니다.
구 키를 비활성화하는 단계에서 누락을 찾는다
모든 사용처 전환과 시험이 끝나면 구 키의 사용 기록을 확인하고 비활성화합니다. 비활성화는 삭제와 다르게 키 자체가 남아 있어 계획된 교체 중 누락 사용처를 조사하기 쉽습니다.
이후 인증 실패, 배포 실패, 예약 작업 결과를 봅니다. 기다릴 기간은 업무 주기에 맞춥니다. 매월 실행되는 작업을 한 시간 관찰하고 “모든 사용처 정상”이라고 결론 내리지 않습니다. 가능한 경우 해당 작업을 안전한 시험 모드로 직접 실행합니다.
구 키 비활성화 후 문제가 생기면 실패한 사용처가 새 설정을 읽었는지 먼저 확인합니다. 계획된 교체에서 복구가 필요하더라도 재활성화의 영향과 기간을 제한하고, 유출 의심 키를 편의상 다시 켜지 않습니다.
최종 삭제와 이후 운영
검증이 끝나면 구 키를 삭제하고 비밀 저장소의 이전 버전 보관 정책도 확인합니다. 삭제한 키를 다시 복원할 수 있다고 가정하지 않습니다. 변경 기록에는 키의 비밀값 대신 식별 가능한 제한된 ID 정보, 사용처, 시험 결과, 비활성화·삭제 시각을 남깁니다.
가능한 사용처는 장기 키를 없애는 방향도 검토합니다. EC2는 인스턴스 역할, CI는 지원되는 OIDC 기반 임시 자격 증명 등으로 바꾸면 배포용 장기 키의 수명 관리 부담을 줄일 수 있습니다. 다만 신뢰 정책과 대상 권한을 별도로 검증해야 합니다.
교체 완료 기준: 새 키로 필요한 작업이 성공하고, 구 키를 비활성화한 상태에서 해당 업무 주기의 작업이 정상이며, 더 이상 필요 없는 구 키가 삭제된 상태입니다. 새 키를 발급받은 시점은 완료가 아니라 전환의 시작입니다.