tls_client_cffi_src

Documentation

Overview

tls_client_cffi_src provides and manages a CFFI (C Foreign Function Interface) which allows code in other languages to interact with the module.

Index

• func BuildResponse(sessionId string, withSession bool, resp *http.Response, ...) (Response, *TLSClientError)
• func ClearSessionCache()
• func GetClient(sessionId string) (tls_client.HttpClient, error)
• func RemoveSession(sessionId string)
• type AddCookiesToSessionInput
• type CandidateCipherSuite
• type CandidateCipherSuites
  • func (c CandidateCipherSuites) Translate() []tls_client.CandidateCipherSuites
• type Cookie
• type CookiesFromSessionOutput
• type CustomTlsClient
• type DestroyOutput
• type DestroySessionInput
• type GetCookiesFromSessionInput
• type PriorityFrames
• type PriorityParam
• type RequestInput
• type Response
• type TLSClientError
  • func BuildRequest(input RequestInput) (*http.Request, *TLSClientError)
  • func CreateClient(requestInput RequestInput) (client tls_client.HttpClient, sessionID string, withSession bool, ...)
  • func NewTLSClientError(err error) *TLSClientError
  • func (e *TLSClientError) Error() string
• type Timestamp
  • func (p *Timestamp) MarshalJSON() ([]byte, error)
  • func (p *Timestamp) UnmarshalJSON(bytes []byte) error
• type TransportOptions

Functions

func BuildResponse

func BuildResponse(sessionId string, withSession bool, resp *http.Response, cookies []*http.Cookie, input RequestInput) (Response, *TLSClientError)

BuildResponse constructs a client response from a given HTTP response. The client response can then be sent to the interface consumer.

func ClearSessionCache

func ClearSessionCache()

ClearSessionCache empties the client session storage.

func GetClient

func GetClient(sessionId string) (tls_client.HttpClient, error)

GetClient returns the client with the given sessionId from the client session storage. If there is no client with the given sessionId, it returns an error.

func RemoveSession

func RemoveSession(sessionId string)

RemoveSession deletes the client with the given sessionId from the client session storage.

Types

type AddCookiesToSessionInput

type AddCookiesToSessionInput struct {
	Cookies   []Cookie `json:"cookies"`
	SessionId string   `json:"sessionId"`
	Url       string   `json:"url"`
}

type CandidateCipherSuite

type CandidateCipherSuite struct {
	KdfId  string `json:"kdfId"`
	AeadId string `json:"aeadId"`
}

type CandidateCipherSuites

type CandidateCipherSuites []CandidateCipherSuite

func (CandidateCipherSuites) Translate

func (c CandidateCipherSuites) Translate() []tls_client.CandidateCipherSuites

type Cookie

type Cookie struct {
	Domain  string    `json:"domain"`
	Expires Timestamp `json:"expires"`
	MaxAge  int       `json:"maxAge"`
	Name    string    `json:"name"`
	Path    string    `json:"path"`
	Value   string    `json:"value"`
}

type CookiesFromSessionOutput

type CookiesFromSessionOutput struct {
	Id      string   `json:"id"`
	Cookies []Cookie `json:"cookies"`
}

type CustomTlsClient

type CustomTlsClient struct {
	CertCompressionAlgo                     string                `json:"certCompressionAlgo"`
	ConnectionFlow                          uint32                `json:"connectionFlow"`
	H2Settings                              map[string]uint32     `json:"h2Settings"`
	H2SettingsOrder                         []string              `json:"h2SettingsOrder"`
	HeaderPriority                          *PriorityParam        `json:"headerPriority"`
	Ja3String                               string                `json:"ja3String"`
	KeyShareCurves                          []string              `json:"keyShareCurves"`
	ALPNProtocols                           []string              `json:"alpnProtocols"`
	ALPSProtocols                           []string              `json:"alpsProtocols"`
	ECHCandidatePayloads                    []uint16              `json:"ECHCandidatePayloads"`
	ECHCandidateCipherSuites                CandidateCipherSuites `json:"ECHCandidateCipherSuites"`
	PriorityFrames                          []PriorityFrames      `json:"priorityFrames"`
	PseudoHeaderOrder                       []string              `json:"pseudoHeaderOrder"`
	SupportedDelegatedCredentialsAlgorithms []string              `json:"supportedDelegatedCredentialsAlgorithms"`
	SupportedSignatureAlgorithms            []string              `json:"supportedSignatureAlgorithms"`
	SupportedVersions                       []string              `json:"supportedVersions"`
}

CustomTlsClient contains custom TLS specifications to construct a client from.

type DestroyOutput

type DestroyOutput struct {
	Id      string `json:"id"`
	Success bool   `json:"success"`
}

type DestroySessionInput

type DestroySessionInput struct {
	SessionId string `json:"sessionId"`
}

type GetCookiesFromSessionInput

type GetCookiesFromSessionInput struct {
	SessionId string `json:"sessionId"`
	Url       string `json:"url"`
}

type PriorityFrames

type PriorityFrames struct {
	PriorityParam PriorityParam `json:"priorityParam"`
	StreamID      uint32        `json:"streamID"`
}

