ngocok

ngrok Collaborator Link — yet another Burp Collaborator alternative for free with ngrok.

Prerequisites

• ngrok authtoken: Authentication token from your ngrok account is required to establish a ngrok tunnel. See Your Authtoken.

[!IMPORTANT] If ngrok is already configured on your machine with ngrok config add-authtoken, you can go ahead to the installation section.

[!TIP] To find the location of the configuration file, execute ngrok config check or consult the ngrok Agent Configuration File documentation page.

That's it!

Installation

[!NOTE] Go version 1.20+ should be installed & configured.

$ go install github.com/dwisiswant0/ngocok@latest

— or

Manually build the executable from the source:

$ git clone https://github.com/dwisiswant0/ngocok ngocok/
$ cd $_
$ go build . # or
$ go install .

Usage

It's quite straightforward. Simply execute ngocok, and you're ready to capture the out-of-band requests!

Here are the supported options:

[!CAUTION] Using a -t/--token flag will takes precedence over the NGROK_AUTHTOKEN environment variable, and using NGROK_AUTHTOKEN environment variable will takes precedence over the ngrok config file^[?].

Examples

Start a tunnel with default endpoint (HTTP) and use the ngrok authentication token from the config file.

$ ngocok

Start a tunnel with a TCP endpoint.

$ ngocok --endpoint tcp

Start a tunnel with an HTTP endpoint and provide the ngrok authentication token using the -t/--token flag.

$ ngocok --token [authtoken]

Start a tunnel with an HTTP endpoint and use the ngrok authentication token from the NGROK_AUTHTOKEN environment variable.

$ NGROK_AUTHTOKEN="..." ngocok

Start a tunnel with an HTTP endpoint and log incoming requests to a file.

$ ngocok --output /path/to/requests.log

Why is this name?

Similar Projects

• projectdiscovery/interactsh: An OOB interaction gathering server and client library.

License

ngocok is made with ♥ by @dwisiswant0 under MIT license. See LICENSE.