GoSurp is a cli tool to work on email and DNS usurpation. It is written in Go and is distributed as a single binary without any external dependencies.

How • Install • Documentation •

How to use

gosurp -h

This will display help for the tool. Here are all the switches it supports.

Inspect DNS Record

First of all, Gosurp allow you to inpect DNS records.

gosurp inspect domain <yourdomain.com>

You can also look for specific DNS records using:

gosurp inspect (spf/dkim/dmarc) <yourdomain.com>

Email usurpation

First of all, to allow you working on building the good mail without sending it, you can use the following command to start a local SMTP server that will print the mail content in the console like a debugger.

gosurp smtp listen -vvv
# or
gosurp smtp listen --hostname localhost --port 2525 -vvv

Then, you can use the following command to send a mail using the local SMTP server.

gosurp smtp send -vvv --from [email protected] --to victim@localhost --port 2525

You can find some complete recipes in the documentation.

Install

If you have a Go environment ready to go (at least go 1.19), it's as easy as:

go install github.com/LeoFVO/gosurp@latest

PS: You need at least go 1.19 to compile gosurp.

Docker

```bash docker pull ghcr.io/leofvo/gosurp:latest docker run gosurp:latest ```

Binary Releases

We are now shipping binaries for each of the releases so that you don't even have to build them yourself! How wonderful is that!

If you're stupid enough to trust binaries that I've put together, you can download them from the releases page.

Build from source

Prerequisites

Since this tool is written in Go you need to install the Go language/compiler/etc. Full details of installation and set up can be found on the Go language website. Once installed you have two options. You need at least go 1.19 to compile gosurp.

Clone the repository

git clone [email protected]:LeoFVO/gosurp.git

Compiling

gosurp has external dependencies, and so they need to be pulled in first:

go get && go build

This will create a gosurp binary for you. If you want to install it in the $GOPATH/bin folder you can run:

go install

Setup

Documentation

The documentation is available at https://leofvo.github.io/gosurp/.

In order to deploy documentation for your project, you need to allow github actions to deploy github pages. To do so, go to your repository settings > Pages, and in the Build and deployment section, select Github Actions as the source.

License

gosurp is distributed under MIT License