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@latest
Manually 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.
$ 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
- projectdiscovery/interactsh: An OOB interaction gathering server and client library.
ngocok
is made with ♥ by @dwisiswant0 under MIT license. See LICENSE.