[AI Agent] 모델 인증과 문서 보관을 함께 지키는 보안 설계
두줄요약
AWS Secrets Manager와 S3로 AI Agent의 모델 인증과 보고서 보관을 분리해 설계했습니다. 권한 확인, 객체 버전 관리, 키 교체 검증을 통한 운영 보안 원칙을 설명합니다.
구조와 흐름
- 실행 IAM 역할 기반 AWS 접근과 Secrets Manager 기반 모델 API 키 조회 분리
- 공통 계층에서 시크릿 조회·검증, S3 저장, 다운로드 URL 발급 처리
- 업무 서비스에서 문서 내용·소유 관계·열람 권한·상태 기록 담당
성능/운영 포인트
- 시크릿 JSON 형식·빈 값·버전 ID 검증과 캐시 갱신 정책 수립
- S3 객체 버전·SHA-256·조건부 업로드를 통한 문서 동일성 및 재처리 추적
- 시크릿 교체 후 새 값 조회와 실제 모델 인증 호출을 분리한 검증
주의할 점
- 객체 키를 권한 경계로 간주하지 않고 업무 DB의 소유자·조직 관계로 인가
- 서명 URL 발급 전 권한 확인, 짧은 만료 시간 설정, URL 로그 기록 금지
- S3 업로드와 업무 DB 기록 사이 불일치에 대비한 미완료 상태 복구·정리 절차
적용해볼 점
- 개발·검증·운영 환경별 시크릿과 저장 공간, 실행 역할 권한 분리
- S3·KMS·IAM 실제 권한 검증과 시크릿 갱신·연결 갱신·다운로드 실패 시나리오 테스트




