Skip to content

API security

API HTTP methods: check authorization and unsupported actions

Review API method handling and alternate routes to verify only intended operations are enabled and authorized.

By BugSnaps · Updated

Add BugSnaps as a preferred source on Google(opens in a new tab)

Want more of our security guides? Select BugSnaps and confirm your choice on Google.

Direct answer

Each API operation needs an explicit method and authorization policy. Test supported and unsupported methods on a disposable resource without assuming a route's path alone defines its security boundary.

Document operations and roles

List routes, expected methods and permitted roles from the API specification and owner. Choose a test record whose state can be inspected and restored, and identify whether any framework or proxy supports a method override mechanism.

Reference: OWASP REST Security Cheat Sheet.

Compare controlled methods

Perform a valid read as a positive control and, with explicit permission, request an unsupported or restricted method against the disposable record. Inspect the result and actual state. Avoid sending destructive operations to production resources.

  • Record the path, method, identity and expected response.
  • Test override headers only if agreed and supported.
  • Include alternate versions or proxy paths within scope.

Interpret gateway and application results

A method may be blocked at a gateway but accepted through another route. Check the intended deployment path and application enforcement. A 405 or 403 response is useful evidence, but confirm no asynchronous job or partial mutation occurred.

Retest permitted operations

After changes, repeat the denied method and verify required operations still work for authorized users. Update the API specification and regression tests to reflect the actual contract. Record the deployment path and identity used for each result.

Assessment limits

A small method sample does not enumerate every endpoint or hidden action. Some methods have side effects; test only approved routes and fixtures.

Frequently asked questions

Does hiding a route from documentation disable it?

No. Verify the deployed gateway and application behavior; an undocumented operation may remain reachable.

Is a rejected request enough to establish no change occurred?

Check the test object's state and any queued job, especially for operations that process work asynchronously.

Primary sources and further reading

These guides combine published security guidance with practical assessment planning. Adapt checks to the owner's policy, environment, and authorized scope.

This guide was prepared with AI assistance using the linked sources and illustrative examples. Check current vendor guidance and your environment before making changes.

Apply the guide to your own assessment.

Start with an authorized target, known test data, and a clear scope. Use the report's evidence and coverage limits to decide which checks need further review.

Open MyPentest