tokens

Documentation

Index

• Variables
• type Config
• type Credentials
  • func New(cfg Config) Credentials
• type CredentialsParam
• type FrostFS
• type PrmObjectCreate

Variables

var (
	// ErrEmptyPublicKeys is returned when no HCS keys are provided.
	ErrEmptyPublicKeys = errors.New("HCS public keys could not be empty")
	// ErrEmptyBearerToken is returned when no bearer token is provided.
	ErrEmptyBearerToken = errors.New("Bearer token could not be empty")
)

Types

type Config

type Config struct {
	FrostFS                     FrostFS
	Key                         *keys.PrivateKey
	CacheConfig                 *cache.Config
	RemovingCheckAfterDurations time.Duration
}

type Credentials

type Credentials interface {
	GetBox(context.Context, oid.Address) (*accessbox.Box, []object.Attribute, error)
	Put(context.Context, cid.ID, CredentialsParam) (oid.Address, error)
	Update(context.Context, oid.Address, CredentialsParam) (oid.Address, error)
}

Credentials is a bearer token get/put interface.

func New

func New(cfg Config) Credentials

New creates a new Credentials instance using the given cli and key.

type CredentialsParam

type CredentialsParam struct {
	OwnerID          user.ID
	AccessBox        *accessbox.AccessBox
	Expiration       uint64
	Keys             keys.PublicKeys
	CustomAttributes []object.Attribute
}

type FrostFS

type FrostFS interface {
	// CreateObject creates and saves a parameterized object in the specified
	// FrostFS container from a specific user. It sets 'Timestamp' attribute to the current time.
	// It returns the ID of the saved object.
	//
	// It returns exactly one non-nil value. It returns any error encountered which
	// prevented the object from being created.
	CreateObject(context.Context, PrmObjectCreate) (oid.ID, error)

	// GetCredsObject gets the credential object from FrostFS network.
	// It uses search by system name and select using CRDT 2PSet. In case of absence CRDT header
	// it heads object by address.
	//
	// It returns exactly one non-nil value. It returns any error encountered which
	// prevented the object payload from being read.
	GetCredsObject(context.Context, oid.Address) (*object.Object, error)
}

FrostFS represents virtual connection to FrostFS network.

type PrmObjectCreate

type PrmObjectCreate struct {
	// FrostFS identifier of the object creator.
	Creator user.ID

	// FrostFS container to store the object.
	Container cid.ID

	// File path.
	Filepath string

	// Optional.
	// If provided cred object will be created using crdt approach.
	NewVersionFor *oid.ID

	// Last FrostFS epoch of the object lifetime.
	ExpirationEpoch uint64

	// Object payload.
	Payload []byte

	// CustomAttributes are additional user provided attributes for box object.
	CustomAttributes []object.Attribute
}

PrmObjectCreate groups parameters of objects created by credential tool.