auth

Documentation

Index

• Constants
• Variables
• type AuthenticatedUser
• type Credential
• type CredentialType
  • func (c CredentialType) String() string
• type Realm
• type Role
• type RoleType
  • func (r RoleType) Is(rt RoleType) bool
  • func (r RoleType) IsValid() bool
  • func (r RoleType) String() string
  • func (r *RoleType) UnmarshalJSON(b []byte) error

Constants

const (
	CredentialTypeBasic  = CredentialType("BASIC")
	CredentialTypeAPIKey = CredentialType("API_KEY")
)

const (
	RoleSuperUser = RoleType("super_user")
	RoleUIAdmin   = RoleType("ui_admin")
	RoleAdmin     = RoleType("admin")
	RoleAPI       = RoleType("api")
)

Variables

var (
	ErrCredentialNotFound = errors.New("credential not found")
)

Types

type AuthenticatedUser

type AuthenticatedUser struct {
	AuthenticatedByRealm string     `json:"-"` // Name of realm that authenticated this user
	Credential           Credential `json:"credential"`
	Role                 Role       `json:"role"`
}

type Credential

type Credential struct {
	Type     CredentialType `json:"type"`
	Username string         `json:"username"`
	Password string         `json:"password"`
	APIKey   string         `json:"api_key"`
}

type CredentialType

type CredentialType string

func (CredentialType) String

func (c CredentialType) String() string

type Realm

type Realm interface {
	GetName() string
	Authenticate(cred *Credential) (*AuthenticatedUser, error)
}

type Role

type Role struct {
	Type   RoleType `json:"type"`
	Groups []string `json:"groups"`
}

Role represents the permission a user is given, if the Type is RoleSuperUser, Then the user will have access to everything regardless of the value of Groups.

type RoleType

type RoleType string

func (RoleType) Is

func (r RoleType) Is(rt RoleType) bool

func (RoleType) IsValid

func (r RoleType) IsValid() bool

func (RoleType) String

func (r RoleType) String() string

func (*RoleType) UnmarshalJSON

func (r *RoleType) UnmarshalJSON(b []byte) error