sessions

Documentation

Overview

sessions provide a way to store user information on their end (in a cookie) the content of the cookie is signed (but not encrypted), hence it can be assumed that it hasn't been altered

cookie session format. Each part is base64 encoded alg.payload.signature it's heavily inspired by JWT, but I was stupid enough to do something *slightly* different

Index

• Variables
• type Config
• type S
  • func NewS(config *Config) (*S, error)
  • func (s *S) Load(r *http.Request, dst interface{}) error
  • func (s *S) Remove(w http.ResponseWriter)
  • func (s *S) Save(w http.ResponseWriter, obj interface{}) error

Variables

var ErrInvalidSignature = errors.New("session cookie: payload signature didn't match")

var ErrNoSession = errors.New("no session cookie")

Types

type Config

type Config struct {
	CookieName string
	Algorithm  string
	Key        []byte
}

type S

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

S should be instantiated once, and then used for every request

func NewS

func NewS(config *Config) (*S, error)

func (*S) Load

func (s *S) Load(r *http.Request, dst interface{}) error

Load returns the current session. Errors: ErrInvalidSignature, ErrNoSession

func (*S) Remove

func (s *S) Remove(w http.ResponseWriter)

Remove removes the session cookie

func (*S) Save

func (s *S) Save(w http.ResponseWriter, obj interface{}) error