Keycard로 안전하게, AI 에이전트(AI Agent)로 똑똑하게!

다양한 업무 도구(Google Calendar, Linear, Gmail 등) 연동을 위해 AI 에이전트(AI Agent) 'Todaygent'를 개발, 업무 계획 자동화(Automated Task Planning) 시도

Keycard를 활용하여 안전한 인증(Secure Authentication) 시스템 구축, OAuth 구현 복잡성(OAuth Implementation Complexity) 감소 및 보안 강화

토큰 기반(Token-Based) 아키텍처를 통해 최소 권한(Least Privilege) 원칙 준수, 에이전트(Agent)의 데이터 접근 권한을 세분화

감사 로그(Audit Log) 기능을 통해 에이전트(Agent)의 활동을 추적, 데이터 접근 투명성(Data Access Transparency) 확보

Keycard를 활용한 인증(Auth) 시스템 설계

본문에서는 다수의 API(API) 연동을 위한 인증(Auth) 문제를 해결하기 위해 Keycard를 도입했다. 기존의 개별 OAuth 구현 방식 대신, Keycard를 중앙 집중형 인증(Centralized Authentication) 제어 평면(Control Plane)으로 활용하여 개발 및 유지보수 비용을 절감했다.

PKCE(PKCE) 방식을 사용한 Google OAuth 로그인: 클라이언트 시크릿(Client Secret) 노출 위험 감소

토큰 중개 백엔드(Token-Mediating Backend) 아키텍처: React 프론트엔드(Frontend)에서 Keycard JWT(JSON Web Token)를 전달, 백엔드(Backend)에서 API 호출 및 결과 반환

RFC 8693 토큰 교환(Token Exchange): Keycard JWT를 API 제공자별 액세스 토큰(Access Token)으로 교환, 최소 권한(Least Privilege) 원칙 준수

토큰 기반(Token-Based) 아키텍처의 장점

Keycard를 사용한 아키텍처는 토큰(Token) 기반 인증 방식을 통해 보안(Security)과 유연성을 동시에 확보한다. 특히, 에이전트(Agent)의 데이터 접근 권한을 세분화하여 보안 사고 발생 시 피해 범위를 최소화한다.

Task-Scoped Credentials: 각 API 호출마다 새로운 토큰 발급, 토큰 재사용(Token Reuse) 방지

Composite Identity: 사용자(User) + 에이전트(Agent) + 리소스(Resource)의 복합적인 신원 정보(Identity Information) 관리

Zero Standing Access: 장기적인 자격 증명(Credential) 보관 금지, 무단 접근(Unauthorized Access) 위험 감소

이러한 설계는 데이터 격리 아키텍처(Data Isolation Architecture)를 구현하고, 에이전트(Agent)의 안전한 운영을 보장한다.

Keycard 감사 로그(Audit Log)를 통한 가시성 확보

Keycard는 상세한 감사 로그(Audit Log) 기능을 제공하여 에이전트(Agent)의 활동을 투명하게 추적할 수 있도록 지원한다. 이를 통해 개발자는 에이전트(Agent)가 어떤 리소스(Resource)에 접근했는지, 어떤 권한(Permission)으로 접근했는지 정확하게 파악할 수 있다.

전체 이벤트(Event) 기록: 모든 토큰 교환, 사용자 인증, 자격 증명 발급, 리소스 접근 기록

Identity Chain: 애플리케이션(Application)과 사용자(User) 간의 관계를 추적, 책임 소재(Accountability) 명확화

세션(Session) 및 권한(Grant) 관리: 특정 세션(Session) 또는 리소스(Resource)에 대한 접근 권한을 개별적으로 제어, 유연한 권한 관리(Flexible Permission Management)

이러한 기능은 데이터 미저장 정책(Zero-Retention Policy)과 함께, 에이전트(Agent)의 안전한 운영을 위한 핵심 요소이다.