scanrub
Inconsistency Between Implementation and Documented Designlow prioritynot yet scanned

Inconsistency Between Implementation and Documented Design

2 min read 1 reports analyzed ScanRub Research
Share

Summary

The actual running application doesn't match what its own design documentation, API specification, or security model claims it does - a documented access-control rule that the code doesn't actually enforce, or an API contract that the implementation silently deviates from in a security-relevant way.

◈ flow diagram
Legitimate W…Unanticipate…Business Rul…Intended Out…

Why This Requires More Than a Black-Box Scan

Confirming this requires comparing the actual application's behavior against its own documentation or design spec - a direct, deliberate comparison exercise that needs both the documentation and hands-on testing of the real behavior, not a generic technical probe.

Where This Is Actually Caught

Manual review that cross-references the application's documented design, API specification, or stated security model against its actual observed behavior, flagging every point of divergence.

Tip: There's no generic payload or scanner signature for a logic flaw by definition — the request is technically valid, so finding these requires someone who already understands the specific workflow's intended rules deliberately trying to violate them, which is squarely a manual-testing and design-review exercise rather than an automatable one.

Real-World Impact

Real-World Impact

A business-logic or secure-design flaw abuses the legitimate, intended workflow of an application in a way its designers didn't anticipate, without tripping any conventional technical control — no injection, no broken access control in the classic sense, just the rules of the workflow itself being incomplete. Applying the same one-time discount code twice by reordering checkout steps, skipping a required approval stage by calling a later endpoint directly, or manipulating a multi-step form to submit a lower price than the UI ever actually offered are all textbook examples.

Because these flaws violate rules that are specific to the application rather than a generic technical pattern, the impact is directly tied to what the workflow controls — a flaw in a checkout flow means direct financial loss, a flaw in an approval workflow means bypassed governance, a flaw in a matching or allocation system means unfair or exploitable outcomes for other users.

This category also tends to be undervalued by purely technical security reviews, since the code involved is often working exactly as written — the defect is in what was written, not how it was implemented, which means it requires someone who understands the product's actual intent to recognize it as a bug at all.

Prevention & Remediation

Prevention and Secure Design

Preventing Inconsistency Between Implementation and Documented Design takes a defense-in-depth approach — no single control below is sufficient alone, but together they close off both the primary path and the most common bypasses.

Enforce every business invariant server-side, explicitly. A rule like "a discount code can only be used once" needs to be checked and enforced by server-side state, not implied by the order the UI happens to present steps in.

Threat-model the workflow during design, not after launch. Walk through each multi-step flow asking "what happens if a user calls these steps out of order, repeats one, or skips one" as part of design review, before it ships.

Treat every endpoint as independently reachable. Never assume a step will only be called in the sequence the UI presents — an attacker can and will call any endpoint directly, in any order, with any parameters.

Log and monitor for logic-level anomalies, not just technical attack signatures. A traditional WAF or scanner won't catch a legitimate-looking request that violates a business rule — that requires monitoring built around the specific invariants that matter to the product.

Test with someone who knows the product's intent, not just its code. A tester who understands what the workflow is supposed to prevent can deliberately try to break those specific assumptions in a way a generic technical review won't.

Frequently Asked Questions

What is Inconsistency Between Implementation and Documented Design?
The actual running application doesn't match what its own design documentation, API specification, or security model claims it does - a documented access-control rule that the code doesn't actually enforce, or an API contract that the implementation silently deviates from in a security-relevant way.
How common is Inconsistency Between Implementation and Documented Design in bug bounty reports?
Scanrub's research corpus for this playbook is built from 1 disclosed HackerOne report in this category, synthesized for detection and prevention guidance rather than reproduced verbatim.
Can Inconsistency Between Implementation and Documented Design be found with an automated scanner?
Not reliably on its own — this class typically requires the kind of review described in "Where This Is Actually Caught" above (code-level review, fuzzing, red-teaming, or design review, depending on the specific mechanism), rather than an HTTP-level black-box scan.
What is the single most effective fix for Inconsistency Between Implementation and Documented Design?
Enforce every business invariant explicitly in server-side state — never rely on the UI's step order or client behavior to prevent a rule from being violated.
Weekly security research

New vulnerability playbooks, tool updates, and bug bounty insights - delivered to your inbox. No spam.

Unsubscribe anytime. We respect your inbox.
Press ⌘K to search×