httpclient

Documentation

Index

• Variables
• func SetNonceQueryArgChars(queryArgs string)
• type HTTPDriver
  • func GetHTTPDriver(origin string, secure bool, opts *HTTPOptions) (HTTPDriver, error)
  • func GoHTTPDriver(origin string, secure bool, opts *HTTPOptions) (HTTPDriver, error)
• type HTTPOptions
  • func ParseHTTPOptions(c2URI *url.URL) *HTTPOptions
• type Jar
  • func NewJar() *Jar
  • func (jar *Jar) Cookies(u *url.URL) []*http.Cookie
  • func (jar *Jar) SetCookies(u *url.URL, cookies []*http.Cookie)
• type SliverHTTPClient
  • func HTTPStartSession(address string, pathPrefix string, opts *HTTPOptions) (*SliverHTTPClient, error)
  • func (s *SliverHTTPClient) CloseSession() error
  • func (s *SliverHTTPClient) DoPoll(req *http.Request) (*http.Response, []byte, error)
  • func (s *SliverHTTPClient) NonceQueryArgument(uri *url.URL, value uint64) *url.URL
  • func (s *SliverHTTPClient) OTPQueryArgument(uri *url.URL, value string) *url.URL
  • func (s *SliverHTTPClient) ReadEnvelope() (*pb.Envelope, error)
  • func (s *SliverHTTPClient) SessionInit() error
  • func (s *SliverHTTPClient) WriteEnvelope(envelope *pb.Envelope) error

Variables

var (
	NonceQueryArgChars = "{{.HTTPC2ImplantConfig.NonceQueryArgChars}}" // "abcdefghijklmnopqrstuvwxyz"

	ErrClosed                             = errors.New("http session closed")
	ErrStatusCodeUnexpected               = errors.New("unexpected http response code")
	TimeDelta               time.Duration = 0
)

Functions

func SetNonceQueryArgChars

func SetNonceQueryArgChars(queryArgs string)

{{if .Config.Debug}} -- UNIT TESTS ONLY

Types

type HTTPDriver

type HTTPDriver interface {
	Do(*http.Request) (*http.Response, error)
}

HTTPDriver - The interface to send/recv HTTP data

func GetHTTPDriver

func GetHTTPDriver(origin string, secure bool, opts *HTTPOptions) (HTTPDriver, error)

GetHTTPDriver - Get an instance of the specified HTTP driver

func GoHTTPDriver

func GoHTTPDriver(origin string, secure bool, opts *HTTPOptions) (HTTPDriver, error)

GoHTTPDriver - Pure Go HTTP driver

type HTTPOptions

type HTTPOptions struct {
	Driver               string
	NetTimeout           time.Duration
	TlsTimeout           time.Duration
	PollTimeout          time.Duration
	MaxErrors            int
	ForceHTTP            bool
	NoFallback           bool
	DisableUpgradeHeader bool
	HostHeader           string

	ProxyConfig   string
	ProxyUsername string
	ProxyPassword string
	AskProxyCreds bool
}

HTTPOptions - c2 specific configuration options

func ParseHTTPOptions

func ParseHTTPOptions(c2URI *url.URL) *HTTPOptions

ParseHTTPOptions - Parse c2 specific configuration options

type Jar

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

Jar - CookieJar implementation that ignores domains/origins

func NewJar

func NewJar() *Jar

NewJar - Get a new instance of a cookie jar

func (*Jar) Cookies

func (jar *Jar) Cookies(u *url.URL) []*http.Cookie

Cookies returns the cookies to send in a request for the given URL. It is up to the implementation to honor the standard cookie use restrictions such as in RFC 6265 (which we do not).

func (*Jar) SetCookies

func (jar *Jar) SetCookies(u *url.URL, cookies []*http.Cookie)

SetCookies handles the receipt of the cookies in a reply for the given URL (which is ignored).

type SliverHTTPClient

type SliverHTTPClient struct {
	Origin     string
	PathPrefix string

	ProxyURL   string
	SessionCtx *cryptography.CipherContext
	SessionID  string

	Closed bool

	Options *HTTPOptions
	// contains filtered or unexported fields
}

SliverHTTPClient - Helper struct to keep everything together

func HTTPStartSession

func HTTPStartSession(address string, pathPrefix string, opts *HTTPOptions) (*SliverHTTPClient, error)

HTTPStartSession - Attempts to start a session with a given address

func (*SliverHTTPClient) CloseSession

func (s *SliverHTTPClient) CloseSession() error

func (*SliverHTTPClient) DoPoll

func (s *SliverHTTPClient) DoPoll(req *http.Request) (*http.Response, []byte, error)

Do - Wraps http.Client.Do with a context

func (*SliverHTTPClient) NonceQueryArgument

func (s *SliverHTTPClient) NonceQueryArgument(uri *url.URL, value uint64) *url.URL

NonceQueryArgument - Adds a nonce query argument to the URL

func (*SliverHTTPClient) OTPQueryArgument

func (s *SliverHTTPClient) OTPQueryArgument(uri *url.URL, value string) *url.URL

OTPQueryArgument - Adds an OTP query argument to the URL

func (*SliverHTTPClient) ReadEnvelope

func (s *SliverHTTPClient) ReadEnvelope() (*pb.Envelope, error)

ReadEnvelope - Perform an HTTP GET request

func (*SliverHTTPClient) SessionInit

func (s *SliverHTTPClient) SessionInit() error

SessionInit - Initialize the session

func (*SliverHTTPClient) WriteEnvelope

func (s *SliverHTTPClient) WriteEnvelope(envelope *pb.Envelope) error

WriteEnvelope - Perform an HTTP POST request