sniffer

README

httpsniffer

A work-in-progress framework to build HTTP-based sniffers in an easy way. Just register your handlers and it handles everything for you as simple as creating an HTTP Server.

It builds on the battle-hardened gopacket, and it adds support for parsing HTTP requests and responses using net/http.

NOTE: the API is still under heavy development, therefore subject to substantial changes.

Quick Example

func main() {
    device := "eth0"
    port := 80
    sniffer := New(device, port)

    // you can register as many handlers you want
    // httpsniffer will chain the request through them in the order they were registered
    // the output of each handler will the input of the next handler
    sniffer.Register(func(txn *Transaction) (*Transaction, error) {
        fmt.Println(txn.Request)
        fmt.Println(txn.Response)
        return txn, nil
    })

    // starts the sniffing for HTTP request on device eth0 and port 80
    sniffer.Listen()
}

Documentation

Index

• Constants
• type ErrorHandler
• type HType
• type Listener
• type Map
  • func NewMap() *Map
  • func (m *Map) Add(key string, req *http.Request)
  • func (m *Map) Delete(key string)
  • func (m *Map) Get(key string) (*http.Request, bool)
• type Sniffer
  • func New(device string, port int) *Sniffer
  • func (s *Sniffer) Close()
  • func (s *Sniffer) Listen() error
  • func (s *Sniffer) Register(lsn Listener)
  • func (s *Sniffer) SetErrorHandler(eh ErrorHandler)
• type Transaction

Constants

const (
	DefaultDevice = "en0"
	DefaultPort   = 80
	SnapLen       = 1600
)

Types

type ErrorHandler

type ErrorHandler func(*Transaction, error)

type HType

type HType int

const (
	Req HType = iota
	Res
	Uknown
)

type Listener

type Listener func(txn *Transaction) (*Transaction, error)

type Map

type Map struct {
	sync.RWMutex
	// contains filtered or unexported fields
}

func NewMap

func NewMap() *Map

func (*Map) Add

func (m *Map) Add(key string, req *http.Request)

func (*Map) Delete

func (m *Map) Delete(key string)

func (*Map) Get

func (m *Map) Get(key string) (*http.Request, bool)

type Sniffer

type Sniffer struct {
	// contains filtered or unexported fields
}

func New

func New(device string, port int) *Sniffer

func (*Sniffer) Close

func (s *Sniffer) Close()

func (*Sniffer) Listen

func (s *Sniffer) Listen() error

func (*Sniffer) Register

func (s *Sniffer) Register(lsn Listener)

func (*Sniffer) SetErrorHandler

func (s *Sniffer) SetErrorHandler(eh ErrorHandler)

type Transaction

type Transaction struct {
	Request  *http.Request
	Response *http.Response
}