{
  "id": "ucp.identity.oauth-metadata",
  "protocol": "ucp",
  "layer": "identity-trust",
  "role": "merchant",
  "status": "recommended",
  "title": "Publish OAuth 2.0 metadata for identity linking",
  "description": "Identity linking uses OAuth 2.0; metadata sits at /.well-known/oauth-authorization-server.",
  "goal": "Lets an agent link to the buyer's existing account so loyalty, addresses and order history carry over.",
  "note": "Only needed if you support identity linking.",
  "how_to_implement": {
    "steps": [
      "Expose an OAuth 2.0 authorization server.",
      "Publish RFC 8414 metadata at /.well-known/oauth-authorization-server."
    ]
  },
  "resources": [
    {
      "label": "UCP spec overview (2026-08-25)",
      "url": "https://ucp.dev/2026-08-25/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP getting started",
      "url": "https://ucp.dev/specification/getting-started/",
      "type": "docs",
      "publisher": "UCP"
    }
  ],
  "audit": {
    "method": "http_get",
    "automatable": true,
    "url_pattern": "/.well-known/oauth-authorization-server",
    "expect": {
      "status": 200,
      "content_type": "application/json",
      "json_keys": [
        "issuer",
        "authorization_endpoint",
        "token_endpoint"
      ]
    },
    "human": "GET returns 200 JSON with issuer, authorization_endpoint and token_endpoint (RFC 8414)."
  },
  "how_to_verify": "GET returns 200 JSON with issuer, authorization_endpoint and token_endpoint (RFC 8414).",
  "artifacts": [
    "/.well-known/oauth-authorization-server"
  ],
  "depends_on": [],
  "status_note": "Only needed if you support identity linking.",
  "verified": true,
  "slug": "ucp-identity-oauth-metadata",
  "category": "identity-trust",
  "url": "https://vreeman.ai/commerce/checklist#ucp.identity.oauth-metadata",
  "updated": "2026-10-12",
  "sources": [
    {
      "label": "UCP spec overview (2026-08-25)",
      "url": "https://ucp.dev/2026-08-25/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP getting started",
      "url": "https://ucp.dev/specification/getting-started/",
      "type": "docs",
      "publisher": "UCP"
    }
  ],
  "related_slugs": []
}