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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

기업 환경에서 대화형 AI를 기존 업무 도구에 통합하는 것은 보안 및 인증 구현의 복잡성으로 인해 많은 시간이 소요된다. 이 솔루션은 AWS CDK를 사용하여 Amazon Quick Suite 채팅 에이전트를 엔터프라이즈 포털에 안전하게 임베딩하는 자동화된 아키텍처를 제공한다. Amazon CloudFront, Cognito, Lambda 등을 결합한 서버리스 구조를 통해 글로벌 배포와 강력한 보안을 동시에 달성한다. 이를 통해 개발자는 복잡한 인프라 구축 대신 AI 에이전트의 비즈니스 로직과 사용자 경험 최적화에 집중할 수 있다.

배경

AWS 계정 및 Quick Suite 구독, AWS CDK CLI 및 Python Boto3 라이브러리, Node.js 20+ 및 Docker Desktop, AWS 리소스 생성을 위한 적절한 IAM 권한

대상 독자

엔터프라이즈 환경에서 보안이 강화된 AI 채팅 시스템을 구축하려는 클라우드 아키텍트 및 개발자

의미 / 영향

이 솔루션은 AI 에이전트 도입의 가장 큰 장벽인 보안 인프라 구축 비용을 획기적으로 낮춘다. 서버리스 아키텍처를 채택하여 사용량에 따른 유연한 확장이 가능하며 기업은 기존 워크플로 내에 AI를 즉시 통합하여 업무 효율성을 높일 수 있다.

섹션별 상세

솔루션은 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 콘솔에서 에이전트를 공유하는 간단한 절차만으로 시스템 가동이 가능하다.

배포 스크립트 실행 시 사용자 입력을 받는 터미널 화면 — Screenshotsetup.sh 스크립트 실행 시 포털 제목, CloudFormation 스택 이름, AWS 리전 및 프로필 정보를 입력하는 과정을 보여준다. 자동화된 배포 프로세스에서 사용자가 설정해야 할 주요 파라미터들을 확인할 수 있다.

AWS CDK 배포 완료 후 출력되는 리소스 정보 목록 — Screenshot배포가 성공적으로 완료된 후 생성된 API 도메인, CloudFront URL, Cognito 클라이언트 ID 등 주요 엔드포인트와 식별자들을 나열한다. 시스템 연동에 필요한 실제 환경 변수 값들을 제공한다.

배포 완료 메시지와 다음 단계 안내 화면 — Screenshot인프라 배포 후 사용자가 수행해야 할 후속 작업인 Cognito 사용자 생성 및 에이전트 공유 절차를 안내한다. 전체 구축 프로세스의 마지막 단계를 명확히 제시한다.

Python 스크립트를 이용한 Cognito 사용자 생성 결과 화면 — Screenshot제공된 스크립트를 통해 사용자가 성공적으로 생성되었음을 알리는 터미널 출력이다. 임시 비밀번호 발급 및 첫 로그인 시 비밀번호 변경 필요성 등 사용자 관리 정책을 보여준다.

실무 Takeaway

AWS CDK 기반의 자동화 스크립트를 사용하면 수주가 소요되던 AI 채팅 임베딩 인프라 구축 시간을 며칠 내로 단축하여 타임 투 마켓을 확보할 수 있다.
Cognito와 STS를 결합한 Web Identity Federation 방식을 적용하여 사용자별로 제한된 권한의 임시 자격 증명을 부여함으로써 엔터프라이즈급 보안 수준을 달성할 수 있다.
CloudFront와 WAF를 전면에 배치하여 전 세계 사용자에게 빠른 응답 속도를 제공함과 동시에 DDoS 공격 및 무단 접근으로부터 내부 리소스를 보호할 수 있다.

언급된 리소스

GitHubsample-quicksuite-chat-embedding GitHub Repository