엔터프라이즈 애플리케이션에 Amazon Quick Suite 채팅 에이전트 임베딩하기

섹션별 상세

솔루션은 Amazon CloudFront와 S3를 사용하여 프론트엔드 자산을 안전하게 배포하고 Amazon Cognito를 통해 OAuth 2.0 기반의 사용자 인증을 처리한다. 사용자가 웹 포털에 접속하면 CloudFront가 S3에서 정적 파일을 가져오며 인증되지 않은 사용자는 Cognito 호스팅 UI로 리디렉션되어 로그인을 수행한다. 로그인 성공 후 발급된 인증 코드는 API Gateway를 거쳐 백엔드 Lambda 함수로 전달된다.

Amazon Quick Suite 채팅 에이전트 임베딩 솔루션의 전체 아키텍처 다이어그램 — Diagram사용자 브라우저에서 CloudFront를 거쳐 Cognito 인증을 수행하고 Lambda와 STS를 통해 Quick Suite 임베딩 URL을 생성하는 전체 워크플로를 시각화한다. 각 단계별 데이터 흐름과 사용되는 AWS 서비스 간의 상호작용을 12단계로 상세히 보여준다.

보안 강화를 위해 AWS WAF의 속도 제한, S3의 원본 액세스 제어(OAC), 그리고 Lambda에서의 JWT 서명 검증을 포함한 다층 방어 체계를 구축한다. Lambda 함수는 Cognito의 공개 키(JWKS)를 사용하여 ID 토큰의 암호화 서명을 검증하며 스레드 세이프 캐싱을 통해 성능을 최적화한다. 이러한 구조는 비정상적인 요청을 차단하고 인증된 사용자만이 시스템에 접근할 수 있도록 보장한다.

사용자 인증이 완료되면 Lambda 함수는 AWS STS를 통해 임시 자격 증명을 획득하고 Quick Suite의 보안 임베딩 URL을 생성한다. STS의 AssumeRoleWithWebIdentity API를 호출하여 최소 권한 원칙이 적용된 IAM 역할을 수임하며 이를 통해 획득한 임시 키로 GenerateEmbedUrlForRegisteredUser API를 실행한다. 최종적으로 생성된 URL은 도메인 제한이 적용되어 지정된 엔터프라이즈 포털 내에서만 유효하다.

AWS CDK를 활용한 원클릭 배포 방식을 지원하며 제공된 셸 스크립트를 통해 전체 인프라 프로비저닝 과정을 자동화한다. 사용자는 GitHub 저장소를 복제한 후 ./setup.sh를 실행하여 AWS 리전, 스택 ID, 포털 제목 등을 설정할 수 있다. 인프라 배포 후에는 Python 스크립트를 사용하여 Cognito 사용자를 생성하고 Quick Suite 콘솔에서 에이전트를 공유하는 간단한 절차만으로 시스템 가동이 가능하다.