Skip to content
/ wiretap Public

The world's coolest API Validation and compliance tool. Validate APIs against OpenAPI specifications and much more

License

Notifications You must be signed in to change notification settings

pb33f/wiretap

This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

99b7498 Β· Jul 11, 2024
Nov 18, 2023
Jul 28, 2023
Jul 4, 2024
Jul 11, 2024
Aug 24, 2023
Jun 26, 2024
Jan 13, 2024
Jun 14, 2024
Jul 28, 2023
Aug 24, 2023
Jun 21, 2024
Aug 24, 2023
May 12, 2024
Sep 2, 2023
Jun 4, 2023
Mar 11, 2024
Jul 23, 2023
Nov 18, 2023
Aug 23, 2023
Jun 2, 2023
Apr 17, 2024
Jun 21, 2024
Jun 21, 2024
Jun 4, 2023
Jan 13, 2024
Aug 24, 2023

Repository files navigation

wiretap

logo

discord GitHub downloads npm Docker Pulls

A local and pipeline based tool to sniff API request and responses from clients and servers to detect OpenAPI contract violations and compliance.

A shift left tool, for those who want to know if their applications are actually compliant with an API.

This is an early tool and in active development, Why not try it out and give us some feedback?


Read the quickstart guide

πŸš€ Quick Start Guide πŸš€


Install wiretap for your platform

Installing using homebrew

The easiest way to install wiretap is to use homebrew if you're on OSX or Linux.

We have our own tap available that gives the latest and greatest version.

brew install pb33f/taps/wiretap

Installing using npm or yarn

Building a JavaScript / TypeScript application? No problem, grab your copy of wiretap using your preference of yarn or npm.

yarn add global @pb33f/wiretap

or...

npm -i -g @pb33f/wiretap

Installing using cURL

Do you want to use wiretap in a linux only or CI/CD pipeline or workflow? Or you don't want to/can't use a package manager like brew?

No problem. Use cURL to download and run our installer script.

curl -fsSL https://pb33f.io/wiretap/install.sh | sh

Installing/running using Docker

Love containers? Don't want to install anything? No problem, use our Docker image.

docker pull pb33f/wiretap
docker run -p 9090:9090 -p 9091:9091 -p 9092:9092 --rm -v  \
    $PWD:/work:rw pb33f/wiretap -u https://somehostoutthere.com

We enable the following default ports 9090, 9091, and 9092 for the daemon, monitor, and websockets used by ranch respectively.


Installing on Windows

To grab your copy of wiretap for Windows, you can pull it from the latest releases on github and download the Windows version for your CPU type.


Running wiretap

To get up and running with the absolute defaults (which is to sniff all traffic on port 9090) and proxy to https://api.pb33f.com you can run the following command.

wiretap -u https://api.pb33f.com

Adding an OpenAPI contract

wiretap -u https://api.pb33f.com -s my-openapi-spec.yaml

Documentation