tsid

README

tsid is a Caddy plugin that allows access only to requests coming from the Tailscale network and allows to identify users behind these requests by setting some Caddy placeholders:

Placeholder	Description
{http.vars.tailscale.name}	User name
{http.vars.tailscale.email}	User email

Usage

1. Build Caddy with this plugin by xcaddy:

    $ xcaddy build --with go.astrophena.name/tsid
   

2. Make sure that tsid is ordered first:

    {
      order tsid first
    }
   

3. Add the tsid directive to your Caddyfile and use the placeholders:

    tsid
   
    respond "Hello, {http.vars.tailscale.name}!"
   

License

MIT © Ilya Mateyko

Documentation

Overview

Package tsid is a Caddy plugin that allows access only to requests coming from the Tailscale network and allows to identify users behind these requests by setting some Caddy placeholders.

Index

• type Middleware
  • func (Middleware) CaddyModule() caddy.ModuleInfo
  • func (Middleware) ServeHTTP(w http.ResponseWriter, r *http.Request, next caddyhttp.Handler) error
  • func (Middleware) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

Types

type Middleware

type Middleware struct{}

Middleware is a Caddy HTTP handler that allows requests only from the Tailscale network and sets placeholders based on the Tailscale node information.

func (Middleware) CaddyModule

func (Middleware) CaddyModule() caddy.ModuleInfo

CaddyModule returns the Caddy module information.

func (Middleware) ServeHTTP

func (Middleware) ServeHTTP(w http.ResponseWriter, r *http.Request, next caddyhttp.Handler) error

ServeHTTP implements the caddyhttp.MiddlewareHandler interface.

func (Middleware) UnmarshalCaddyfile

func (Middleware) UnmarshalCaddyfile(d *caddyfile.Dispenser) error

UnmarshalCaddyfile implements the caddyfile.Unmarshaler interface.