auth

Documentation

Index

• func Feature(config ...func(*Installer)) miruken.Feature
• func WriteWWWAuthenticateHeader(w http.ResponseWriter, scheme string, realm string, params map[string]string, ...)
• type Authentication
  • func (a *Authentication) Flow(flow login.Flow) *FlowBuilder
  • func (a *Authentication) FlowRef(ref string) *FlowBuilder
  • func (a *Authentication) ServeHTTP(w http.ResponseWriter, r *http.Request, m httpsrv.Middleware, ...) error
• type Bearer
  • func (b Bearer) Accept(r *http.Request) (miruken.Handler, error, bool)
  • func (b Bearer) Challenge(w http.ResponseWriter, r *http.Request, err error) int
• type FlowBuilder
  • func WithFlow(flow login.Flow) *FlowBuilder
  • func WithFlowRef(flow string) *FlowBuilder
  • func (b *FlowBuilder) Bearer() *Authentication
  • func (b *FlowBuilder) BearerInRealm(realm string) *Authentication
  • func (b *FlowBuilder) Scheme(scheme Scheme) *Authentication
• type Installer
  • func (i *Installer) DependsOn() []miruken.Feature
  • func (i *Installer) Install(setup *miruken.SetupBuilder) error
• type Scheme

Functions

func Feature

func Feature(config ...func(*Installer)) miruken.Feature

Feature configures http server support

func WriteWWWAuthenticateHeader

func WriteWWWAuthenticateHeader(
	w http.ResponseWriter,
	scheme string,
	realm string,
	params map[string]string,
	err error,
)

WriteWWWAuthenticateHeader writes the `WWW-Authenticate` http response header for the supplied scheme.

Types

type Authentication

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

Authentication applies login flows to auth requests.

func (*Authentication) Flow

func (a *Authentication) Flow(flow login.Flow) *FlowBuilder

func (*Authentication) FlowRef

func (a *Authentication) FlowRef(ref string) *FlowBuilder

func (*Authentication) ServeHTTP

func (a *Authentication) ServeHTTP(
	w http.ResponseWriter,
	r *http.Request,
	m httpsrv.Middleware,
	h miruken.Handler,
	n func(miruken.Handler),
) error

type Bearer

type Bearer struct {
	Realm string
}

Bearer is a http authentication Scheme that uses an opaque string (token) to protect resources.

func (Bearer) Accept

func (b Bearer) Accept(
	r *http.Request,
) (miruken.Handler, error, bool)

func (Bearer) Challenge

func (b Bearer) Challenge(
	w http.ResponseWriter,
	r *http.Request,
	err error,
) int

type FlowBuilder

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

FlowBuilder configures a login flow.

func WithFlow

func WithFlow(flow login.Flow) *FlowBuilder

WithFlow starts a new authentication flow builder with the definition of a login flow.

func WithFlowRef

func WithFlowRef(flow string) *FlowBuilder

WithFlowRef starts a new authentication flow builder with a reference to a login flow.

func (*FlowBuilder) Bearer

func (b *FlowBuilder) Bearer() *Authentication

Bearer configures an authentication flow to use `Bearer` tokens.

func (*FlowBuilder) BearerInRealm

func (b *FlowBuilder) BearerInRealm(realm string) *Authentication

BearerInRealm configures an authentication flow to use `Bearer` tokens in the supplied realm.

func (*FlowBuilder) Scheme

func (b *FlowBuilder) Scheme(scheme Scheme) *Authentication

type Installer

type Installer struct{}

Installer configures http server support

func (*Installer) DependsOn

func (i *Installer) DependsOn() []miruken.Feature

func (*Installer) Install

func (i *Installer) Install(setup *miruken.SetupBuilder) error

type Scheme

type Scheme interface {
	Accept(r *http.Request) (miruken.Handler, error, bool)
	Challenge(w http.ResponseWriter, r *http.Request, err error) int
}

Scheme binds a http request to a login flow.