Documentation ¶
Index ¶
- func AppendForwardedForHeader(req *http.Request)
- func CloneHeader(in http.Header) http.Header
- func CloneRequest(req *http.Request) *http.Request
- func ConnectWithRedirects(originalMethod string, originalLocation *url.URL, header http.Header, ...) (net.Conn, []byte, error)
- func FormatURL(scheme string, host string, port int, path string) *url.URL
- func GetClientIP(req *http.Request) net.IP
- func GetHTTPClient(req *http.Request) string
- func IsProbableEOF(err error) bool
- func JoinPreservingTrailingSlash(elem ...string) string
- func NewProxierWithNoProxyCIDR(delegate func(req *http.Request) (*url.URL, error)) func(req *http.Request) (*url.URL, error)
- func SetOldTransportDefaults(t *http.Transport) *http.Transport
- func SetTransportDefaults(t *http.Transport) *http.Transport
- func SourceIPs(req *http.Request) []net.IP
- func TLSClientConfig(transport http.RoundTripper) (*tls.Config, error)
- type DialFunc
- type Dialer
- type DialerFunc
- type RoundTripperWrapper
- type TLSClientConfigHolder
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
func AppendForwardedForHeader ¶
Prepares the X-Forwarded-For header for another forwarding hop by appending the previous sender's IP address to the X-Forwarded-For chain.
func CloneHeader ¶
CloneHeader creates a deep copy of an http.Header.
func CloneRequest ¶
CloneRequest creates a shallow copy of the request along with a deep copy of the Headers.
func ConnectWithRedirects ¶
func ConnectWithRedirects(originalMethod string, originalLocation *url.URL, header http.Header, originalBody io.Reader, dialer Dialer) (net.Conn, []byte, error)
ConnectWithRedirects uses dialer to send req, following up to 10 redirects (relative to originalLocation). It returns the opened net.Conn and the raw response bytes.
func GetClientIP ¶
Extracts and returns the clients IP from the given request. Looks at X-Forwarded-For header, X-Real-Ip header and request.RemoteAddr in that order. Returns nil if none of them are set or is set to an invalid value.
func GetHTTPClient ¶
func IsProbableEOF ¶
IsProbableEOF returns true if the given error resembles a connection termination scenario that would justify assuming that the watch is empty. These errors are what the Go http stack returns back to us which are general connection closure errors (strongly correlated) and callers that need to differentiate probable errors in connection behavior between normal "this is disconnected" should use the method.
func JoinPreservingTrailingSlash ¶
JoinPreservingTrailingSlash does a path.Join of the specified elements, preserving any trailing slash on the last non-empty segment
func NewProxierWithNoProxyCIDR ¶
func NewProxierWithNoProxyCIDR(delegate func(req *http.Request) (*url.URL, error)) func(req *http.Request) (*url.URL, error)
NewProxierWithNoProxyCIDR constructs a Proxier function that respects CIDRs in NO_PROXY and delegates if no matching CIDRs are found
func SetOldTransportDefaults ¶
SetOldTransportDefaults applies the defaults from http.DefaultTransport for the Proxy, Dial, and TLSHandshakeTimeout fields if unset
func SetTransportDefaults ¶
SetTransportDefaults applies the defaults from http.DefaultTransport for the Proxy, Dial, and TLSHandshakeTimeout fields if unset
func SourceIPs ¶
SourceIPs splits the comma separated X-Forwarded-For header or returns the X-Real-Ip header or req.RemoteAddr, in that order, ignoring invalid IPs. It returns nil if all of these are empty or invalid.
func TLSClientConfig ¶
func TLSClientConfig(transport http.RoundTripper) (*tls.Config, error)
Types ¶
type Dialer ¶
type Dialer interface { // Dial connects to the host specified by req's URL, writes the request to the connection, and // returns the opened net.Conn. Dial(req *http.Request) (net.Conn, error) }
Dialer dials a host and writes a request to it.
type DialerFunc ¶
DialerFunc implements Dialer for the provided function.
type RoundTripperWrapper ¶
type RoundTripperWrapper interface { http.RoundTripper WrappedRoundTripper() http.RoundTripper }