security

type Access interface {
	SessionID() string
	Path() string
	Method() string

	SetSessionID(sid string)
}

type Authentication interface {
	Mechanism() string
	UserID() string
	UserSecret() []byte
}

type AuthenticationManager interface {
	Authenticate(ctx context.Context, a Authentication) (Identity, error)
}

type Authenticator interface {
	Supports(ctx context.Context, a Authentication) bool
	Verify(ctx context.Context, a Authentication) (Identity, error)
}

type Authorization interface {
	Identity() Identity
	Method() string
	Path() string
}

type AuthorizationManager interface {
	Accept(ctx context.Context, a Authorization) bool
}

type Authorizer interface {
	Supports(ctx context.Context, a Authorization) bool
	Accept(ctx context.Context, a Authorization) bool
}

type Context interface {
	GetAuthenticationManager() AuthenticationManager

	GetAuthorizationManager() AuthorizationManager

	GetSubjectManager() SubjectManager

	GetSessionIDGenerator() SessionIDGenerator
	GetSessionFactory() SessionFactory
	GetSessionManager() SessionManager
}

type Identity interface {
	UserID() string
	UserUUID() string
	Nickname() string
	Avatar() string
	Roles() []string
}

type Session interface {
	GetID() string // the session id

	GetProperty(name string) string
	SetProperty(name, value string)

	GetIdentity() Identity
	SetIdentity(ident Identity)
}

type SessionFactory interface {
	CreateSession() Session
}

type SessionIDGenerator interface {
	GenerateID() string
}

type SessionManager interface {
	InsertSession(session Session) (Session, error)
	RemoveSession(sid string) error
	UpdateSession(sid string, session Session) (Session, error)
	FindSession(sid string) (Session, error)
}

type Subject interface {
	GetSession() Session

	GetAccess() Access

	IsAuthenticated() bool

	SetSession(s Session)

	SetAccess(a Access)

	SetAuthenticated(authenticated bool)

	Login(ctx context.Context, a Authentication) (Identity, error)

	Logout() error

	Authorize(ctx context.Context, a Access) (bool, error)
}

type SubjectManager interface {
	GetSubject(ctx context.Context) Subject
}