iface

Documentation

Overview

Package iface provides wireguard network interface creation and management

Index

• Constants
• Variables
• func WireGuardModuleIsLoaded() bool
• type NetInterface
• type TunAdapter
• type WGAddress
  • func (addr WGAddress) String() string
• type WGIface
  • func NewWGIFace(iFaceName string, address string, mtu int, routes []string, ...) (*WGIface, error)
  • func (w *WGIface) AddAllowedIP(peerKey string, allowedIP string) error
  • func (w *WGIface) Address() WGAddress
  • func (w *WGIface) Close() error
  • func (w *WGIface) Configure(privateKey string, port int) error
  • func (w *WGIface) Create() error
  • func (w *WGIface) GetBind() *bind.ICEBind
  • func (w *WGIface) IsUserspaceBind() bool
  • func (w *WGIface) Name() string
  • func (w *WGIface) RemoveAllowedIP(peerKey string, allowedIP string) error
  • func (w *WGIface) RemovePeer(peerKey string) error
  • func (w *WGIface) UpdateAddr(newAddr string) error
  • func (w *WGIface) UpdatePeer(peerKey string, allowedIps string, keepAlive time.Duration, ...) error

Constants

const (
	DefaultMTU    = 1280
	DefaultWgPort = 51820
)

const WgInterfaceDefault = "wt0"

WgInterfaceDefault is a default interface name of Wiretrustee

Variables

var (
	// ErrModuleNotFound is the error resulting if a module can't be found.
	ErrModuleNotFound = errors.New("module not found")
)

Functions

func WireGuardModuleIsLoaded

func WireGuardModuleIsLoaded() bool

WireGuardModuleIsLoaded check if we can load WireGuard mod (linux only)

Types

type NetInterface

type NetInterface interface {
	Close() error
}

NetInterface represents a generic network tunnel interface

type TunAdapter

type TunAdapter interface {
	ConfigureInterface(address string, mtu int, routes string) (int, error)
	UpdateAddr(address string) error
}

TunAdapter is an interface for create tun device from externel service

type WGAddress

type WGAddress struct {
	IP      net.IP
	Network *net.IPNet
}

WGAddress Wireguard parsed address

func (WGAddress) String

func (addr WGAddress) String() string

type WGIface

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

WGIface represents a interface instance

func NewWGIFace

func NewWGIFace(iFaceName string, address string, mtu int, routes []string, tunAdapter TunAdapter, transportNet transport.Net) (*WGIface, error)

NewWGIFace Creates a new WireGuard interface instance

func (*WGIface) AddAllowedIP

func (w *WGIface) AddAllowedIP(peerKey string, allowedIP string) error

AddAllowedIP adds a prefix to the allowed IPs list of peer

func (*WGIface) Address

func (w *WGIface) Address() WGAddress

Address returns the interface address

func (*WGIface) Close

func (w *WGIface) Close() error

Close closes the tunnel interface

func (*WGIface) Configure

func (w *WGIface) Configure(privateKey string, port int) error

Configure configures a Wireguard interface The interface must exist before calling this method (e.g. call interface.Create() before)

func (*WGIface) Create

func (w *WGIface) Create() error

Create creates a new Wireguard interface, sets a given IP and brings it up. Will reuse an existing one.

func (*WGIface) GetBind

func (w *WGIface) GetBind() *bind.ICEBind

GetBind returns a userspace implementation of WireGuard Bind interface

func (*WGIface) IsUserspaceBind

func (w *WGIface) IsUserspaceBind() bool

IsUserspaceBind indicates whether this interfaces is userspace with bind.ICEBind

func (*WGIface) Name

func (w *WGIface) Name() string

Name returns the interface name

func (*WGIface) RemoveAllowedIP

func (w *WGIface) RemoveAllowedIP(peerKey string, allowedIP string) error

RemoveAllowedIP removes a prefix from the allowed IPs list of peer

func (*WGIface) RemovePeer

func (w *WGIface) RemovePeer(peerKey string) error

RemovePeer removes a Wireguard Peer from the interface iface

func (*WGIface) UpdateAddr

func (w *WGIface) UpdateAddr(newAddr string) error

UpdateAddr updates address of the interface

func (*WGIface) UpdatePeer

func (w *WGIface) UpdatePeer(peerKey string, allowedIps string, keepAlive time.Duration, endpoint *net.UDPAddr, preSharedKey *wgtypes.Key) error

UpdatePeer updates existing Wireguard Peer or creates a new one if doesn't exist Endpoint is optional