A Go library which main purpose is giving an interface to loop over a dictionary and use those words/lines as input for some custom logic such as HTTP file bruteforcing, DNS bruteforcing, etc.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
LICENSE
README.md
line_reader.go
line_reader_test.go
machine.go

README.md

BruteMachine

This is a Go library which main purpose is giving an interface to loop over a dictionary and use those words/lines as input for some custom logic such as HTTP file bruteforcing, DNS bruteforcing, etc. Brute-Machine will take care of parallelism, job dispatching and so on, allowing you to focus on what matters most, the actual logic of your software.

baby-gopher

Example

The following is an example of how to use brutemachine to perform HTTP files bruteforcing.

package main

import (
    "fmt"
    "net/http"
    "strings"

    "github.com/evilsocket/brutemachine"
)

const base = "http://some-url.com/"

func DoRequest(page string) interface{} {
    url := strings.Replace(fmt.Sprintf("%s%s", base, page), "%EXT%", "php", -1)
    resp, err := http.Head(url)
    // Only pass valid responses to the handler.
    if err == nil && resp.StatusCode == 200 {
        return url
    }

    return nil
}

func OnResult(res interface{}) {
    fmt.Printf("@ Found '%s'\n", res)
}

func main() {
    m := brutemachine.New( -1, "dictionary.txt", DoRequest, OnResult)
    if err := m.Start(); err != nil {
        panic(err)
    }

    m.Wait()

    fmt.Printf("\nDONE:\n")
    fmt.Printf("%+v\n", m.Stats)
}

Installation

go get github.com/evilsocket/brutemachine

License

This project is copyleft of Simone Margaritelli and released under the GPL 3 license.