XGuard — Secretless Agent Gateway

정식 프로덕션 API

https://api.xguardgate.com

정식 정체성 — v5.0.2: XGuard Secretless Agent Gateway. Secretless Egress가 기본 제품입니다. Action Rail 및 x402 facilitator 라우팅은 호환성 레일입니다. XGuard ACE, Solana/BAM speed bumps, Child Safety, Web Extractor, Universal Facilitator Gateway, High-Velocity x402 Facilitator 또는 일반적인 지출 전용 제어 플레인을 포함하는 과거 설명은 현재 XGuard 제품 정체성이 아닙니다. CANONICAL_IDENTITY.md를 참조하세요.

XGuard는 재사용 가능한 업스트림 자격 증명을 AI 에이전트로부터 차단합니다. 운영자는 Stripe, GitHub, OpenAI, Anthropic, Slack, Notion, Cloudflare, Gemini 또는 커스텀 API 자격 증명을 한 번 저장한 뒤, 에이전트에게 단기 유효하고 범위가 제한된 XGuard capability만 부여합니다.

Operator secret
     ↓
Encrypted XGuard credential vault
     ↓
Scoped capability
     ↓
AI agent
     ↓
XGuard Secretless Egress
     ↓
credential injected server-side
     ↓
upstream API

에이전트는 재사용 가능한 업스트림 자격 증명을 절대 받지 않습니다.

XGuard는 운영자가 재사용 자격 증명을 XGuard에만 보관하고 그 자격 증명을 재배포하는 대신 capability를 위임할 때 실제 병목 지점이 됩니다. XGuard는 무관한 인터넷 트래픽에 대한 통제를 주장하지 않습니다.

Secretless Egress가 필요한 이유

자율 에이전트 내부의 재사용 가능한 bearer 토큰은 복사되거나, 로그에 기록되거나, 컨텍스트에 포함되거나, 의도된 요청 외에 재사용되거나, 신뢰할 수 없는 도구에 유출될 수 있습니다. XGuard는 기본 요소를 비밀 보유에서 범위 제한 capability 보유로 변경합니다.

현재 egress 경계는 다음을 제공합니다:

• 암호화된 재사용 가능 자격 증명 저장;

• OpenAI, Anthropic, GitHub, Stripe, Slack, Notion, Cloudflare 및 Gemini용 프로바이더 사전 설정;

• 명시적 공개 HTTPS 호스트로 제한된 커스텀 헤더 기반 자격 증명;

• 단기 유효 capability;

• 정확한 HTTPS origin 바인딩;

• 경로 접두사 허용 목록;

• HTTP 메서드 허용 목록;

• 최대 호출 횟수;

• 비밀 공개 및 아웃바운드 네트워크 egress 전 Usage Credit 과금;

• 리디렉션 간 자동 자격 증명 전달 없음;

• 프라이빗/로컬 대상 차단;

• 안전하지 않은 메서드에 대한 자동 Idempotency-Key 주입;

• 네트워크 불확실성 이후 맹목적 자동 재시도 없음;

• 모델 컨텍스트에 자격 증명 프로비저닝을 노출하지 않는 MCP 검색 및 egress 실행.

Related MCP server: Broker

Egress API

기계 판독 가능 계약:

GET https://api.xguardgate.com/v1/egress
GET https://api.xguardgate.com/.well-known/xguard-egress.json
GET https://api.xguardgate.com/.well-known/xguard-egress-key.json
GET https://api.xguardgate.com/v1/egress/providers

1. 운영자가 재사용 가능한 자격 증명을 저장합니다

자격 증명 프로비저닝은 의도적으로 MCP 도구가 아닌 운영자 API입니다.

POST /v1/egress/credentials
X-XGuard-Key: <usage-credit-key>
Content-Type: application/json

{
  "provider": "github",
  "value": "<github-token>",
  "label": "production-github",
  "allowed_paths": ["/repos/"],
  "allowed_methods": ["GET", "POST"]
}

XGuard는 xcred_... 같은 자격 증명 메타데이터만 반환하며, 재사용 가능한 비밀은 반환되지 않습니다.

2. 운영자가 단기 capability를 발급합니다

POST /v1/egress/capabilities
X-XGuard-Key: <usage-credit-key>
Content-Type: application/json

{
  "credential_id": "xcred_...",
  "target_origin": "https://api.github.com",
  "path_prefix": "/repos/",
  "allowed_methods": ["GET", "POST"],
  "ttl_seconds": 300,
  "max_calls": 10
}

에이전트가 받는 것은 반환된 xgc_... capability입니다.

3. 에이전트는 업스트림 비밀 없이 실행합니다

POST /v1/egress/fetch
Content-Type: application/json

{
  "capability": "xgc_...",
  "target": "https://api.github.com/repos/org/repo/issues",
  "method": "POST",
  "body_json": {
    "title": "Example"
  }
}

XGuard는 capability 범위와 과금을 검증하고, GitHub 자격 증명을 서버 측에서 주입하며, HTTPS 요청 하나를 보내고, 재사용 가능한 GitHub 토큰을 에이전트에게 절대 노출하지 않습니다.

과금 계약:

GET /v1/egress/pricing

현재 구성은 인증된 자격 증명 기반 egress 시도 1회당 XGuard Usage Credit 1개를 소비합니다. 과금은 자격 증명 복호화 이전, 그리고 아웃바운드 네트워크 egress 이전에 확정됩니다. 과금이 확정되지 않으면 업스트림 요청은 전송되지 않습니다.

MCP

정식 MCP 엔드포인트:

https://api.xguardgate.com/mcp

에이전트 지향 도구에는 다음이 포함됩니다:

xguard_secretless_egress
xguard_egress_fetch
xguard_action_rail

재사용 가능한 자격 증명 생성은 의도적으로 MCP 도구로 노출되지 않습니다.

하부 Action Rail

Secretless Egress가 기본 제품 경계입니다. XGuard Action Rail은 결제, 구매, 예약, 메시지, 배포, 삭제, API 쓰기 및 도구 호출에 대한 더 강력한 실행 제어를 위해 하부에서 계속 사용할 수 있습니다.

POST /v1/mandates
POST /v1/actions/permits
POST /v1/actions/execute
GET  /v1/actions/permits/{permit_id}

Action Rail은 범위 제한 명령, 요청 바인딩 암호화 허가, 재생 거부, 지속적 실행 상태 및 영수증을 추가합니다.

범용 및 Edge 배포

운영자 제어 인프라의 경우 XGuard를 origin 앞에 배치할 수도 있습니다:

Internet / Ingress
      ↓
XGuard Universal Gate
      ↓
private origin

이 저장소에는 Cloudflare Edge Gate, 이식 가능한 Node 배포, Docker, Docker Compose, Kubernetes 및 OpenAPI AutoGate 구성 요소가 포함됩니다.

네이티브 x402 호환성

x402는 XGuard의 정의가 아니라 호환성 레일로 남아 있습니다.

GET  /supported
POST /verify
POST /settle
GET  /facilitator
GET  /.well-known/x402
GET  /v1/facilitator/route

XGuard는 capability 인지 라우팅, 재생 방지, Base USDC 대사 및 정산이 모호할 때 fail-closed로 처리하는 동작을 갖춘 비수탁형 x402 v2 facilitator 게이트웨이로 유지됩니다.

보안 모델

• 재사용 가능한 업스트림 자격 증명은 XGuard RSA-OAEP 권한에 의해 래핑된 레코드별 AES-GCM 키로 저장 시 암호화됩니다;

• 비밀 값은 에이전트 capability에 포함되지 않습니다;

• 운영자 XGuard Usage Credit 키는 capability 상태에 암호화된 형태로 포함되며 에이전트에게 전달되지 않습니다;

• capability는 origin, 경로 접두사, 메서드, 만료 및 최대 호출 횟수를 바인딩합니다;

• 사용자 제공 헤더는 주입된 자격 증명 헤더나 XGuard 제어 헤더를 덮어쓸 수 없습니다;

• 프라이빗/로컬 대상 및 XGuard 자체 대상은 차단됩니다;

• 리디렉션은 주입된 자격 증명과 함께 자동으로 따라가지 않습니다;

• 과금은 비밀 복호화 및 네트워크 egress 전에 확정됩니다;

• 안전하지 않은 메서드는 호출자가 제공하지 않은 경우 XGuard 생성 Idempotency-Key를 받습니다;

• XGuard는 네트워크 불확실성 이후 자격 증명 기반 요청을 자동으로 재시도하지 않습니다.

기계 검색

GET /.well-known/xguard-egress.json
GET /.well-known/xguard-actions.json
GET /.well-known/xguard.json
GET /.well-known/ai-plugin.json
GET /.well-known/agent-card.json
GET /architecture
GET /v1/protocols
GET /openapi.json
GET /llms.txt
GET /skill.md
GET /sitemap.xml

프로덕션 도메인

https://xguardgate.com
https://api.xguardgate.com

Cloudflare Worker 구성은 공개 workers.dev 경로를 비활성화하여 XGuard의 프로덕션 정체성을 커스텀 XGuard 도메인으로 제한합니다.

저장소:

https://github.com/moelayyan90/XGuard