2019-11-25 11:30:26 +02:00
|
|
|
// Package auth provides authentication and authorization capability
|
|
|
|
package auth
|
|
|
|
|
2019-11-25 11:33:30 +02:00
|
|
|
import (
|
|
|
|
"time"
|
|
|
|
)
|
|
|
|
|
2019-11-25 11:30:26 +02:00
|
|
|
// Auth providers authentication and authorization
|
|
|
|
type Auth interface {
|
2020-02-03 10:16:02 +02:00
|
|
|
// String to identify the package
|
|
|
|
String() string
|
|
|
|
// Init the auth package
|
|
|
|
Init(opts ...Option) error
|
2020-02-10 10:26:28 +02:00
|
|
|
// Options returns the options set
|
|
|
|
Options() Options
|
2020-02-03 10:16:02 +02:00
|
|
|
// Generate a new auth Account
|
|
|
|
Generate(id string, opts ...GenerateOption) (*Account, error)
|
|
|
|
// Revoke an authorization Account
|
|
|
|
Revoke(token string) error
|
|
|
|
// Validate an account token
|
|
|
|
Validate(token string) (*Account, error)
|
2019-12-17 23:27:05 +02:00
|
|
|
}
|
|
|
|
|
2020-02-03 10:16:02 +02:00
|
|
|
// Resource is an entity such as a user or
|
|
|
|
type Resource struct {
|
2019-12-17 23:27:05 +02:00
|
|
|
// Name of the resource
|
|
|
|
Name string
|
2020-02-03 10:16:02 +02:00
|
|
|
// Type of resource, e.g.
|
|
|
|
Type string
|
2019-11-25 11:30:26 +02:00
|
|
|
}
|
|
|
|
|
2020-02-03 10:16:02 +02:00
|
|
|
// Role an account has
|
|
|
|
type Role struct {
|
|
|
|
Name string
|
|
|
|
Resource *Resource
|
|
|
|
}
|
|
|
|
|
|
|
|
// Account provided by an auth provider
|
|
|
|
type Account struct {
|
|
|
|
// ID of the account (UUID or email)
|
2019-11-25 11:30:26 +02:00
|
|
|
Id string `json: "id"`
|
2020-02-03 10:16:02 +02:00
|
|
|
// Token used to authenticate
|
|
|
|
Token string `json: "token"`
|
|
|
|
// Time of Account creation
|
2019-11-25 11:30:26 +02:00
|
|
|
Created time.Time `json:"created"`
|
2020-02-03 10:16:02 +02:00
|
|
|
// Time of Account expiry
|
2019-11-25 11:30:26 +02:00
|
|
|
Expiry time.Time `json:"expiry"`
|
2020-02-03 10:16:02 +02:00
|
|
|
// Roles associated with the Account
|
|
|
|
Roles []*Role `json:"roles"`
|
2019-11-25 11:30:26 +02:00
|
|
|
// Any other associated metadata
|
|
|
|
Metadata map[string]string `json:"metadata"`
|
|
|
|
}
|