Crypto.WebAuthn.Cose.Internal.Verify

public keys and signature algorithms are represented with three different types:

• CoseSignAlg, which is the signature algorithm used, equivalent to a COSE Algorithm from the COSE registry
• CosePublicKey, which is a combination of a CoseSignAlg along with a public key that can be used with it. This is what the COSE_Key CBOR structure decodes to
• PublicKey, only the public key part of CosePublicKey

The following main operations are supported for these types:

• CosePublicKey can be totally decomposed into a CoseSignAlg with keySignAlg and a PublicKey with fromCose
• A PublicKey can be created from an X.509 public key with fromX509
• A CoseSignAlg and a PublicKey can be used to verify a signature with verify

Public Key

data PublicKey

Same as CosePublicKey, but without signature algorithm parameters, i.e. hash algorithms.

Constructors

PublicKeyEdDSA

See CosePublicKeyEdDSA

Fields

• eddsaCurve :: CoseCurveEdDSA

  (spec) The elliptic curve to use

• eddsaX :: ByteString

  (spec) This contains the public key bytes

PublicKeyECDSA

See CosePublicKeyECDSA

Fields

• ecdsaCurve :: CoseCurveECDSA

  (spec) The elliptic curve to use

• ecdsaX :: ByteString

  (spec) This contains the x-coordinate for the EC point. The integer is converted to a byte string as defined in [SEC1]. Leading zero octets MUST be preserved.

• ecdsaY :: ByteString

  (spec) This contains the value of the y-coordinate for the EC point. When encoding the value y, the integer is converted to an byte string (as defined in SEC1) and encoded as a CBOR bstr. Leading zero octets MUST be preserved.

PublicKeyRSA

See CosePublicKeyRSA

Fields

• rsaN :: Integer

  (spec) The RSA modulus n is a product of u distinct odd primes r_i, i = 1, 2, ..., u, where u >= 2

• rsaE :: Integer

  (spec) The RSA public exponent e is an integer between 3 and n - 1 satisfying GCD(e,\lambda(n)) = 1, where \lambda(n) = LCM(r_1 - 1, ..., r_u - 1)

Instances

Eq PublicKey

Defined in Crypto.WebAuthn.Cose.Internal.Verify

Methods

(==) :: PublicKey -> PublicKey -> Bool

(/=) :: PublicKey -> PublicKey -> Bool

Show PublicKey

Defined in Crypto.WebAuthn.Cose.Internal.Verify

Methods

showsPrec :: Int -> PublicKey -> ShowS

show :: PublicKey -> String

showList :: [PublicKey] -> ShowS

Generic PublicKey

Defined in Crypto.WebAuthn.Cose.Internal.Verify

Associated Types

type Rep PublicKey :: Type -> Type

Methods

from :: PublicKey -> Rep PublicKey x

to :: Rep PublicKey x -> PublicKey

ToJSON PublicKey

Defined in Crypto.WebAuthn.Cose.Internal.Verify

Methods

toJSON :: PublicKey -> Value

toEncoding :: PublicKey -> Encoding

toJSONList :: [PublicKey] -> Value

toEncodingList :: [PublicKey] -> Encoding

type Rep PublicKey

Defined in Crypto.WebAuthn.Cose.Internal.Verify

type Rep PublicKey = D1 ('MetaData "PublicKey" "Crypto.WebAuthn.Cose.Internal.Verify" "webauthn-0.1.1.0-inplace" 'False) (C1 ('MetaCons "PublicKeyEdDSA" 'PrefixI 'True) (S1 ('MetaSel ('Just "eddsaCurve") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 CoseCurveEdDSA) :*: S1 ('MetaSel ('Just "eddsaX") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByteString)) :+: (C1 ('MetaCons "PublicKeyECDSA" 'PrefixI 'True) (S1 ('MetaSel ('Just "ecdsaCurve") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 CoseCurveECDSA) :*: (S1 ('MetaSel ('Just "ecdsaX") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByteString) :*: S1 ('MetaSel ('Just "ecdsaY") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 ByteString))) :+: C1 ('MetaCons "PublicKeyRSA" 'PrefixI 'True) (S1 ('MetaSel ('Just "rsaN") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Integer) :*: S1 ('MetaSel ('Just "rsaE") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedLazy) (Rec0 Integer))))

fromCose :: CosePublicKey -> PublicKey

Turns a CosePublicKey into a PublicKey by removing the hash functions

fromX509 :: PubKey -> Either Text PublicKey

Turns a X.509 certificates PubKey into a PublicKey

Signature verification

verify :: CoseSignAlg -> PublicKey -> ByteString -> ByteString -> Either Text ()

Verifies an asymmetric signature for a message using a CoseSignAlg and a PublicKey. Returns an error if the signature algorithm doesn't match. Also returns an error if the signature wasn't valid or for other errors.

Hash Conversions to cryptonite types

data SomeHashAlgorithm

Some cryptonite HashAlgorithm type, used as a return value of toCryptHashECDSA

Constructors

forall a.HashAlgorithm a => SomeHashAlgorithm a

toCryptHashECDSA :: CoseHashAlgECDSA -> SomeHashAlgorithm

Returns the cryptonite SomeHashAlgorithm corresponding to this hash algorithm

data SomeHashAlgorithmASN1

Some cryptonite HashAlgorithmASN1 type, used as a return value of toCryptHashRSA

Constructors

forall a.HashAlgorithmASN1 a => SomeHashAlgorithmASN1 a

toCryptHashRSA :: CoseHashAlgRSA -> SomeHashAlgorithmASN1

Returns the cryptonite SomeHashAlgorithmASN1 corresponding to this hash algorithm

Conversions from/to cryptonite elliptic curves

toCryptCurveECDSA :: CoseCurveECDSA -> CurveName

Converts a CoseCurveECDSA to an CurveName. The inverse function is fromCryptCurveECDSA

fromCryptCurveECDSA :: CurveName -> Either Text CoseCurveECDSA

Tries to converts a CurveName to an CoseCurveECDSA. The inverse function is toCryptCurveECDSA