dtls

Documentation

Index

• func AddListener(src string, conn *ipv4.PacketConn)
• func RemoveListener(src string)
• type CertPair
• type ConnectionState
  • func (a ConnectionState) String() string
• type State
  • func NewState(notifier func(ConnectionState)) (s *State, err error)
  • func (s *State) Close()
  • func (s *State) DoHandshake(local, remote string)
  • func (s *State) Fingerprint() string
  • func (s *State) GetCertPair() *CertPair
  • func (s *State) HandleDTLSPacket(packet []byte, local, remote string) ([]byte, error)
  • func (s *State) Send(packet []byte, local, remote string) (bool, error)
  • func (s *State) Start(isOffer bool)

Functions

func AddListener

func AddListener(src string, conn *ipv4.PacketConn)

AddListener adds the socket to a map that can be accessed by OpenSSL for sending This only needed until DTLS is rewritten in native Go

func RemoveListener

func RemoveListener(src string)

RemoveListener removes the socket from a map that can be accessed by OpenSSL for sending This only needed until DTLS is rewritten in native Go

Types

type CertPair

type CertPair struct {
	ClientWriteKey []byte
	ServerWriteKey []byte
	Profile        string
}

CertPair is the client+server key and profile extracted for SRTP

type ConnectionState

type ConnectionState uint8

ConnectionState determines the DTLS connection state

const (
	New ConnectionState = iota + 1
	Established
)

ConnectionState enums

func (ConnectionState) String

func (a ConnectionState) String() string

type State

type State struct {
	sync.Mutex
	// contains filtered or unexported fields
}

State represents all the state needed for a DTLS session

func NewState

func NewState(notifier func(ConnectionState)) (s *State, err error)

NewState creates a new DTLS session

func (*State) Close

func (s *State) Close()

Close cleans up the associated OpenSSL resources

func (*State) DoHandshake

func (s *State) DoHandshake(local, remote string)

DoHandshake sends the DTLS handshake it the remote peer

func (*State) Fingerprint

func (s *State) Fingerprint() string

Fingerprint generates a SHA-256 fingerprint of the certificate

func (*State) GetCertPair

func (s *State) GetCertPair() *CertPair

GetCertPair gets the current CertPair if DTLS has finished

func (*State) HandleDTLSPacket

func (s *State) HandleDTLSPacket(packet []byte, local, remote string) ([]byte, error)

HandleDTLSPacket checks if the packet is a DTLS packet, and if it is passes to the DTLS session If there is any data after decoding we pass back to the caller to handler

func (*State) Send

func (s *State) Send(packet []byte, local, remote string) (bool, error)

Send takes a un-encrypted packet and sends via DTLS

func (*State) Start

func (s *State) Start(isOffer bool)

Start allocates DTLS/ICE state that is dependent on if we are offering or answering