type PriorityParam

type PriorityParam struct {
	Exclusive bool   `json:"exclusive"`
	StreamDep uint32 `json:"streamDep"`
	Weight    uint8  `json:"weight"`
}

type RequestInput

type RequestInput struct {
	CatchPanics                 bool                `json:"catchPanics"`
	CertificatePinningHosts     map[string][]string `json:"certificatePinningHosts"`
	CustomTlsClient             *CustomTlsClient    `json:"customTlsClient"`
	TransportOptions            *TransportOptions   `json:"transportOptions"`
	FollowRedirects             bool                `json:"followRedirects"`
	ForceHttp1                  bool                `json:"forceHttp1"`
	HeaderOrder                 []string            `json:"headerOrder"`
	Headers                     map[string]string   `json:"headers"`
	DefaultHeaders              map[string][]string `json:"defaultHeaders"`
	InsecureSkipVerify          bool                `json:"insecureSkipVerify"`
	IsByteRequest               bool                `json:"isByteRequest"`
	IsByteResponse              bool                `json:"isByteResponse"`
	IsRotatingProxy             bool                `json:"isRotatingProxy"`
	DisableIPV6                 bool                `json:"disableIPV6"`
	DisableIPV4                 bool                `json:"disableIPV4"`
	LocalAddress                *string             `json:"localAddress"`
	ServerNameOverwrite         *string             `json:"serverNameOverwrite"`
	ProxyUrl                    *string             `json:"proxyUrl"`
	RequestBody                 *string             `json:"requestBody"`
	RequestCookies              []Cookie            `json:"requestCookies"`
	RequestMethod               string              `json:"requestMethod"`
	RequestUrl                  string              `json:"requestUrl"`
	RequestHostOverride         *string             `json:"requestHostOverride"`
	SessionId                   *string             `json:"sessionId"`
	StreamOutputBlockSize       *int                `json:"streamOutputBlockSize"`
	StreamOutputEOFSymbol       *string             `json:"streamOutputEOFSymbol"`
	StreamOutputPath            *string             `json:"streamOutputPath"`
	TimeoutMilliseconds         int                 `json:"timeoutMilliseconds"`
	TimeoutSeconds              int                 `json:"timeoutSeconds"`
	TLSClientIdentifier         string              `json:"tlsClientIdentifier"`
	WithDebug                   bool                `json:"withDebug"`
	WithDefaultCookieJar        bool                `json:"withDefaultCookieJar"`
	WithoutCookieJar            bool                `json:"withoutCookieJar"`
	WithRandomTLSExtensionOrder bool                `json:"withRandomTLSExtensionOrder"`
}

RequestInput is the data a Python client can construct a client and request from.

type Response

type Response struct {
	Id           string              `json:"id"`
	Body         string              `json:"body"`
	Cookies      map[string]string   `json:"cookies"`
	Headers      map[string][]string `json:"headers"`
	SessionId    string              `json:"sessionId,omitempty"`
	Status       int                 `json:"status"`
	Target       string              `json:"target"`
	UsedProtocol string              `json:"usedProtocol"`
}

Response is the response that is sent back to the Python client.

type TLSClientError

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

func BuildRequest

func BuildRequest(input RequestInput) (*http.Request, *TLSClientError)

BuildRequest constructs a HTTP request from a given RequestInput.

func CreateClient

func CreateClient(requestInput RequestInput) (client tls_client.HttpClient, sessionID string, withSession bool, clientErr *TLSClientError)

CreateClient creates a new client from a given RequestInput.

The RequestInput should only contain a TLSClientIdentifier or a CustomTlsClient. If both are provided, an error will be returned.

func NewTLSClientError

func NewTLSClientError(err error) *TLSClientError

func (*TLSClientError) Error

func (e *TLSClientError) Error() string

type Timestamp

type Timestamp struct {
	time.Time
}

func (*Timestamp) MarshalJSON

func (p *Timestamp) MarshalJSON() ([]byte, error)

func (*Timestamp) UnmarshalJSON

func (p *Timestamp) UnmarshalJSON(bytes []byte) error

type TransportOptions

type TransportOptions struct {
	DisableKeepAlives      bool  `json:"disableKeepAlives"`
	DisableCompression     bool  `json:"disableCompression"`
	MaxIdleConns           int   `json:"maxIdleConns"`
	MaxIdleConnsPerHost    int   `json:"maxIdleConnsPerHost"`
	MaxConnsPerHost        int   `json:"maxConnsPerHost"`
	MaxResponseHeaderBytes int64 `json:"maxResponseHeaderBytes"` // Zero means to use a default limit.
	WriteBufferSize        int   `json:"writeBufferSize"`        // If zero, a default (currently 4KB) is used.
	ReadBufferSize         int   `json:"readBufferSize"`         // If zero, a default (currently 4KB) is used.
	// IdleConnTimeout is the maximum amount of time an idle (keep-alive)
	// connection will remain idle before closing itself. Zero means no limit.
	IdleConnTimeout *time.Duration `json:"idleConnTimeout"`
}

TransportOptions contains settings for the underlying http transport of the tls client