본문으로 건너뛰기
막힌 위임 호출에서 확인하는 ID-JAG의 에이전트 인가 경계
목차

막힌 위임 호출에서 확인하는 ID-JAG의 에이전트 인가 경계 (2026-06)

원문 정보

토큰 없이 보호된 API를 호출하면 401 Unauthorized가 돌아옵니다. 의도한 실패입니다. athenz-community/id-jag-the-hard-way는 이렇게 호출을 막아 보며 AI 에이전트가 사용자를 대신해 API에 접근하는 데 필요한 토큰과 정책, 신뢰 관계를 확인하는 로컬 핸즈온입니다.

ID-JAG 시리즈의 2편입니다. 앞선 글 「AI 시대에 인증 과제를 해결할 차세대 표준 후보, ID-JAG」에서는 ID-JAG의 필요성과 싱글 사인온(SSO) 신뢰 모델의 API 확장, 도입 시 고려 사항을 다뤘습니다. 이번 실습에서는 구성도만으로 답하기 어려웠던 질문을 실제 동작으로 확인합니다. 토큰은 어디서 발급되고, 정책이 빠지면 호출은 어디서 끊기는지가 관찰 대상입니다.

영구 권한을 맡기기 어려운 AI 에이전트

AI 에이전트는 미리 정한 루틴을 실행하는 서비스 계정과 다릅니다. 자신의 행동에 즉각 책임을 질 수 있는 사람도 아닙니다. 내부 API와 SaaS 도구, 데이터베이스를 백그라운드에서 계속 호출하는 에이전트에게 매 단계마다 사용자 동의를 받게 하면 사용자 경험이 심하게 나빠집니다.

포괄적이고 영구적인 권한을 주는 쪽에도 문제가 있습니다. 에이전트가 오작동하거나 악용됐을 때 영향 범위가 커지고, 사용자의 의도와 에이전트의 자율 행동을 구분하기 어려워 책임 소재도 흐려집니다. 사용자가 행동을 수동으로 감시하느라 주의력과 운영 리소스를 쓰게 됩니다. 이런 권한 부여는 섀도우 AI의 확산을 부추기고, 조직을 프롬프트 인젝션 같은 공격에 노출시켜 공격 표면을 넓힐 수 있습니다.

프런트 도어에서 사용자를 인증하는 일만으로는 부족합니다. 에이전트가 지금 그 사용자를 대신해, 요청한 리소스와 권한 범위에 접근하도록 인가됐는지까지 확인해야 합니다. ID-JAG는 기업 IdP와 인가 서버 사이의 신뢰를 세밀한 기업 정책으로 통제하는 방식으로 이 문제를 다룹니다.

로그인과 API 접근 사이의 ID-JAG

데모를 작동시키는 데 ID-JAG가 꼭 필요한 것은 아닙니다. 이 핸즈온과 같은 소규모 로컬 설정에서는 Keycloak ID 토큰을 Athenz 액세스 토큰으로 직접 교환하는 것도 기술적으로 가능합니다. Athenz가 토큰의 발급자, 서명, 대상, 주체를 검증하고 기업 정책을 평가해 액세스 토큰을 발급할 수 있기 때문입니다.

그러나 이 구성은 로그인 토큰을 리소스 접근용 인가 그랜트로 암묵적으로 취급합니다. ID 토큰이 증명하는 것은 사용자가 클라이언트에 인증됐다는 사실뿐입니다. 특정 리소스와 범위의 액세스 토큰을 요청하려고 인가 서버에 제출하는 인가 그랜트와는 역할이 다릅니다.

ID-JAG(Identity Assertion JWT Authorization Grant)는 이 인가 경계를 명확하게 만듭니다. 그랜트를 분리하면 장애를 추적하거나 감사할 때 인증 실패, 그랜트 검증 실패, 에이전트 위임 거부, 기업 정책 거부, 리소스 토큰 거부를 구분할 수 있습니다. 자격 증명 데이터를 접근 권한과 혼동하지 않고, 로그인 성공이 크로스 도메인의 인가 권한을 자동으로 보장하지 않도록 하는 경계입니다. 특히 호출이 실패했을 때 이 구분의 가치가 드러납니다.

기반은 기존 OAuth 사양입니다. OAuth 2.0 Token Exchange(RFC 8693)와 JWT Profile for OAuth 2.0 Authorization Grants(RFC 7523)를 결합해 위임된 크로스 도메인 API 접근을 지원합니다. 2026년 5월 기준으로 IETF OAuth 워킹 그룹에서 논의 중인 인터넷 초안은 draft-ietf-oauth-identity-assertion-authz-grant-03입니다. 유망한 OAuth 기반 프로필이지만, 사실상 표준이라고 부르기에는 아직 이를 수 있습니다.

기업의 위임 정책을 모은 Athenz

일반적인 ID-JAG 모델에서는 IdP 인가 서버가 사용자 인증부터 클라이언트의 위임 가능 여부 평가, ID-JAG 발급까지 맡습니다. 이 핸즈온은 그 책임을 나눴습니다. 사용자 인증과 원본 ID 어서션은 Keycloak에 두고, 기업 정책의 평가와 ID-JAG 발급은 Athenz에 모았습니다.

