config

Documentation

Index

• Constants
• Variables
• func IsTailscale(serverName string) bool
• func TailscaleServerName() string
• type CertificateProvider
  • func Tailscale() CertificateProvider
• type JSONURL
  • func FromString(urlStr string) (JSONURL, error)
  • func (j *JSONURL) UnmarshalJSON(b []byte) error
• type Route
  • func (r *Route) MatchHostAndPath(hostPort, path string) bool
  • func (r *Route) MatchServerReq(req *http.Request) bool

Constants

const HasTailscale = true

Variables

var TailscaleSuffix = ".ts.net"

TailscaleSuffix is the suffix for server names which will use the tailscale client instead of the autocert client. Not expected to be changed but just in case.

Functions

func IsTailscale

func IsTailscale(serverName string) bool

IsTailscale returns true if the server name ends with the TailscaleSuffix. Note the check is expecting lowercase serverName which is what hello.ServerName already is.

func TailscaleServerName

func TailscaleServerName() string

Types

type CertificateProvider

type CertificateProvider interface {
	GetCertificate(hello *tls.ClientHelloInfo) (*tls.Certificate, error)
}

CertificateProvider interface is used to hide the tailscale dependency when not using it, could also be use as a generic mapping between server name and cert provider (while right now it's either autocert or tailscale).

func Tailscale

func Tailscale() CertificateProvider

type JSONURL

type JSONURL struct {
	Str string
	URL url.URL
}

func FromString

func FromString(urlStr string) (JSONURL, error)

func (*JSONURL) UnmarshalJSON

func (j *JSONURL) UnmarshalJSON(b []byte) error

UnmarshalJSON is needed to get a URL from json until golang does it on its own.

type Route

type Route struct {
	// Host or * or empty to match any host (* without a Prefix must be the last rule)
	Host string
	// Prefix or empty for any
	Prefix string
	// Destination url string.
	Destination JSONURL
}

Route configuration. Does Host/Prefix match to destination, see Match* functions. (only host,port,scheme part of Destination URL are used). User lowercase for the config. Incoming Host/Authority header will be lowercased. Paths (prefix) are case sensitive.

func (*Route) MatchHostAndPath

func (r *Route) MatchHostAndPath(hostPort, path string) bool

func (*Route) MatchServerReq

func (r *Route) MatchServerReq(req *http.Request) bool