core

Documentation

Index

• Constants
• func ConjureHMAC(key []byte, str string) []byte
• func CurrentClientLibraryVersion() uint32
• type ConjureSharedKeys
  • func GenSharedKeys(clientLibVer uint, sharedSecret []byte, tt pb.TransportType) (ConjureSharedKeys, error)
• type SharedKeys
  • func GenerateClientSharedKeys(pubkey [32]byte) (*SharedKeys, error)

Constants

const (
	// PhantomSelectionMinGeneration
	PhantomSelectionMinGeneration uint = 1

	// PhantomHkdfMinVersion indicates the first version in which the Phantom selection was based on HKDF
	PhantomHkdfMinVersion uint = 2

	// RandomizeDstPortMinVersion is the earliest client library version ID that supports destination port randomization
	RandomizeDstPortMinVersion uint = 3

	// SharedKeysRefactorMinVersion
	SharedKeysRefactorMinVersion uint = 4
)

Functions

func ConjureHMAC

func ConjureHMAC(key []byte, str string) []byte

ConjureHMAC implements the hmak that can then be used for further hkdf key generation

func CurrentClientLibraryVersion

func CurrentClientLibraryVersion() uint32

CurrentClientLibraryVersion returns the current client library version used for feature compatibility support between client and server. Currently I don't intend to connect this to the library tag version in any way.

When adding new client versions comment out older versions and add new version below with a description of the reason for the new version.

Types

type ConjureSharedKeys

type ConjureSharedKeys struct {
	SharedSecret []byte
	ConjureSeed  []byte

	TransportReader io.Reader
	TransportKeys   interface{}
}

ConjureSharedKeys contains keys that the station is required to keep.

func GenSharedKeys

func GenSharedKeys(clientLibVer uint, sharedSecret []byte, tt pb.TransportType) (ConjureSharedKeys, error)

GenSharedKeys generates the keys requires to form a Conjure connection based on the SharedSecret

type SharedKeys

type SharedKeys struct {
	SharedSecret, Representative []byte
	ConjureSeed                  []byte
	Reader                       io.Reader
}

func GenerateClientSharedKeys

func GenerateClientSharedKeys(pubkey [32]byte) (*SharedKeys, error)