signing

package
v2.0.0-...-98cc131 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jul 26, 2023 License: Apache-2.0 Imports: 25 Imported by: 0

Documentation

Index

Constants

This section is empty.

Variables

Functions

func BaseRootPool

func BaseRootPool() (*x509.CertPool, error)

func CheckIgnoreResourcesWithAccessType

func CheckIgnoreResourcesWithAccessType(t func(string) bool, v interface{}) bool

func CreateAndVerifyX509Certificate

func CreateAndVerifyX509Certificate(cert, intermediateCAsCerts, rootCACert []byte) (*x509.Certificate, error)

CreateAndVerifyX509Certificate creates and verifies a x509 certificate from in-memory raw certificates. The certificates must be in PEM format.

func CreateAndVerifyX509CertificateFromFiles

func CreateAndVerifyX509CertificateFromFiles(certPath, intermediateCAsCertsPath, rootCACertPath string) (*x509.Certificate, error)

CreateAndVerifyX509CertificateFromFiles creates and verifies a x509 certificate from certificate files. The certificates must be in PEM format.

func CreateCertificate

func CreateCertificate(subject pkix.Name, validFrom *time.Time, validity time.Duration,
	pub interface{}, ca *x509.Certificate, priv interface{}, isCA bool, names ...string,
) ([]byte, error)

func GetCertificate

func GetCertificate(data interface{}) (*x509.Certificate, error)

func Hash

func Hash(hash hash.Hash, data []byte) (string, error)

func IgnoreLabelsWithoutSignature

func IgnoreLabelsWithoutSignature(v interface{}) bool

func IgnoreResourcesWithAccessType

func IgnoreResourcesWithAccessType(t string) func(v interface{}) bool

func IgnoreResourcesWithNoneAccess

func IgnoreResourcesWithNoneAccess(v interface{}) bool

func IntermediatePool

func IntermediatePool(pemfile string, fss ...vfs.FileSystem) (*x509.CertPool, error)

func IsLegacyHashAlgorithm

func IsLegacyHashAlgorithm(algo string) bool

func LegacyHashAlgorithm

func LegacyHashAlgorithm(algo string) string

func Normalize

func Normalize(n Normalization, v interface{}, ex ExcludeRules) ([]byte, error)

func NormalizeHashAlgorithm

func NormalizeHashAlgorithm(algo string) string

func ParseCertificate

func ParseCertificate(data []byte) (*x509.Certificate, error)

func ParsePrivateKey

func ParsePrivateKey(data []byte) (interface{}, error)

func ParsePublicKey

func ParsePublicKey(data []byte) (interface{}, error)

func RootPool

func RootPool(pemfile string, useOS bool, fss ...vfs.FileSystem) (*x509.CertPool, error)

func VerifyCert

func VerifyCert(intermediate, root *x509.CertPool, cn string, cert *x509.Certificate) error

Types

type ArrayExcludes

type ArrayExcludes struct {
	Continue ExcludeRules
}

func (ArrayExcludes) Element

