token

Documentation

Index

• Variables
• type GenerateOption
  • func WithExpiry(d time.Duration) GenerateOption
• type GenerateOptions
  • func NewGenerateOptions(opts ...GenerateOption) GenerateOptions
• type JWT
  • func (j *JWT) Generate(acc *auth.Account, opts ...GenerateOption) (*Token, error)
  • func (j *JWT) Inspect(t string) (*auth.Account, error)
  • func (j *JWT) String() string
• type Option
  • func WithPrivateKey(key string) Option
  • func WithPublicKey(key string) Option
  • func WithStore(s store.Store) Option
• type Options
  • func NewOptions(opts ...Option) Options
• type Provider
  • func New(opts ...Option) Provider
• type Token

Variables

var (
	// ErrNotFound is returned when a token cannot be found
	ErrNotFound = errors.New("token not found")
	// ErrEncodingToken is returned when the service encounters an error during encoding
	ErrEncodingToken = errors.New("error encoding the token")
	// ErrInvalidToken is returned when the token provided is not valid
	ErrInvalidToken = errors.New("invalid token provided")
)

Types

type GenerateOption

type GenerateOption func(o *GenerateOptions)

func WithExpiry

func WithExpiry(d time.Duration) GenerateOption

WithExpiry for the generated account's token expires

type GenerateOptions

type GenerateOptions struct {
	// Expiry for the token
	Expiry time.Duration
}

func NewGenerateOptions

func NewGenerateOptions(opts ...GenerateOption) GenerateOptions

NewGenerateOptions from a slice of options

type JWT

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

JWT implementation of token provider

func (*JWT) Generate

func (j *JWT) Generate(acc *auth.Account, opts ...GenerateOption) (*Token, error)

Generate a new JWT

func (*JWT) Inspect

func (j *JWT) Inspect(t string) (*auth.Account, error)

Inspect a JWT

func (*JWT) String

func (j *JWT) String() string

String returns JWT

type Option

type Option func(o *Options)

func WithPrivateKey

func WithPrivateKey(key string) Option

WithPrivateKey sets the JWT private key

func WithPublicKey

func WithPublicKey(key string) Option

WithPublicKey sets the JWT public key

func WithStore

func WithStore(s store.Store) Option

WithStore sets the token providers store

type Options

type Options struct {
	// Store to persist the tokens
	Store store.Store
	// PublicKey base64 encoded, used by JWT
	PublicKey string
	// PrivateKey base64 encoded, used by JWT
	PrivateKey string
}

func NewOptions

func NewOptions(opts ...Option) Options

type Provider

type Provider interface {
	Generate(account *auth.Account, opts ...GenerateOption) (*Token, error)
	Inspect(token string) (*auth.Account, error)
	String() string
}

Provider generates and inspects tokens

func New

func New(opts ...Option) Provider

New returns an initialized basic provider

type Token

type Token struct {
	// The actual token
	Token string `json:"token"`
	// Time of token creation
	Created time.Time `json:"created"`
	// Time of token expiry
	Expiry time.Time `json:"expiry"`
}