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:

Flag	Description	Default
-e/--endpoint	ngrok tunnel endpoint ("http" or "tcp")	"http"
-t/--token	ngrok authentication token	""
--unstrip	Unstrip X-Forwarded-{For,Host,Proto} headers	false
-o/--output	Log incoming requests to a file instead of stdout	""

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.