tinybastion

README

tinybastion

build note: requires go 1.18, which is in beta at the time of writing

Documentation

Index

• type Bastion
  • func New(c Config) (*Bastion, error)
  • func (b *Bastion) AddPeer(key wgtypes.Key) (*wgtypes.PeerConfig, error)
  • func (b *Bastion) CleanupPeers() error
  • func (b *Bastion) Destroy() error
  • func (b *Bastion) ServerInfo() BastionServerInfo
• type BastionServerInfo
• type Config
• type CreateTunnelRequest
• type CreateTunnelResponse
• type MarshallableKey
  • func (m *MarshallableKey) MarshalJSON() ([]byte, error)
  • func (m *MarshallableKey) UnmarshalJSON(bytes []byte) error
• type MarshallablePeerConfig
  • func (m *MarshallablePeerConfig) MarshalJSON() ([]byte, error)
  • func (m *MarshallablePeerConfig) UnmarshalJSON(bytes []byte) error
• type Server
  • func NewServer(ctx context.Context, tb *Bastion, listenPort int, issuer string) *Server
  • func (s *Server) Destroy() error
  • func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)

Types

type Bastion

type Bastion struct {
	Config *Config
	Client *wgctrl.Client
	// contains filtered or unexported fields
}

func New

func New(c Config) (*Bastion, error)

func (*Bastion) AddPeer

func (b *Bastion) AddPeer(key wgtypes.Key) (*wgtypes.PeerConfig, error)

func (*Bastion) CleanupPeers

func (b *Bastion) CleanupPeers() error

func (*Bastion) Destroy

func (b *Bastion) Destroy() error

func (*Bastion) ServerInfo

func (b *Bastion) ServerInfo() BastionServerInfo

type BastionServerInfo

type BastionServerInfo struct {
	EndpointHost string
	EndpointPort int
	GatewayIP    string
	PublicKey    string
}

type Config

type Config struct {
	DeviceName          string
	Port                int
	PersistentKeepalive int
	ExternalHostname    string
	CIDR                string
}

type CreateTunnelRequest

type CreateTunnelRequest struct {
	PublicKey *MarshallableKey `json:"public_key"`
}

type CreateTunnelResponse

type CreateTunnelResponse struct {
	PeerConfig *MarshallablePeerConfig
}

type MarshallableKey

type MarshallableKey struct {
	K wgtypes.Key
}

func (*MarshallableKey) MarshalJSON

func (m *MarshallableKey) MarshalJSON() ([]byte, error)

func (*MarshallableKey) UnmarshalJSON

func (m *MarshallableKey) UnmarshalJSON(bytes []byte) error

type MarshallablePeerConfig

type MarshallablePeerConfig struct {
	P   wgtypes.PeerConfig
	BSI BastionServerInfo
}

func (*MarshallablePeerConfig) MarshalJSON

func (m *MarshallablePeerConfig) MarshalJSON() ([]byte, error)

func (*MarshallablePeerConfig) UnmarshalJSON

func (m *MarshallablePeerConfig) UnmarshalJSON(bytes []byte) error

type Server

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

func NewServer

func NewServer(ctx context.Context, tb *Bastion, listenPort int, issuer string) *Server

func (*Server) Destroy

func (s *Server) Destroy() error

func (*Server) ServeHTTP

func (s *Server) ServeHTTP(w http.ResponseWriter, r *http.Request)