Class ChipAuthentication

Object
   |
   +--ChipAuthentication

class ChipAuthentication

This class implements the ChipAuthentication protocol
Defined in chipauthentication.js

Field Detail

algo

Object algo

crypto

Object crypto

domparam

Object domparam

includeDPinAuthToken

Object includeDPinAuthToken

noPadding

Object noPadding

id_CA_ECDH_3DES_CBC_CBC

<static> Object id_CA_ECDH_3DES_CBC_CBC

id_CA_ECDH_AES_CBC_CMAC_128

<static> Object id_CA_ECDH_AES_CBC_CMAC_128

id_CA_ECDH_AES_CBC_CMAC_192

<static> Object id_CA_ECDH_AES_CBC_CMAC_192

id_CA_ECDH_AES_CBC_CMAC_256

<static> Object id_CA_ECDH_AES_CBC_CMAC_256

standardizedDomainParameter

<static> Object standardizedDomainParameter

ChipAuthentication

ChipAuthentication(<Crypto> crypto, <ByteString> algo, <Key> domparam)

Create a ChipAuthentication protocol object

Parameters:
crypto - the crypto provider
algo - the algorithm OID
domparam - the key object holding ECC domain parameter

calculateAuthenticationToken

Boolean calculateAuthenticationToken()

Calculate the authentication token over the public key received from the other side

Parameters:
the - MAC over the authentication data

Returns:
true if the MAC is valid

decodeEphemeralPublicKey

ByteString decodeEphemeralPublicKey(encodedKey)

Decodes the ephemeral public key

Returns:
the decoded public key

deriveKey

Key deriveKey(<ByteString> input, <Number> counter, nonce)

Derive key from input parameter, counter and optional nonce

Parameters:
input - the first part of the hash input
counter - the counter value
the - optional nonce inserted between the input and the counter

Returns:
the key object

generateEphemeralCAKeyPair

void generateEphemeralCAKeyPair()

Generate ephemeral key pair

getCompressedPublicKey

ByteString getCompressedPublicKey()

Returns the x coordinate of the public key

Returns:
the encoded public key

getEphemeralPublicKey

ByteString getEphemeralPublicKey()

Returns the ephemeral public key

Returns:
the encoded public key

performKeyAgreement

void performKeyAgreement(<ByteString> publicKey, nonce)

Performs the mapping operation with mapping data from the other side

Parameters:
publicKey - the public key in encoded format

setKeyPair

void setKeyPair(<Key> prk, <Key> puk)

Set chip authentication keys

Parameters:
prk - the private key
puk - the public key

verifyAuthenticationToken

Boolean verifyAuthenticationToken(authToken)

Calculate and verify the authentication token over the public key received from the other side

Parameters:
the - MAC over the authentication data

Returns:
true if the MAC is valid

encodePublicKey

<static> Object encodePublicKey(<String> oid, <Key> key, <Boolean> withDP)

Encode an ECC public key in the format defined by the EAC 2.0 specification

Parameters:
oid - the object identifier to encode
key - the EC public key
withDP - true to encode domain parameter as well

stripLeadingZeros

<static> ByteString stripLeadingZeros(<ByteString> value)

Strips leading zeros of a ByteString

Parameters:
value - the ByteString value

Returns:
the stripped ByteString object, may be an empty ByteString