80trust / 100

Openapi Security Summary

by OpenAPI security summary in Security & trust

x402 APIPassing, checked 3 h ago

Resolve authentication requirements across an OpenAPI 3.x or Swagger 2.x document. Returns the catalog of security schemes (`components.securitySchemes` in OpenAPI 3, `securityDefinitions` in Swagger 2) verbatim, the document-level default, and the *effective* security for each operation after layering.

POST https://agent402.tools/api/openapi-security-summary

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
269 ms typical, 365 ms slowest 5%
Last check
3 h ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://agent402.tools/api/openapi-security-summary" \
  -H "content-type: application/json" \
  -d '{"spec":{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"title":"Demo","version":"1.0.0"},"openapi":"3.0.0","paths":{"/admin":{"post":{"responses":{"201":{}},"security":[{"bearerAuth":["admin"]}]}},"/public":{"get":{"responses":{"200":{}},"security":[]}},"/users":{"get":{"responses":{"200":{}}}}},"security":[{"bearerAuth":[]}]}}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fagent402.tools%2Fapi%2Fopenapi-security-summary
const res = await pay("https://agent402.tools/api/openapi-security-summary", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"spec":{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"title":"Demo","version":"1.0.0"},"openapi":"3.0.0","paths":{"/admin":{"post":{"responses":{"201":{}},"security":[{"bearerAuth":["admin"]}]}},"/public":{"get":{"responses":{"200":{}},"security":[]}},"/users":{"get":{"responses":{"200":{}}}}},"security":[{"bearerAuth":[]}]}}),
});
console.log(await res.json());

Example input

{
  "spec": {
    "components": {
      "securitySchemes": {
        "bearerAuth": {
          "scheme": "bearer",
          "type": "http"
        }
      }
    },
    "info": {
      "title": "Demo",
      "version": "1.0.0"
    },
    "openapi": "3.0.0",
    "paths": {
      "/admin": {
        "post": {
          "responses": {
            "201": {}
          },
          "security": [
            {
              "bearerAuth": [
                "admin"
              ]
            }
          ]
        }
      },
      "/public": {
        "get": {
          "responses": {
            "200": {}
          },
          "security": []
        }
      },
      "/users": {
        "get": {
          "responses": {
            "200": {}
          }
        }
      }
    },
    "security": [
      {
        "bearerAuth": []
      }
    ]
  }
}

Example output

{
  "globalSecurity": [
    {
      "bearerAuth": []
    }
  ],
  "operations": [
    {
      "method": "GET",
      "open": true,
      "path": "/public",
      "security": []
    },
    {
      "method": "GET",
      "open": false,
      "path": "/users",
      "security": [
        {
          "bearerAuth": []
        }
      ]
    },
    {
      "method": "POST",
      "open": false,
      "path": "/admin",
      "security": [
        {
          "bearerAuth": [
            "admin"
          ]
        }
      ]
    }
  ],
  "schemes": {
    "bearerAuth": {
      "scheme": "bearer",
      "type": "http"
    }
  },
  "summary": {
    "openOperations": 1,
    "operations": 3,
    "schemeUsage": {
      "bearerAuth": 2
    },
    "schemes": 1,
    "securedOperations": 2
  }
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
3 h agoPassed402263 ms$0.001
7 h agoPassed402452 ms$0.001
10 h agoPassed402365 ms$0.001
14 h agoPassed402253 ms$0.001
18 h agoPassed402269 ms$0.001
21 h agoPassed402269 ms$0.001
26 h agoPassed402295 ms$0.001