tunnel

README

See: http://go.pkgdoc.org/github.com/akavel/tunnel

Documentation

Overview

Package tunnel eases creation of simple TLS connection over insecure network between safe, fully controlled endpoints.

Index

• func Dial(serverAddr string, cert *KeyPair, otherPubKey *x509.Certificate) (*tls.Conn, error)
• func Serve(tcpPort uint, cert *KeyPair, otherPubKey *x509.Certificate, ...) error
• type ClientHandler
• type KeyPair
  • func Keygen(name string) (*KeyPair, error)
  • func PEMDecode(pub, priv []byte) (*KeyPair, error)
  • func (pair KeyPair) PEMEncoded() (pub, priv []byte)
  • func (pair KeyPair) Pub() *x509.Certificate
  • func (pair KeyPair) Save(pubpath, privpath string) error

Functions

func Dial

func Dial(serverAddr string, cert *KeyPair, otherPubKey *x509.Certificate) (*tls.Conn, error)

func Serve

func Serve(tcpPort uint, cert *KeyPair, otherPubKey *x509.Certificate, handler ClientHandler) error

Types

type ClientHandler

type ClientHandler func(*tls.Conn, error) (more bool)

type KeyPair

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

Private + public key information.

func Keygen

func Keygen(name string) (*KeyPair, error)

Generates a randomized 1024b RSA self-signed private+public key set. The key is not useful out of this package (e.g. in fully-fledged TLS), as it is set to be marked as expired by the time it is created.

func PEMDecode

func PEMDecode(pub, priv []byte) (*KeyPair, error)

Load a private+public key pair from PEM-encoded serialized form.

func (KeyPair) PEMEncoded

func (pair KeyPair) PEMEncoded() (pub, priv []byte)

Serialize the private+public key pair using PEM encoding.

func (KeyPair) Pub

func (pair KeyPair) Pub() *x509.Certificate

Get the public part of the key pair.

func (KeyPair) Save

func (pair KeyPair) Save(pubpath, privpath string) error