百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
O

openapi-fuzzer

> 编程语言
开源

基于 OpenAPI 规范的黑盒扫描器,可扫描 API 以查找错误。免费使用!

576 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

基于 OpenAPI 规范的黑盒扫描器,可扫描 API 以查找错误。免费使用!

OpenAPI fuzzer

Black-box fuzzer that fuzzes APIs based on OpenAPI specification. All you need to do is to supply URL of the API and its specification. Find bugs for free!

Findings

The fuzzer has been used to find bugs in numerous software. Some of the well-known fuzzed software include[^1]:

Kubernetes

  • kubenetes#101350
  • kubenetes#101348
  • kubenetes#101355

Gitea

  • gitea#15357
  • gitea#15356
  • gitea#15346

Vault

  • vault#11310
  • vault#11311
  • vault#11313

The category of bugs differ, but some of the common are parsing bugs, invalid format bugs and querying non-existent entities. If you have found bugs with this fuzzer, please reach out to me. I would love to hear from you. Feel free to submit a PR and add your finding to the list above.

Building & installing

From crates.io

To build the fuzzer, you will need to have rust installed.

bash
cargo install openapi-fuzzer

From source

bash
git clone [email protected]:matusf/openapi-fuzzer.git
cd openapi-fuzzer

# Install to the $PATH
cargo install --path .

# Or build inside the repo
cargo build --release

Using containers

bash
podman pull ghcr.io/matusf/openapi-fuzzer

Usage

After installation you will have the openapi-fuzzer binary available to you, which offers two subcommands - run and resend. The run subcommand will fuzz the API according to the specification and report any findings. All findings will be stored in a JSON format in a results directory (the name of the directory can be specified by --results-dir flag).

If the fuzzer finds a bug it will save the seed that leads to the generation of the payload triggering the bug. Those seeds are saved in a regressions file called openapi-fuzzer.regressions. The seeds will be used in the next runs of the fuzzer to check if the bug persists. You shall save it alongside your project.

When you are done with fuzzing, you can use openapi-fuzzer resend to resend payloads that triggered bugs and examine the cause in depth.

OpenAPI fuzzer supports version 3 of the OpenAPI specification in YAML or JSON format. You can convert older versions at editor.swagger.io.

Tips

  • When the fuzzer receives an unexpected status code, it will report it as a finding. However, many APIs do not specify client error status codes in the specification. To minimize false positive findings ignore status codes that you are not interested in with -i flag. It is advised to fuzz it in two stages. Firstly, run the fuzzer without -i flag. Then check the results folder for the reported findings. If there are reports from status codes you do not care about, add them via -i flag and rerun the fuzzer.
  • Most APIs use some base prefix for endpoints like /v1 or /api, however, the specifications are sometimes written without it. Do not forget to include the path prefix in the url.
  • You may add an extra header with -H flag. It may be useful when you would like to increase coverage by providing some sort of authorization. You can use the -H flag to add cookies too. e.g. -H "Cookie: A=1;". Use a single -H flag when adding multiple cookies as well. e.g. -H "Cookie: A=1; B=2; C=3;".
  • Currently, the fuzzer makes 256 requests per endpoint. If all received responses are expected, it declares the endpoint as ok and continues to fuzz the next one. You can adjust this number by setting a --max-test-case-count flag.
  • To disable the verification of TLS certificates and thus use, for example, self-signed certificates, you can use the --skip-tls-verify flag.
  • By default, the fuzzer uses rate limiting. If it receives an HTTP status code of 429 or 503, it will wait for a number of seconds specified by the Retry-After header. If the header is not present, it will use an exponential backoff algorithm with a starting value of 1 second. After 10 unsuccessful retries, fuzzing of the endpoint is aborted.
…

Replaying findings

When you are done fuzzing you can replay the findings. All findings are stored in the results folder. Name of each file consists of concatenated endpoint, HTTP method and received status code. To resend the same payload to API, you need to run openapi-fuzzer resend and specify a path to the finding file as an argument and a url of the api. You can overwrite the headers with -H flag as well, which is useful, when you need authorization.

…

[^1]: not all found bugs are linked

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustfuzzerfuzzingopenapirust

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言