http

Documentation

Index

• Constants
• func GetClientIPFromRequest(r *http.Request) net.IP
• func ParseGoogleDoHProtocol(r *http.Request) *types.Context
• func ParseIETFDoHProtocol(r *http.Request) *types.Context
• type DNSQuestion
• type DNSRR
• type DNSResponse
  • func ParseDNSResponseFromMessage(msg *dns.Msg) DNSResponse
• type Endpoint
  • func New(listenAddress string, certFile, keyFile string, handler types.ContextHandler) (*Endpoint, error)
  • func (e *Endpoint) Close() error
  • func (e *Endpoint) Run() error
  • func (e *Endpoint) ServeHTTP(w http.ResponseWriter, r *http.Request)

Constants

const (
	Name = "http"
)

Functions

func GetClientIPFromRequest

func GetClientIPFromRequest(r *http.Request) net.IP

func ParseGoogleDoHProtocol

func ParseGoogleDoHProtocol(r *http.Request) *types.Context

Reference https://developers.google.com/speed/public-dns/docs/doh/json

func ParseIETFDoHProtocol

func ParseIETFDoHProtocol(r *http.Request) *types.Context

Reference https://www.rfc-editor.org/rfc/rfc8484.html

Types

type DNSQuestion

type DNSQuestion struct {
	Name string `json:"name"`
	Type uint16 `json:"type"`
}

type DNSRR

type DNSRR struct {
	DNSQuestion
	TTL  uint32 `json:"TTL"`
	Data string `json:"data"`
}

type DNSResponse

type DNSResponse struct {
	Status             uint32        `json:"Status"`
	Truncated          bool          `json:"TC"`
	RecursionDesired   bool          `json:"RD"`
	RecursionAvailable bool          `json:"RA"`
	AuthenticatedData  bool          `json:"AD"`
	CheckingDisabled   bool          `json:"CD"`
	Question           []DNSQuestion `json:"Question"`
	Answer             []DNSRR       `json:"Answer"`
	Authority          []DNSRR       `json:"Authority,omitempty"`
	Additional         []DNSRR       `json:"Additional,omitempty"`
	Comment            string        `json:"Comment,omitempty"`
	EdnsClientSubnet   string        `json:"edns_client_subnet,omitempty"`
}

DNSResponse implements Google DoH protocol

func ParseDNSResponseFromMessage

func ParseDNSResponseFromMessage(msg *dns.Msg) DNSResponse

type Endpoint

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

func New

func New(listenAddress string, certFile, keyFile string, handler types.ContextHandler) (*Endpoint, error)

func (*Endpoint) Close

func (e *Endpoint) Close() error

TODO(@oif): Graceful shutdown

func (*Endpoint) Run

func (e *Endpoint) Run() error

func (*Endpoint) ServeHTTP

func (e *Endpoint) ServeHTTP(w http.ResponseWriter, r *http.Request)