268 lines
7 KiB
Go
268 lines
7 KiB
Go
package eacl
|
|
|
|
import (
|
|
"crypto/ecdsa"
|
|
"fmt"
|
|
|
|
v2acl "github.com/nspcc-dev/neofs-api-go/v2/acl"
|
|
"github.com/nspcc-dev/neofs-sdk-go/checksum"
|
|
cid "github.com/nspcc-dev/neofs-sdk-go/container/id"
|
|
"github.com/nspcc-dev/neofs-sdk-go/object"
|
|
"github.com/nspcc-dev/neofs-sdk-go/owner"
|
|
"github.com/nspcc-dev/neofs-sdk-go/version"
|
|
)
|
|
|
|
// Record of the EACL rule, that defines EACL action, targets for this action,
|
|
// object service operation and filters for request headers.
|
|
//
|
|
// Record is compatible with v2 acl.EACLRecord message.
|
|
type Record struct {
|
|
action Action
|
|
operation Operation
|
|
filters []*Filter
|
|
targets []*Target
|
|
}
|
|
|
|
// Targets returns list of target subjects to apply ACL rule to.
|
|
func (r Record) Targets() []*Target {
|
|
return r.targets
|
|
}
|
|
|
|
// SetTargets sets list of target subjects to apply ACL rule to.
|
|
func (r *Record) SetTargets(targets ...*Target) {
|
|
r.targets = targets
|
|
}
|
|
|
|
// Filters returns list of filters to match and see if rule is applicable.
|
|
func (r Record) Filters() []*Filter {
|
|
return r.filters
|
|
}
|
|
|
|
// Operation returns NeoFS request verb to match.
|
|
func (r Record) Operation() Operation {
|
|
return r.operation
|
|
}
|
|
|
|
// SetOperation sets NeoFS request verb to match.
|
|
func (r *Record) SetOperation(operation Operation) {
|
|
r.operation = operation
|
|
}
|
|
|
|
// Action returns rule execution result.
|
|
func (r Record) Action() Action {
|
|
return r.action
|
|
}
|
|
|
|
// SetAction sets rule execution result.
|
|
func (r *Record) SetAction(action Action) {
|
|
r.action = action
|
|
}
|
|
|
|
// AddRecordTarget adds single Target to the Record.
|
|
func AddRecordTarget(r *Record, t *Target) {
|
|
r.SetTargets(append(r.Targets(), t)...)
|
|
}
|
|
|
|
// AddFormedTarget forms Target with specified Role and list of
|
|
// ECDSA public keys and adds it to the Record.
|
|
func AddFormedTarget(r *Record, role Role, keys ...ecdsa.PublicKey) {
|
|
t := NewTarget()
|
|
t.SetRole(role)
|
|
|
|
SetTargetECDSAKeys(t, ecdsaKeysToPtrs(keys)...)
|
|
AddRecordTarget(r, t)
|
|
}
|
|
|
|
func (r *Record) addFilter(from FilterHeaderType, m Match, keyTyp filterKeyType, key string, val fmt.Stringer) {
|
|
filter := &Filter{
|
|
from: from,
|
|
key: filterKey{
|
|
typ: keyTyp,
|
|
str: key,
|
|
},
|
|
matcher: m,
|
|
value: val,
|
|
}
|
|
|
|
r.filters = append(r.filters, filter)
|
|
}
|
|
|
|
func (r *Record) addObjectFilter(m Match, keyTyp filterKeyType, key string, val fmt.Stringer) {
|
|
r.addFilter(HeaderFromObject, m, keyTyp, key, val)
|
|
}
|
|
|
|
func (r *Record) addObjectReservedFilter(m Match, typ filterKeyType, val fmt.Stringer) {
|
|
r.addObjectFilter(m, typ, "", val)
|
|
}
|
|
|
|
// AddFilter adds generic filter.
|
|
func (r *Record) AddFilter(from FilterHeaderType, matcher Match, name, value string) {
|
|
r.addFilter(from, matcher, 0, name, staticStringer(value))
|
|
}
|
|
|
|
// AddObjectAttributeFilter adds filter by object attribute.
|
|
func (r *Record) AddObjectAttributeFilter(m Match, key, value string) {
|
|
r.addObjectFilter(m, 0, key, staticStringer(value))
|
|
}
|
|
|
|
// AddObjectVersionFilter adds filter by object version.
|
|
func (r *Record) AddObjectVersionFilter(m Match, v *version.Version) {
|
|
r.addObjectReservedFilter(m, fKeyObjVersion, v)
|
|
}
|
|
|
|
// AddObjectIDFilter adds filter by object ID.
|
|
func (r *Record) AddObjectIDFilter(m Match, id *object.ID) {
|
|
r.addObjectReservedFilter(m, fKeyObjID, id)
|
|
}
|
|
|
|
// AddObjectContainerIDFilter adds filter by object container ID.
|
|
func (r *Record) AddObjectContainerIDFilter(m Match, id *cid.ID) {
|
|
r.addObjectReservedFilter(m, fKeyObjContainerID, id)
|
|
}
|
|
|
|
// AddObjectOwnerIDFilter adds filter by object owner ID.
|
|
func (r *Record) AddObjectOwnerIDFilter(m Match, id *owner.ID) {
|
|
r.addObjectReservedFilter(m, fKeyObjOwnerID, id)
|
|
}
|
|
|
|
// AddObjectCreationEpoch adds filter by object creation epoch.
|
|
func (r *Record) AddObjectCreationEpoch(m Match, epoch uint64) {
|
|
r.addObjectReservedFilter(m, fKeyObjCreationEpoch, u64Stringer(epoch))
|
|
}
|
|
|
|
// AddObjectPayloadLengthFilter adds filter by object payload length.
|
|
func (r *Record) AddObjectPayloadLengthFilter(m Match, size uint64) {
|
|
r.addObjectReservedFilter(m, fKeyObjPayloadLength, u64Stringer(size))
|
|
}
|
|
|
|
// AddObjectPayloadHashFilter adds filter by object payload hash value.
|
|
func (r *Record) AddObjectPayloadHashFilter(m Match, h *checksum.Checksum) {
|
|
r.addObjectReservedFilter(m, fKeyObjPayloadHash, h)
|
|
}
|
|
|
|
// AddObjectTypeFilter adds filter by object type.
|
|
func (r *Record) AddObjectTypeFilter(m Match, t object.Type) {
|
|
r.addObjectReservedFilter(m, fKeyObjType, t)
|
|
}
|
|
|
|
// AddObjectHomomorphicHashFilter adds filter by object payload homomorphic hash value.
|
|
func (r *Record) AddObjectHomomorphicHashFilter(m Match, h *checksum.Checksum) {
|
|
r.addObjectReservedFilter(m, fKeyObjHomomorphicHash, h)
|
|
}
|
|
|
|
// ToV2 converts Record to v2 acl.EACLRecord message.
|
|
//
|
|
// Nil Record converts to nil.
|
|
func (r *Record) ToV2() *v2acl.Record {
|
|
if r == nil {
|
|
return nil
|
|
}
|
|
|
|
v2 := new(v2acl.Record)
|
|
|
|
if r.targets != nil {
|
|
targets := make([]*v2acl.Target, 0, len(r.targets))
|
|
for _, target := range r.targets {
|
|
targets = append(targets, target.ToV2())
|
|
}
|
|
|
|
v2.SetTargets(targets)
|
|
}
|
|
|
|
if r.filters != nil {
|
|
filters := make([]*v2acl.HeaderFilter, 0, len(r.filters))
|
|
for _, filter := range r.filters {
|
|
filters = append(filters, filter.ToV2())
|
|
}
|
|
|
|
v2.SetFilters(filters)
|
|
}
|
|
|
|
v2.SetAction(r.action.ToV2())
|
|
v2.SetOperation(r.operation.ToV2())
|
|
|
|
return v2
|
|
}
|
|
|
|
// NewRecord creates and returns blank Record instance.
|
|
//
|
|
// Defaults:
|
|
// - action: ActionUnknown;
|
|
// - operation: OperationUnknown;
|
|
// - targets: nil,
|
|
// - filters: nil.
|
|
func NewRecord() *Record {
|
|
return new(Record)
|
|
}
|
|
|
|
// CreateRecord creates, initializes with parameters and returns Record instance.
|
|
func CreateRecord(action Action, operation Operation) *Record {
|
|
r := NewRecord()
|
|
r.action = action
|
|
r.operation = operation
|
|
r.targets = []*Target{}
|
|
r.filters = []*Filter{}
|
|
|
|
return r
|
|
}
|
|
|
|
// NewRecordFromV2 converts v2 acl.EACLRecord message to Record.
|
|
func NewRecordFromV2(record *v2acl.Record) *Record {
|
|
r := NewRecord()
|
|
|
|
if record == nil {
|
|
return r
|
|
}
|
|
|
|
r.action = ActionFromV2(record.GetAction())
|
|
r.operation = OperationFromV2(record.GetOperation())
|
|
|
|
v2targets := record.GetTargets()
|
|
v2filters := record.GetFilters()
|
|
|
|
r.targets = make([]*Target, 0, len(v2targets))
|
|
for i := range v2targets {
|
|
r.targets = append(r.targets, NewTargetFromV2(v2targets[i]))
|
|
}
|
|
|
|
r.filters = make([]*Filter, 0, len(v2filters))
|
|
for i := range v2filters {
|
|
r.filters = append(r.filters, NewFilterFromV2(v2filters[i]))
|
|
}
|
|
|
|
return r
|
|
}
|
|
|
|
// Marshal marshals Record into a protobuf binary form.
|
|
func (r *Record) Marshal() ([]byte, error) {
|
|
return r.ToV2().StableMarshal(nil)
|
|
}
|
|
|
|
// Unmarshal unmarshals protobuf binary representation of Record.
|
|
func (r *Record) Unmarshal(data []byte) error {
|
|
fV2 := new(v2acl.Record)
|
|
if err := fV2.Unmarshal(data); err != nil {
|
|
return err
|
|
}
|
|
|
|
*r = *NewRecordFromV2(fV2)
|
|
|
|
return nil
|
|
}
|
|
|
|
// MarshalJSON encodes Record to protobuf JSON format.
|
|
func (r *Record) MarshalJSON() ([]byte, error) {
|
|
return r.ToV2().MarshalJSON()
|
|
}
|
|
|
|
// UnmarshalJSON decodes Record from protobuf JSON format.
|
|
func (r *Record) UnmarshalJSON(data []byte) error {
|
|
tV2 := new(v2acl.Record)
|
|
if err := tV2.UnmarshalJSON(data); err != nil {
|
|
return err
|
|
}
|
|
|
|
*r = *NewRecordFromV2(tV2)
|
|
|
|
return nil
|
|
}
|