util

Documentation

Index

• func IterateSplitLeaves(r ObjectSource, addr oid.Address, h func(*object.Object) bool) error
• func LogServiceError(l *zap.Logger, req string, node network.AddressGroup, err error)
• func LogWorkerPoolError(l *zap.Logger, req string, err error)
• type CommonPrm
  • func CommonPrmFromRequest(req interface{ ... }) (*CommonPrm, error)
  • func (p *CommonPrm) BearerToken() *bearer.Token
  • func (p *CommonPrm) ForgetTokens()
  • func (p *CommonPrm) LocalOnly() bool
  • func (p *CommonPrm) SessionToken() *sessionsdk.Object
  • func (p *CommonPrm) TTL() uint32
  • func (p *CommonPrm) WithLocalOnly(v bool) *CommonPrm
  • func (p *CommonPrm) XHeaders() []string
• type KeyStorage
  • func NewKeyStorage(localKey *ecdsa.PrivateKey, tokenStore SessionSource, net netmap.State) *KeyStorage
  • func (s *KeyStorage) GetKey(info *SessionInfo) (*ecdsa.PrivateKey, error)
• type ObjectSource
• type SessionInfo
• type SessionSource
• type SplitMemberHandler

Functions

func IterateSplitLeaves

func IterateSplitLeaves(r ObjectSource, addr oid.Address, h func(*object.Object) bool) error

IterateSplitLeaves is an iterator over object split-tree leaves in direct order.

If member handler returns true, then the iterator aborts without error.

func LogServiceError

func LogServiceError(l *zap.Logger, req string, node network.AddressGroup, err error)

LogServiceError writes error message of object service to provided logger.

func LogWorkerPoolError

func LogWorkerPoolError(l *zap.Logger, req string, err error)

LogWorkerPoolError writes debug error message of object worker pool to provided logger.

Types

type CommonPrm

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

func CommonPrmFromRequest

func CommonPrmFromRequest(req interface {
	GetMetaHeader() *protosession.RequestMetaHeader
}) (*CommonPrm, error)

CommonPrmFromRequest is a temporary copy-paste of [CommonPrmFromV2].

func (*CommonPrm) BearerToken

func (p *CommonPrm) BearerToken() *bearer.Token

func (*CommonPrm) ForgetTokens

func (p *CommonPrm) ForgetTokens()

ForgetTokens forgets all the tokens read from the request's meta information before.

func (*CommonPrm) LocalOnly

func (p *CommonPrm) LocalOnly() bool

func (*CommonPrm) SessionToken

func (p *CommonPrm) SessionToken() *sessionsdk.Object

func (*CommonPrm) TTL

func (p *CommonPrm) TTL() uint32

TTL returns TTL for new requests.

func (*CommonPrm) WithLocalOnly

func (p *CommonPrm) WithLocalOnly(v bool) *CommonPrm

func (*CommonPrm) XHeaders

func (p *CommonPrm) XHeaders() []string

XHeaders returns X-Headers for new requests.

type KeyStorage

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

KeyStorage represents private key storage of the local node.

func NewKeyStorage

func NewKeyStorage(localKey *ecdsa.PrivateKey, tokenStore SessionSource, net netmap.State) *KeyStorage

NewKeyStorage creates, initializes and returns new KeyStorage instance.

func (*KeyStorage) GetKey

func (s *KeyStorage) GetKey(info *SessionInfo) (*ecdsa.PrivateKey, error)

GetKey fetches private key depending on the SessionInfo.

If info is not `nil`, searches for dynamic session token through the underlying token storage. Returns apistatus.SessionTokenNotFound if token storage does not contain information about provided dynamic session.

If info is `nil`, returns node's private key.

type ObjectSource

type ObjectSource interface {
	// Head must return one of:
	// * object header (*object.Object);
	// * structured information about split-chain (*object.SplitInfo).
	Head(id oid.Address) (any, error)

	// Get must return object by its address.
	Get(address oid.Address) (object.Object, error)
}

ObjectSource is an interface of entity that can receive object header, the whole object or the information about the object relations.

type SessionInfo

type SessionInfo struct {
	// Session unique identifier.
	ID uuid.UUID

	// Session issuer.
	Owner user.ID
}

SessionInfo groups information about NeoFS Object session which is reflected in KeyStorage.

type SessionSource

type SessionSource interface {
	// Get must return non-expired private token that
	// corresponds with passed owner and tokenID. If
	// token has not been created, has been expired
	// of it is impossible to get information about the
	// token Get must return nil.
	Get(owner user.ID, tokenID []byte) *storage.PrivateToken
}

SessionSource is an interface tha provides access to node's actual (not expired) session tokens.

type SplitMemberHandler

type SplitMemberHandler func(member *object.Object, reverseDirection bool) (stop bool)

SplitMemberHandler is a handler of next split-chain element.

If reverseDirection arg is true, then the traversal is done in reverse order. Stop boolean result provides the ability to interrupt the traversal.