min

Documentation

Index

• type ClientTransport
  • func (t *ClientTransport) GetDstPort(seed []byte) (uint16, error)
  • func (t *ClientTransport) GetParams() (proto.Message, error)
  • func (*ClientTransport) ID() pb.TransportType
  • func (*ClientTransport) Name() string
  • func (t ClientTransport) ParseParams(data *anypb.Any) (any, error)
  • func (*ClientTransport) Prepare(...) error
  • func (t *ClientTransport) PrepareKeys(pubkey [32]byte, sharedSecret []byte, dRand io.Reader) error
  • func (t *ClientTransport) SetParams(p any, unchecked ...bool) error
  • func (*ClientTransport) String() string
  • func (t *ClientTransport) WrapConn(conn net.Conn) (net.Conn, error)
• type Transport
  • func (Transport) GetDstPort(libVersion uint, seed []byte, params any) (uint16, error)
  • func (Transport) GetIdentifier(d *cj.DecoyRegistration) string
  • func (Transport) GetProto() pb.IPProto
  • func (Transport) LogPrefix() string
  • func (Transport) Name() string
  • func (t Transport) ParamStrings(p any) []string
  • func (Transport) ParseParams(libVersion uint, data *anypb.Any) (any, error)
  • func (Transport) WrapConnection(data *bytes.Buffer, c net.Conn, originalDst net.IP, ...) (*cj.DecoyRegistration, net.Conn, error)

Types

type ClientTransport

type ClientTransport struct {
	// Parameters are fields that will be shared with the station in the registration
	Parameters *pb.GenericTransportParams
	// contains filtered or unexported fields
}

ClientTransport implements the client side transport interface for the Min transport. The significant difference is that there is an instance of this structure per client session, where the station side Transport struct has one instance to be re-used for all sessions.

func (*ClientTransport) GetDstPort

func (t *ClientTransport) GetDstPort(seed []byte) (uint16, error)

GetDstPort returns the destination port that the client should open the phantom connection to

func (*ClientTransport) GetParams

func (t *ClientTransport) GetParams() (proto.Message, error)

GetParams returns a generic protobuf with any parameters from both the registration and the transport.

func (*ClientTransport) ID

func (*ClientTransport) ID() pb.TransportType

ID provides an identifier that will be sent to the conjure station during the registration so that the station knows what transport to expect connecting to the chosen phantom.

func (*ClientTransport) Name

func (*ClientTransport) Name() string

Name returns a string identifier for the Transport for logging

func (ClientTransport) ParseParams

func (t ClientTransport) ParseParams(data *anypb.Any) (any, error)

ParseParams gives the specific transport an option to parse a generic object into parameters provided by the station in the registration response during registration.

func (*ClientTransport) Prepare

func (*ClientTransport) Prepare(dialer func(ctx context.Context, network, laddr, raddr string) (net.Conn, error)) error

func (*ClientTransport) PrepareKeys

func (t *ClientTransport) PrepareKeys(pubkey [32]byte, sharedSecret []byte, dRand io.Reader) error

PrepareKeys provides an opportunity for the transport to integrate the station public key as well as bytes from the deterministic random generator associated with the registration that this ClientTransport is attached t

func (*ClientTransport) SetParams

func (t *ClientTransport) SetParams(p any, unchecked ...bool) error

SetParams allows the caller to set parameters associated with the transport, returning an error if the provided generic message is not compatible.

func (*ClientTransport) String

func (*ClientTransport) String() string

String returns a string identifier for the Transport for logging (including string formatters)

func (*ClientTransport) WrapConn

func (t *ClientTransport) WrapConn(conn net.Conn) (net.Conn, error)

WrapConn creates the connection to the phantom address negotiated in the registration phase of Conjure connection establishment.

type Transport

type Transport struct{}

Transport provides a struct implementing the Transport, WrappingTransport, PortRandomizingTransport, and FixedPortTransport interfaces.

func (Transport) GetDstPort

func (Transport) GetDstPort(libVersion uint, seed []byte, params any) (uint16, error)

GetDstPort Given the library version, a seed, and a generic object containing parameters the transport should be able to return the destination port that a clients phantom connection will attempt to reach

func (Transport) GetIdentifier

func (Transport) GetIdentifier(d *cj.DecoyRegistration) string

GetIdentifier takes in a registration and returns an identifier for it. This identifier should be unique for each registration on a given phantom; registrations on different phantoms can have the same identifier.

func (Transport) GetProto

func (Transport) GetProto() pb.IPProto

GetProto returns the next layer protocol that the transport uses. Implements the Transport interface.

func (Transport) LogPrefix

func (Transport) LogPrefix() string

LogPrefix returns the prefix used when including this transport in logs, implementing the Transport interface.

func (Transport) Name

func (Transport) Name() string

Name returns the human-friendly name of the transport, implementing the Transport interface..

func (Transport) ParamStrings

func (t Transport) ParamStrings(p any) []string

ParamStrings returns an array of tag string that will be added to tunStats when a proxy session is closed. For now, no params of interest.

func (Transport) ParseParams

func (Transport) ParseParams(libVersion uint, data *anypb.Any) (any, error)

ParseParams gives the specific transport an option to parse a generic object into parameters provided by the client during registration.

func (Transport) WrapConnection

func (Transport) WrapConnection(data *bytes.Buffer, c net.Conn, originalDst net.IP, regManager *cj.RegistrationManager) (*cj.DecoyRegistration, net.Conn, error)

WrapConnection attempts to wrap the given connection in the transport. It takes the information gathered so far on the connection in data, attempts to identify itself, and if it positively identifies itself wraps the connection in the transport, returning a connection that's ready to be used by others.

If the returned error is nil or non-nil and non-{ transports.ErrTryAgain, transports.ErrNotTransport }, the caller may no longer use data or conn.