Why Go
- Case Studies
  
  Common problems companies solve with Go
- Use Cases
  
  Stories about how and why companies use Go
- Security Policy
  
  How Go can help keep you secure by default
Learn
Docs
- Effective Go
  
  Tips for writing clear, performant, and idiomatic Go code
- Go User Manual
  
  A complete introduction to building software with Go
- Standard library
  
  Reference documentation for Go's standard library
- Release Notes
  
  Learn what's new in each Go release
Packages
Community
- Recorded Talks
  
  Videos from prior events
- Meetups
  
  Meet other local Go developers
- Conferences
  
  Learn and network with Go developers from around the world
- Go blog
  
  The Go project's official blog.
- Go project
  
  Get help and stay informed from Go
- Get connected

tls_client

package module

Go to main page

Versions in this module

v1

v1.0.13

Feb 10, 2025

v1.0.12

Feb 8, 2025

v1.0.11

Feb 7, 2025

v1.0.10

Feb 7, 2025

v1.0.9

Feb 7, 2025

v1.0.8

Feb 6, 2025

v1.0.7

Feb 6, 2025

v1.0.6

Feb 6, 2025

v1.0.5

Feb 6, 2025

v1.0.4

Feb 6, 2025

v1.0.3

Feb 6, 2025

v1.0.2

Feb 6, 2025

v1.0.1

Feb 6, 2025

v1.0.0

Feb 6, 2025

Changes in this version

+ var DefaultBadPinHandler = func(req *http.Request)

+ var DefaultOptions = []HttpClientOption

+ var DefaultTimeoutSeconds = 30

+ var ErrBadPinDetected = errors.New("bad ssl pin detected")

+ var H2SettingsMap = map[string]http2.SettingID

+ func GetSpecFactoryFromJa3String(ja3String string, ...) (func() (tls.ClientHelloSpec, error), error)

+ type BadPinHandlerFunc func(req *http.Request)

+ type CandidateCipherSuites struct

+ AeadId string

+ KdfId string

+ type CertificatePinner interface

+ Pin func(conn *tls.UConn, host string) error

+ func NewCertificatePinner(certificatePins map[string][]string) (CertificatePinner, error)

+ type ContextKeyHeader struct

+ type CookieJar interface

+ GetAllCookies func() map[string][]*http.Cookie

+ func NewCookieJar(options ...CookieJarOption) CookieJar

+ type CookieJarOption func(config *cookieJarConfig)

+ func WithAllowEmptyCookies() CookieJarOption

+ func WithDebugLogger() CookieJarOption

+ func WithLogger(logger Logger) CookieJarOption

+ func WithSkipExisting() CookieJarOption

+ type HttpClient interface

+ CloseIdleConnections func()

+ Do func(req *http.Request) (*http.Response, error)

+ Get func(url string) (resp *http.Response, err error)

+ GetBandwidthTracker func() bandwidth.BandwidthTracker

+ GetCookieJar func() http.CookieJar

+ GetCookies func(u *url.URL) []*http.Cookie

+ GetFollowRedirect func() bool

+ GetProxy func() string

+ Head func(url string) (resp *http.Response, err error)

+ Post func(url, contentType string, body io.Reader) (resp *http.Response, err error)

+ SetCookieJar func(jar http.CookieJar)

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

+ SetFollowRedirect func(followRedirect bool)

+ SetProxy func(proxyUrl string) error

+ func NewHttpClient(logger Logger, options ...HttpClientOption) (HttpClient, error)

+ func ProvideDefaultClient(logger Logger) (HttpClient, error)

+ type HttpClientOption func(config *httpClientConfig)

+ func WithBandwidthTracker() HttpClientOption

+ func WithCatchPanics() HttpClientOption

+ func WithCertificatePinning(certificatePins map[string][]string, handlerFunc BadPinHandlerFunc) HttpClientOption

+ func WithCharlesProxy(host string, port string) HttpClientOption

+ func WithClientProfile(clientProfile profiles.ClientProfile) HttpClientOption

+ func WithConnectHeaders(headers http.Header) HttpClientOption

+ func WithCookieJar(jar http.CookieJar) HttpClientOption

+ func WithCustomRedirectFunc(redirectFunc func(req *http.Request, via []*http.Request) error) HttpClientOption

+ func WithDebug() HttpClientOption

+ func WithDefaultHeaders(defaultHeaders http.Header) HttpClientOption

+ func WithDialer(dialer net.Dialer) HttpClientOption

+ func WithDisableIPV4() HttpClientOption

+ func WithDisableIPV6() HttpClientOption

+ func WithForceHttp1() HttpClientOption

+ func WithInsecureSkipVerify() HttpClientOption

+ func WithLocalAddr(localAddr net.TCPAddr) HttpClientOption

+ func WithNotFollowRedirects() HttpClientOption

+ func WithProxyUrl(proxyUrl string) HttpClientOption

+ func WithRandomTLSExtensionOrder() HttpClientOption

+ func WithServerNameOverwrite(serverName string) HttpClientOption

+ func WithTimeout(timeout int) HttpClientOption

+ func WithTimeoutMilliseconds(timeout int) HttpClientOption

+ func WithTimeoutSeconds(timeout int) HttpClientOption

+ func WithTransportOptions(transportOptions *TransportOptions) HttpClientOption

+ type Logger interface

+ Debug func(format string, args ...any)

+ Error func(format string, args ...any)

+ Info func(format string, args ...any)

+ Warn func(format string, args ...any)

+ func NewDebugLogger(logger Logger) Logger

+ func NewLogger() Logger

+ func NewNoopLogger() Logger

+ type TransportOptions struct

+ DisableCompression bool

+ DisableKeepAlives bool

+ IdleConnTimeout *time.Duration

+ KeyLogWriter io.Writer

+ MaxConnsPerHost int

+ MaxIdleConns int

+ MaxIdleConnsPerHost int

+ MaxResponseHeaderBytes int64

+ ReadBufferSize int

+ RootCAs *x509.CertPool

+ WriteBufferSize int