구성 요소구현담당 역할
요청 에이전트Open WebUI, Ollama, Gemma 4, AI 클라이언트 게이트웨이사용자를 대신한 도구 실행
사용자 인증을 맡는 IdPKeycloak(Docker 환경)사용자 인증과 주체 어서션 관리
IdP 인가 서버Athenz KeycloakTokenExchangePluginID 어서션 검증, 기업 정책 적용, ID-JAG 발급
인가 서버Athenz(로컬 쿠버네티스 환경)정책 결정 지점(PDP), 액세스 토큰 발급
리소스 서버샘플 문서 API보호 대상인 최종 리소스

이 배치는 ID-JAG 드래프트의 가장 단순한 배포 모델과는 조금 다르지만, 다루는 보안 영역은 같습니다. 리소스 인가 서버는 업스트림 Keycloak 토큰을 인가 그랜트로 무조건 받아들이지 않습니다. Athenz가 발급자, 서명, 대상, 주체, 클라이언트 바인딩과 기업 정책을 모두 검사한 뒤 발급한 ID-JAG를 신뢰합니다.

인증 IdP가 벤더 관리 시스템인 환경에서 특히 유용한 분리입니다. 기업은 위임 정책을 여러 IdP와 SaaS 벤더, 리소스 앱에 나눠 두지 않고 Athenz 한곳에서 관리할 수 있습니다. 인가 로직의 벤더 종속을 줄이고, 여러 시스템에 중복되거나 모순된 정책이 생겨 발생하는 운영·보안 리스크도 피할 수 있습니다. 이 핸즈온에서 Athenz는 ID-JAG 발급자와 중앙 리소스 인가 서버, PDP를 겸하며 위임된 API 접근의 단일 진실 공급원 역할을 합니다.

MCP 서버를 거쳐 문서 API에 닿는 토큰

사용자가 Keycloak으로 로그인하고 프롬프트로 작업을 지시하면, 에이전트는 Athenz의 IdP 인가 서버에 ID-JAG를 요청합니다. 여기서 Athenz가 기업 정책을 평가해 요청된 위임이 허용되는지 검증합니다.

이후 에이전트는 Athenz 인가 서버에 액세스 토큰을 요청하고, 발급받은 토큰을 넣어 MCP(Model Context Protocol) 서버를 호출합니다. 토큰 교환은 여기서 끝나지 않습니다. MCP 서버도 인가 서버와 토큰을 교환한 뒤, 교환된 토큰으로 최종 리소스인 샘플 문서 API에 요청을 보냅니다.

이 흐름에서 에이전트는 장기 마스터 키를 보유하지 않습니다. 기업 정책 엔진이 평가한 경계 안에서만 동작합니다.

권한을 지우며 추적하는 차단 지점

인가 설계는 성공 경로보다 실패 경로를 따라갈 때 더 선명해집니다. 이 핸즈온에서는 토큰과 정책을 일부러 빠뜨려, 각 구성 요소와 신뢰 관계가 없을 때 호출이 어떻게 차단되는지 확인합니다.

의도적으로 만든 조건관찰할 결과
보호된 API에 토큰 없이 요청401 Unauthorized
엔터프라이즈 역할은 구성하되 멤버십 누락토큰 교환 실패
에이전트에 필요한 권한을 명시적으로 부여하지 않고 위임 호출위임 체인 단절

실습은 저장소 메인 페이지의 START THE TUTORIAL NOW 버튼에서 시작합니다. 로컬 환경을 설정하고 ID-JAG 흐름을 검증하는 가이드는 실패와 수정을 반복하며, 마지막에는 완전히 동작하는 상태로 안내합니다.

그 상태에서도 실험은 이어집니다. 예를 들어 Athenz UI에서 에이전트의 위임 권한을 제거한 뒤 실행이 어느 단계에서 차단되는지 추적할 수 있습니다. 설정을 일부러 망가뜨리고 경계를 확인하는 실험이 중앙 집중형 정책 제어를 배우는 가장 좋은 방법이라는 것이 이 핸즈온의 접근입니다.

저자는 Tech-Verse 2026에서 이 주제로 세션을 진행할 예정이라고도 밝혔습니다. 기본 프로토콜 메커니즘을 넘어 중앙 정책 제어 모델과 에이전트 생태계의 동향을 살펴볼 계획입니다.

핸즈온 구성과 참조 사양
항목값
ID-JAG 초안draft-ietf-oauth-identity-assertion-authz-grant-03 (2026년 5월 기준)
결합 사양RFC 8693(Token Exchange), RFC 7523(JWT Profile for Authorization Grants)
에이전트Open WebUI, Ollama, Gemma 4, AI 클라이언트 게이트웨이
IdPKeycloak (Docker)
IdP 인가 서버Athenz KeycloakTokenExchangePlugin
인가 서버Athenz (로컬 쿠버네티스)
리소스 서버샘플 문서 API
저장소athenz-community/id-jag-the-hard-way
마지막 수정 일자