|
Java Card v2.2.2 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface HMACKey
HMACKey
contains a key for HMAC operations. This key can be of
any length, but it is strongly recommended that the key is not shorter than the
byte length of the hash output used in the HMAC implementation.
Keys with length greater than the hash block length are first hashed with the
hash algorithm used for the HMAC implementation.
Implementations must support an HMAC key length equal to the length of the supported hash algorithm block size (e.g 64 bits for SHA-1)
When the key data is set, the key is initialized and ready for use.
KeyBuilder
,
Signature
,
javacardx.crypto.Cipher
,
javacardx.crypto.KeyEncryption
Method Summary | |
---|---|
byte |
getKey(byte[] keyData,
short kOff)
Returns the Key data in plain text. |
void |
setKey(byte[] keyData,
short kOff,
short kLen)
Sets the Key data. |
Methods inherited from interface javacard.security.Key |
---|
clearKey, getSize, getType, isInitialized |
Method Detail |
---|
void setKey(byte[] keyData, short kOff, short kLen) throws CryptoException, NullPointerException, ArrayIndexOutOfBoundsException
Key
data.
The data format is big-endian and right-aligned (the least significant bit is the least significant
bit of last byte). Input key data is copied into the internal representation.
Note:
javacardx.crypto.KeyEncryption
interface and the Cipher
object specified via setKeyCipher()
is not null
, keyData
is decrypted using the Cipher
object.
keyData
- byte array containing key initialization datakOff
- offset within keyData to startkLen
- the byte length of the key initialization data
CryptoException
- with the following reason code:CryptoException.ILLEGAL_VALUE
if input data decryption is required and fails.ArrayIndexOutOfBoundsException
- if kOff
is negative
or the keyData
array is too short
NullPointerException
- if the keyData
parameter is null
byte getKey(byte[] keyData, short kOff)
Key
data in plain text. The key can be any length, but
should be longer than the byte length of the hash algorithm output used. The data
format is big-endian and right-aligned (the least significant bit is the least
significant bit of last byte).
keyData
- byte array to return key datakOff
- offset within keyData
to start
CryptoException
- with the following reason code:CryptoException.UNINITIALIZED_KEY
if the key data has not been
successfully initialized since the
time the initialized state of the key was set to false.
Key
|
Java Card v2.2.2 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |