MongoDB에서 신뢰할 수 있는 에이전틱 커머스를 위한 권한 위임 원장

AP2와의 신뢰 구축

Google의 에이전트 Payments 프로토콜 (AP2)은 판매자, 금융 기관 및 일반 고객을 위한 신뢰할 수 있는 에코시스템을 빌드하는 안전하고 상호 운용 가능한 개방형 프로토콜을 제공합니다.

그림 1. 신뢰 계층

AP2 는 에이전트가 생성하고 교환하는 변조 방지 기능이 있고 암호화된 JSON 페이로드인 확인 가능한 디지털 자격 증명(VDC)을 통해 트랜잭션을 보호합니다. AP2 는 이러한 VDC를 세 가지 핵심 의무로 분류합니다.

• 의도 위임: 고객이 요구하는 사항을 간략하게 설명하고 AI 에이전트 고객을 대신하여 구매할 수 있는 조건을 정의합니다.

• 카트 위임: 상인과 고객 모두가 서명한 디지털 영수증을 제공하여 사람이 있는 구매를 승인합니다.

• 지불 위임: 지불 네트워크와 직접 공유되는 가시성 계층을 만들어 AI 에이전트 참여를 안전하게 신호합니다.

VDC는 영구적인 디지털 계약 역할을 합니다. 에이전트는 이러한 페이로드를 암호화하여 서명하여 고객 의도를 포착합니다. 이 과정은 쇼핑 경험의 모든 단계에 대해 부인정 감사 추적을 생성합니다.

그림 2. 모든 단계에서 확인 가능한 증거를 포함한 계약상 대화

그림 3. 대화 내에서 각 인텐트가 어떻게 표시되는지 보여주는 사용자 인터페이스의 인텐트 시각화

MongoDB Atlas로 인증 가능성 확보

이러한 암호화 VDC가 신뢰할 수 있으려면 시스템은 보안이 강화된 확인 가능한 환경에 저장해야 합니다. Mandate Ledger Service는 AI 에이전트와 데이터베이스 사이의 보호 미들웨어 역할을 합니다. 이 미들웨어 뒤에는 MongoDB Atlas가 있습니다.

Atlas는 변조 방지 감사 추적을 지원하도록 설계된 엔터프라이즈 급 보안을 제공합니다. 안전한 에이전틱 상거를 확장하는 데 필요한 불변의 신뢰 계층인 Mandate Ledger Service를 만들려면 이 아키텍처를 빌드하세요.

고객이 AI 도우미에게 새 스마트폰 쇼핑을 요청하는 상황을 상상해 보세요. 쇼핑 에이전트는 상인과 자율적으로 협상하여 최적의 거래를 찾습니다. 위임 레저 서비스는 모든 요청, 승인 및 결제 단계를 암호화된 JSON 위임으로 패키징하여 이 전체 과정을 기록합니다. MongoDB Atlas는 각 위임을 불변 문서로 저장합니다. 이 과정은 간단한 채팅을 영구적이고 불가역적인 의도 증명으로 변환합니다.

이 솔루션은 AP2 프로토콜 사용하는 아키텍처 위에 위임 원장 서비스를 빌드 방법을 보여줍니다.

원장 서비스: 보호 막

원장 서비스는 상인 에이전트를 데이터베이스에 연결하는 보호 미들웨어 역할을 합니다. FastAPI 또는 gRPC를 사용하여 이 서비스를 빌드합니다.

그림 5. 위임 원장 서비스 세부 아키텍처

세 개의 다른 보안 계층을 통해 모든 에이전트 요청을 처리합니다.

• 인증 계층: API 키를 검증하여 에이전트를 안전하게 식별합니다. 에이전트 유형별 역할 기반 접근 제어(RBAC)를 적용하여 엄격한 에이전트 권한을 시행합니다.

• 비즈니스 로직 계층: 핵심 요청 유효성 검사 및 동시성 제어 실행합니다. 안전한 네트워크 재시도를 위해 멱등성을 시행하고 엄격한 위임 불변성을 지원합니다.

• 데이터 액세스 계층: MongoDB 클라이언트와 최적화된 인덱싱을 사용하여 데이터베이스 작업을 실행합니다. 이 계층은 _id 필드를 변경 불가능하게 정의하고 스키마 유효성 검사를 통해 모든 업데이트 및 삭제 작업을 차단합니다.

위임 체인: 의도에서 결제까지

모든 AP2 트랜잭션은 암호화된 서명이 있는 명령의 구조화된 순서를 거치답니다. 각 단계는 MongoDB Atlas에 변경되지 않는 기록을 생성하여 의도부터 지불까지 완전한 감사 추적을 만듭니다.

그림 6. 데이터 흐름

트랜잭션을 의도에서 결제로 이동하려면 AP2 에이전트는 다음 트랜잭션 시퀀스를 완료합니다.

1. 고객의 의도를 파악합니다. 쇼핑 에이전트는 "러닝화"와 같은 자연 언어 설명을 고객의 요청을 구조화된 의도 임무로 변환합니다. 의도 임무는 대상 상인, 환불 가능 요구 사항, 장바구니 확인 기본 설정 및 만료 기간을 포함합니다. 쇼핑 에이전트는 고객을 대신하여 EdDSA를 사용하여 임무에 서명하고 상태가 signed 이고 내용을 잠그는 버전 해시를 포함하여 상인 에이전트에 보냅니다.

2. 의도 위임을 저장합니다. 머천트 에이전트는 위임 원장 서비스를 통해 Atlas 에 인텐트 위임 쓰기 (write)를 합니다. 원장 서비스는 요청 의 유효성을 검사하고, RBAC를 적용, 기록 변경 불가능하게 추가합니다.

3. 카트 위임장을 만듭합니다. 상인 에이전트는 풀 제품 세부 정보(항목 이름, 가격, 통화, 허용되는 결제 방법 및 만료 일자)가 포함된 카트 제안을 빌드합니다. 상인 에이전트는 이후 위임장 원장 서비스를 통해 Atlas에 저장합니다. 이곳에서 기록은 proposed 상태와 버전 해시를 받아 무결성을 보장합니다.

4. 고객에게 장바구니를 제공합니다. 상인 에이전트는 제안된 장바구니 위임장을 쇼핑 에이전트에 반환하고, 쇼핑 에이전트는 사용가에게 사용 가능한 제품 옵션을 제시합니다.

5. 장바구니 위임을 승인합니다. 고객이 옵션을 선택합니다. 쇼핑 에이전트는 hardware로 지원되는 장치 키를 사용하여 고객을 대신하여 카트 위임에 서명하고 승인된 위임장을 상인 에이전트에게 다시 보냅니다.

6. 카트 위임장에 연서하고 최종 승인합니다. 상인 에이전트는 승인된 카트에 암호화 서명을 추가하고 완전히 이중 서명된 카트 위임장을 Atlas에 저장하여 signed 상태로 합의된 터를 잠겉니다.

7. 지불 위임장을 만듭합니다. 쇼핑 에이전트는 적절한 지불 토큰을 조회하기 위해 자격 증명 제공자에게 쿼리합니다. 쇼핑 에이전트는 그 다음 고객을 대신하여 지불 위임장을 만들고 서명한 후 상인 에이전트에게 보냅니다. 자격 증명 제공자는 전체 크레딧 카드 번호를 반환하지 않습니다. 이로써 쇼핑 에이전트는 원시 데이터에 접근할 수 없습니다.

8. 결제 위임장을 저장합니다. 상인 에이전트는 서명된 결제 위임장을 Mandate Ledger Service를 통해 Atlas에 쓰기 (write)합니다. 원장 서비스는 이 위임장을 금융 기관과 직접 공유하여 AI 에이전트 개입 여부를 표시하고, 결제 처리기는 이 위임장을 사용하여 결제 네트워크로 권한 부여를 라우팅합니다.

에이전트는 기존 기록을 수정하거나 삭제할 수 없습니다. MongoDB Atlas는 추가만 가능한 쓰기 (write)를 시행하므로 완전한 위임 체인(의도, 장바구닄니, 결제)이 그대로 유지되며 어떤 시점에서든 에이전트가 독립적으로 확인할 수 있습니다.

Mandate Ledger: 다형 문서 저장

mandate_ledger 컬렉션에는 세 가지 의무 유형이 하나의 컬렉션에 저장됩니다. entity_type 필드를 사용하여 쿼리 시점에 의무 유형을 구분할 수 있으므로 조인 또는 의무 유형별 별도 컬렉션이 필요 없습니다.

모든 문서는 공통된 엔벨로프 구조를 공유합니다.

{
  "entity_id": "IntentMandate_955181ea-11c3-4379-92c4-3e27c5f278d3",
  "entity_type": "IntentMandate",
  "version": 1,
  "status": "signed",
  "transaction_id": "txn_fca7db66-c769-4206-b891-7140af37f8f4",
  "user_id": "hunter-d53910cf-b9e2-4876-8668-8251c990e203",
  "created_by_agent": "merchant_agent_dev",
  "created_by_agent_type": "merchant-agent",
  "current_version_hash": "4a822a01468a27dfd...",
  "signatures": [...],
  "mandate_data": { ... }
}

mandate_data 필드에는 유형 고유 페이로드가 포함되며, 각 원장 유형에 따라 다른 데이터 구조가 저장됩니다.

"mandate_data": {
  "natural_language_description": "cheapest french press coffee maker",
  "merchants": [],
  "skus": [],
  "requires_refundability": true,
  "user_cart_confirmation_required": true,
  "intent_expiry": "2026-04-18T20:00:03.651746+00:00"
}

"mandate_data": {
  "contents": {
    "payment_request": {
      "method_data": [{ "supported_methods": "CARD", "data": { "network": ["mastercard", "paypal", "amex"] }}],
      "details": {
        "display_items": [
          { "label": "Standard Laptop", "amount": { "currency": "USD", "value": 1203.50 }, "refund_period": 30 },
          { "label": "Shipping", "amount": { "currency": "USD", "value": 2.00 }},
          { "label": "Tax", "amount": { "currency": "USD", "value": 1.50 }}
        ],
        "total": { "label": "Total", "amount": { "currency": "USD", "value": 1203.50 }}
      }
    },
    "shipping_address": { "recipient": "Bugs Bunny", "address_line": ["123 Main St"], "city": "Sample City", "country": "US" },
    "cart_expiry": "2026-04-17T20:29:05.197984+00:00"
  },
  "merchant_authorization": "eyJhbGciOiJSUzI1NiIs..."
}

"signatures": [
  { "signer_type": "shopping-agent", "algorithm": "EdDSA", "signed_at": "2026-04-17T19:59:49Z" },
  { "signer_type": "merchant-agent", "algorithm": "JWT",   "signed_at": "2026-04-17T19:59:50Z" }
]

"mandate_data": {
  "payment_mandate_contents": {
    "payment_details_total": { "label": "Total", "amount": { "currency": "USD", "value": 1203.50 }},
    "payment_response": {
      "method_name": "CARD",
      "details": { "token": { "value": "fake_payment_credential_token_5" }},
      "shipping_address": { "recipient": "Bugs Bunny", "address_line": ["123 Main St"], "city": "Sample City" },
      "payer_email": "bugsbunny@gmail.com"
    },
    "merchant_agent": "Generic Merchant",
    "timestamp": "2026-04-17T20:00:22.603453+00:00"
  },
  "user_authorization": "fake_cart_mandate_hash_cart_fb1b4c86..._fake_payment_mandate_hash_812843b2..."
}

결제: 최대한 효율의 완료 기록

payments 컬렉션에는 완료된 트랜잭션 단위로 하나의 문서가 저장됩니다. 이 컬렉션에는 확장 참조 패턴이 적용됩니다.

원장 전체 내용을 임베딩하는 대신 각 문서에는 세 개의 원장에 대한 원장 ID 및 승인 서명만 저장됩니다. 이 디자인은 지불 기록을 작고 읽기 쉬운 상태로 유지하면서 전체 감사 추적이 필요한 경우 mandate_ledger 컬렉션의 완전한 데이터에 대한 직접 포인터를 유지합니다.

{
  "payment_id": "pay_123c25ac-7b56-4e45-8dd1-30cdcda944c7",
  "transaction_id": "txn_6fbab918-2b5d-4ddd-89d8-fdb96e5648d9",
  "user_id": "hunter-263b752e-92be-4001-ab9d-38847811c663",
  "intent_mandate":  { "mandate_id": "IntentMandate_41bbeacf-...",  "signature": "0x_shopping_agent_sig_...", "timestamp": "2026-04-15T19:50:57Z" },
  "cart_mandate":    { "mandate_id": "CartMandate_c0e8f369-...",    "signature": "eyJhbGciOiJSUzI1NiIs...",  "timestamp": "2026-04-15T19:52:07Z" },
  "payment_mandate": { "mandate_id": "PaymentMandate_33c39b8c-...", "signature": "fake_cart_mandate_hash_...", "timestamp": "2026-04-15T19:53:53Z" },
  "amount": 28,
  "currency": "USD",
  "status": "SUCCESS",
  "payment_method_type": "CARD",
  "merchant_agent": "merchant_agent_dev",
  "payment_processor_agent": "payment_processor",
  "processed_at": "2026-04-15T19:54:14Z"
}

이 디자인은 문서를 의도적으로 작게 유지합니다. 전체 텀, 항목 및 암호화 증명은 mandate_ledger 컬렉션에 있습니다. 결제 기록은 트랜잭션이 완료되었음을 확인하고 전체 감사 체인을 재구성하는 데 필요한 세 개의 포인터를 제공하기 위해서만 존재합니다. 전체 추적이 필요한 경우 두 컬렉션을 연결하려면 transaction_id 필드를 사용합니다.

API 키: 보안 에이전트 식별

api_keys 컬렉션은 API 키를 managed하여 에이전트를 안전하게 식별합니다. 이 컬렉션을 사용하여 서비스를 호출하는 각 에이전트와 연결된 키를 저장합니다.

감사 로그: 운영 경로

audit_log 컬렉션에는 컴플라이언스 및 디버그의 모든 API 작업이 저장됩니다. 이 컬렉션을 사용하여 위임 생성, 액세스 시도, 유효성 검사 결과 등 서비스 수준 이벤트를 기록합니다. 이 방식은 변경할 수 없는 위임 원장 자체가 확장되는 것을 방지합니다. TTL 인덱스를 추가하여 90 일 후 기록을 자동으로 제거합니다. 이렇게 하면 유용한 작업 경로를 유지하면서 컬렉션의 범위를 제한할 수 있습니다.

컬렉션에는 다음 주요 필드가 포함됩니다.

• event_type예: mandate.created 등 작업 유형을 식별합니다.

• entity_id: 관련 위임을 참조합니다.

• actor_agent_id: 어떤 에이전트가 조치를 수행했는지 포찱합니다.

• event_timestamp: 이벤트가 발생한 시간을 기록하고 TTL 정책을 지원합니다.

• expires_at: MongoDB가 기록을 자동으로 삭제하는 시점을 정의합니다.

동일성 기록: 안전한 재시도 처리

idempotency_records 컬렉션에는 작업 중복을 방지하기 위한 이덴포텐시 키가 저장됩니다. 이 컬렉션을 사용하여 클라이언트가 제공한 키, 요청을 수행한 에이전트 및 해당 작업에 대해 생성된 원장 기록을 유지할 수 있습니다. TTL 인덱스를 추가하여 24 시간 후 기록을 자동으로 제거합니다.

컬렉션에는 다음 주요 필드가 포함됩니다.

• idempotency_key: 고유한 클라이언트 제공 키를 저장하고 인덱스가 필요합니다.

• agent_id: 요청을 수행한 에이전트를 식별합니다.

• ledger_entry_id: 원래 요청에 대해 생성된 위임을 참조합니다.

• expires_at: MongoDB가 기록을 자동으로 삭제하는 시점을 정의합니다.

전제 조건

시작하기 전에 다음 항목이 설치되고 구성되어 있는지 확인합니다.

• MongoDB Atlas 또는 자체 관리형 MongoDB 7.0 이상

• Python 3.13 (버전 3.13.x)

• 종속성 관리를 위한 uv

• Google API 키 또는 Vertex AI 액세스

• 서비스를 컨테이너로 실행 Docker

• 프론트엔드 애플리케이션 위한 Node.js 및 npm

절차