API schema ruleset

clearplane-api-schema supplies a rule for each API-schema violation kind, shared by OpenAPI documents, protobuf descriptor sets and GraphQL schemas. Version 1.1.0 adds rule 1960113 for unexpected-message-count, which gRPC schemas report. Attach an API schema to the route's WAF policy: activating this ruleset alone does not select a schema. Validation results become scores; the policy mode and ruleset stages determine whether they can block.

Paranoia levels and compatibility

An outdated schema can reject a legitimate client. Check required parameters, types, formats, request media types, additional-property rules, protobuf field numbers and GraphQL fields against actual API traffic.

Start in Detection, review detections, and configure only the exclusions needed for the affected route and field.

See the measured coverage for the exact tested payload hashes, missed detections and false-positive rates. Ruleset operation explains activation, stages and rollback.