ngrok Collaborator Link — yet another Burp Collaborator alternative for free with ngrok.
- 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!
Note
Go version 1.20+ should be installed & configured.
$ go install github.com/dwisiswant0/ngocok@latestManually build the executable from the source:
$ git clone https://github.com/dwisiswant0/ngocok ngocok/
$ cd $_
$ go build . # or
$ go install .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[?].
Start a tunnel with default endpoint (HTTP) and use the ngrok authentication token from the config file.
$ ngocokStart a tunnel with a TCP endpoint.
$ ngocok --endpoint tcpStart 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="..." ngocokStart a tunnel with an HTTP endpoint and log incoming requests to a file.
$ ngocok --output /path/to/requests.log- projectdiscovery/interactsh: An OOB interaction gathering server and client library.
ngocok is made with ♥ by @dwisiswant0 under MIT license. See LICENSE.