func (r ArrayExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (ArrayExcludes) Field

func (r ArrayExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type ConditionalArrayExcludes

type ConditionalArrayExcludes struct {
	ValueChecker  ValueChecker
	ValueMapper   ValueMapper
	ContinueTrue  ExcludeRules
	ContinueFalse ExcludeRules
}

func (ConditionalArrayExcludes) Check

func (r ConditionalArrayExcludes) Check(value interface{}) ExcludeRules

func (ConditionalArrayExcludes) Element

func (r ConditionalArrayExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (ConditionalArrayExcludes) Field

func (r ConditionalArrayExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type ConditionalExclude

type ConditionalExclude struct {
	ValueChecker  ValueChecker
	ValueMapper   ValueMapper
	ContinueTrue  ExcludeRules
	ContinueFalse ExcludeRules
	Name          string
}

func (ConditionalExclude) Check

func (r ConditionalExclude) Check(value interface{}) ExcludeRules

type ConditionalMapExcludes

type ConditionalMapExcludes map[string]*ConditionalExclude

func (ConditionalMapExcludes) Element

func (r ConditionalMapExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (ConditionalMapExcludes) Field

func (r ConditionalMapExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type DefaultedListEntries

type DefaultedListEntries struct {
	Default  interface{}
	Continue ExcludeRules
	Next     ExcludeRules
}

func (DefaultedListEntries) Element

func (r DefaultedListEntries) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (DefaultedListEntries) Field

func (r DefaultedListEntries) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type DefaultedMapFields

type DefaultedMapFields struct {
	// Name of the field for map entries, for lists this field must be left blank.
	Name     string
	Fields   map[string]interface{}
	Continue ExcludeRules
	Next     ExcludeRules
}

DefaultedMapFields can be used to default map fields in maps or lists. For map entries the Name field must be set to the fieldname to default. For list entries the Name field is ignored.

func (DefaultedMapFields) Element

func (r DefaultedMapFields) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (DefaultedMapFields) EnforceEmptyList

func (r DefaultedMapFields) EnforceEmptyList(fields ...string) DefaultedMapFields

func (DefaultedMapFields) EnforceEmptyMap

func (r DefaultedMapFields) EnforceEmptyMap(fields ...string) DefaultedMapFields

func (DefaultedMapFields) EnforceNull

func (r DefaultedMapFields) EnforceNull(fields ...string) DefaultedMapFields

func (DefaultedMapFields) Field

func (r DefaultedMapFields) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type DynamicArrayExcludes

type DynamicArrayExcludes struct {
	ValueChecker ValueChecker
	ValueMapper  ValueMapper
	Continue     ExcludeRules
}

func (DynamicArrayExcludes) Check

func (r DynamicArrayExcludes) Check(value interface{}) bool

func (DynamicArrayExcludes) Element

func (r DynamicArrayExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (DynamicArrayExcludes) Field

func (r DynamicArrayExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type DynamicExclude

type DynamicExclude struct {
	ValueChecker ValueChecker
	ValueMapper  ValueMapper
	Continue     ExcludeRules
	Name         string
}

func (*DynamicExclude) Check

func (r *DynamicExclude) Check(value interface{}) bool

type DynamicInclude

type DynamicInclude struct {
	ValueChecker ValueChecker
	ValueMapper  ValueMapper
	Continue     ExcludeRules
	Name         string
}

func (*DynamicInclude) Check

func (r *DynamicInclude) Check(value interface{}) bool

type DynamicMapExcludes

type DynamicMapExcludes map[string]*DynamicExclude

func (DynamicMapExcludes) Element

func (r DynamicMapExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (DynamicMapExcludes) Field

func (r DynamicMapExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type DynamicMapIncludes

type DynamicMapIncludes map[string]*DynamicInclude

func (DynamicMapIncludes) Element

func (r DynamicMapIncludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (DynamicMapIncludes) Field

func (r DynamicMapIncludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type ExcludeEmpty

type ExcludeEmpty struct {
	ExcludeRules
}

func (ExcludeEmpty) Element

func (e ExcludeEmpty) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (ExcludeEmpty) Field

func (e ExcludeEmpty) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

func (ExcludeEmpty) Filter

func (ExcludeEmpty) Filter(v Normalized) (Normalized, error)

type ExcludeRules

type ExcludeRules interface {
	Field(name string, value interface{}) (string, interface{}, ExcludeRules)
	Element(v interface{}) (bool, interface{}, ExcludeRules)
}

ExcludeRules defines the rules for normalization excludes.

type HandlerRegistry

type HandlerRegistry interface {
	RegisterSignatureHandler(handler SignatureHandler)
	RegisterSigner(algo string, signer Signer)
	RegisterVerifier(algo string, verifier Verifier)
	GetSigner(name string) Signer
	GetVerifier(name string) Verifier
	SignerNames() []string

	RegisterHasher(hasher Hasher)
	GetHasher(name string) Hasher
	HasherNames() []string
}

func DefaultHandlerRegistry

func DefaultHandlerRegistry() HandlerRegistry

func NewHandlerRegistry

func NewHandlerRegistry() HandlerRegistry

type Hasher

type Hasher interface {
	Algorithm() string
	Create() hash.Hash
	Crypto() crypto.Hash
}

Hasher creates a new hash.Hash interface.

type KeyRegistry

type KeyRegistry interface {
	RegisterPublicKey(name string, key interface{})
	RegisterPrivateKey(name string, key interface{})
	GetPublicKey(name string) interface{}
	GetPrivateKey(name string) interface{}
}

func DefaultKeyRegistry

func DefaultKeyRegistry() KeyRegistry

func NewKeyRegistry

func NewKeyRegistry() KeyRegistry

type MapExcludes

type MapExcludes map[string]ExcludeRules

func (MapExcludes) Element

func (r MapExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (MapExcludes) Field

func (r MapExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type MapIncludes

type MapIncludes map[string]ExcludeRules

func (MapIncludes) Element

func (r MapIncludes) Element(v interface{}) (bool, interface{}, ExcludeRules)

func (MapIncludes) Field

func (r MapIncludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type NoExcludes

type NoExcludes struct{}

func (NoExcludes) Element

func (r NoExcludes) Element(value interface{}) (bool, interface{}, ExcludeRules)

func (NoExcludes) Field

func (r NoExcludes) Field(name string, value interface{}) (string, interface{}, ExcludeRules)

type Normalization

type Normalization interface {
	NewArray() Normalized
	NewMap() Normalized
	NewValue(v interface{}) Normalized

	String() string
}

type NormalizationFilter

type NormalizationFilter interface {
	Filter(Normalized) (Normalized, error)
}

type Normalized

type Normalized interface {
	Value() interface{}
	IsEmpty() bool
	Marshal(gap string) ([]byte, error)

	ToString(gap string) string
	String() string
	Formatted() string

	Append(Normalized)
	SetField(name string, value Normalized)
}
var Null Normalized = (*null)(nil)

func Prepare

func Prepare(n Normalization, v interface{}, ex ExcludeRules) (r Normalized, err error)

func PrepareNormalization

func PrepareNormalization(n Normalization, v interface{}, excludes ExcludeRules) (Normalized, error)

type Registry

type Registry interface {
	HandlerRegistry
	KeyRegistry
}

func DefaultRegistry

func DefaultRegistry() Registry

func NewRegistry

func NewRegistry(h HandlerRegistry, k KeyRegistry) Registry

type Signature

type Signature struct {
	Value     string
	MediaType string
	Algorithm string
	Issuer    string
}

func (*Signature) String

func (s *Signature) String() string

type SignatureHandler

type SignatureHandler interface {
	Algorithm() string
	Signer
	Verifier
}

SignatureHandler can create and verify signature of a dedicated type.

type Signer

type Signer interface {
	// Sign returns the signature for the given digest
	Sign(cctx credentials.Context, digest string, hash crypto.Hash, issuer string, privatekey interface{}) (*Signature, error)
	// Algorithm is the name of the finally used signature algorithm.
	// A signer might be registered using a logical name, so there might
	// be multiple signer registration providing the same signature algorithm
	Algorithm() string
}

Signer interface is used to implement different signing algorithms. Each Signer should have a matching Verifier.

type ValueChecker

type ValueChecker func(value interface{}) bool

type ValueMapper

type ValueMapper func(v interface{}) interface{}

type Verifier

type Verifier interface {
	// Verify checks the signature, returns an error on verification failure
	Verify(digest string, hash crypto.Hash, sig *Signature, publickey interface{}) error
	Algorithm() string
}

Verifier interface is used to implement different verification algorithms. Each Verifier should have a matching Signer.

Directories

Path Synopsis
rsa
norm
jcs

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL