metadata

Documentation

Overview

Package `metadata` has a struct that stores information captured by `proxyserver`. Package `fingerprint` uses these information to create fingerprints.

Index

• Variables
• type HTTP2FingerprintingFrames
  • func (f *HTTP2FingerprintingFrames) Marshal(maxPriorityFrames uint) string
  • func (f *HTTP2FingerprintingFrames) String() string
• type HeaderField
• type Metadata
  • func FromContext(ctx context.Context) (*Metadata, bool)
  • func NewContext(ctx context.Context) (context.Context, *Metadata)
• type Priority
• type Setting

Variables

var (
	FingerproxyContextKey = &contextKey{"fingerproxy-metadata"}
)

Types

type HTTP2FingerprintingFrames

type HTTP2FingerprintingFrames struct {
	// Data from SETTINGS frame
	Settings []Setting

	// Increment of WINDOW_UPDATE frame
	WindowUpdateIncrement uint32

	// PRIORITY frame(s)
	Priorities []Priority

	// HEADERS frame
	Headers []HeaderField
}

func (*HTTP2FingerprintingFrames) Marshal

func (f *HTTP2FingerprintingFrames) Marshal(maxPriorityFrames uint) string

TODO: add tests

func (*HTTP2FingerprintingFrames) String

func (f *HTTP2FingerprintingFrames) String() string

type HeaderField

type HeaderField struct {
	Name, Value string
	Sensitive   bool
}

https://github.com/golang/net/blob/5a444b4f2fe893ea00f0376da46aa5376c3f3e28/http2/hpack/hpack.go#L36-L42

type Metadata

type Metadata struct {
	// ClientHelloRecord is the raw TLS ClientHello bytes that
	// include TLS record header and handshake header
	ClientHelloRecord []byte

	// ConnectionState represents the TLS connection state
	ConnectionState tls.ConnectionState

	// HTTP2Frames includes certain HTTP2 frames data
	HTTP2Frames HTTP2FingerprintingFrames
}

Metadata is the data we captured from the connection for fingerprinting. Currently only TLS ClientHello and certain HTTP2 frames included, more can be added in the future.

func FromContext

func FromContext(ctx context.Context) (*Metadata, bool)

func NewContext

func NewContext(ctx context.Context) (context.Context, *Metadata)

type Priority

type Priority struct {
	StreamId  uint32
	StreamDep uint32
	Exclusive bool
	Weight    uint8
}

https://github.com/golang/net/blob/5a444b4f2fe893ea00f0376da46aa5376c3f3e28/http2/frame.go#L1142-L1156

type Setting

type Setting struct {
	Id  uint16
	Val uint32
}

https://github.com/golang/net/blob/5a444b4f2fe893ea00f0376da46aa5376c3f3e28/http2/http2.go#L112-L119