DSAKey



javacard.security
Interface DSAKey

All Known Subinterfaces:
DSAPrivateKey, DSAPublicKey
All Known Implementing Classes:
DSAKeyImpl, DSAPrivateKeyImpl, DSAPublicKeyImpl

public interface DSAKey

The DSAKey interface is the base interface for the DSA algorithm's private and public key implementations. A DSA private key implementation must also implement the DSAPrivateKey interface methods. A DSA public key implementation must also implement the DSAPublicKey interface methods.

When all four components of the key (X or Y,P,Q,G) are set, the key is initialized and ready for use.

See Also:
DSAPublicKey, DSAPrivateKey, KeyBuilder, Signature, KeyEncryption

Method Summary
 short getG(byte[] buffer, short offset)
          Returns the base parameter value of the key in plain text.
 short getP(byte[] buffer, short offset)
          Returns the prime parameter value of the key in plain text.
 short getQ(byte[] buffer, short offset)
          Returns the subprime parameter value of the key in plain text.
 void setG(byte[] buffer, short offset, short length)
          Sets the base parameter value of the key.
 void setP(byte[] buffer, short offset, short length)
          Sets the prime parameter value of the key.
 void setQ(byte[] buffer, short offset, short length)
          Sets the subprime parameter value of the key.
 

Method Detail

setP

void setP(byte[] buffer,
          short offset,
          short length)
          throws CryptoException
Sets the prime parameter value of the key. The plain text data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte). Input prime parameter data is copied into the internal representation.

Note:

  • If the key object implements the javacardx.crypto.KeyEncryption interface and the Cipher object specified via setKeyCipher() is not null, the prime parameter value is decrypted using the Cipher object.

Parameters:
buffer - the input buffer
offset - the offset into the input buffer at which the prime parameter value begins
length - the length of the prime parameter value
Throws:
CryptoException - with the following reason code:
  • CryptoException.ILLEGAL_VALUE if the input parameter data length is inconsistent with the implementation or if input data decryption is required and fails.

setQ

void setQ(byte[] buffer,
          short offset,
          short length)
          throws CryptoException
Sets the subprime parameter value of the key. The plain text data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte). Input subprime parameter data is copied into the internal representation.

Note:

  • If the key object implements the javacardx.crypto.KeyEncryption interface and the Cipher object specified via setKeyCipher() is not null, the subprime parameter value is decrypted using the Cipher object.

Parameters:
buffer - the input buffer
offset - the offset into the input buffer at which the subprime parameter value begins
length - the length of the subprime parameter value
Throws:
CryptoException - with the following reason code:
  • CryptoException.ILLEGAL_VALUE if the input parameter data length is inconsistent with the implementation or if input data decryption is required and fails.

setG

void setG(byte[] buffer,
          short offset,
          short length)
          throws CryptoException
Sets the base parameter value of the key. The plain text data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte). Input base parameter data is copied into the internal representation.

Note:

  • If the key object implements the javacardx.crypto.KeyEncryption interface and the Cipher object specified via setKeyCipher() is not null, the base parameter value is decrypted using the Cipher object.

Parameters:
buffer - the input buffer
offset - the offset into the input buffer at which the base parameter value begins
length - the length of the base parameter value
Throws:
CryptoException - with the following reason code:
  • CryptoException.ILLEGAL_VALUE if the input parameter data length is inconsistent with the implementation or if input data decryption is required and fails.

getP

short getP(byte[] buffer,
           short offset)
           throws CryptoException
Returns the prime parameter value of the key in plain text. The data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte).

Parameters:
buffer - the output buffer
offset - the offset into the output buffer at which the prime parameter value starts
Returns:
the byte length of the prime parameter value returned
Throws:
CryptoException - with the following reason code:
  • CryptoException.UNINITIALIZED_KEY if the prime parameter has not been successfully initialized since the time the initialized state of the key was set to false.
See Also:
Key

getQ

short getQ(byte[] buffer,
           short offset)
           throws CryptoException
Returns the subprime parameter value of the key in plain text. The data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte).

Parameters:
buffer - the output buffer
offset - the offset into the output buffer at which the subprime parameter value begins
Returns:
the byte length of the subprime parameter value returned
Throws:
CryptoException - with the following reason code:
  • CryptoException.UNINITIALIZED_KEY if the subprime parameter has not been successfully initialized since the time the initialized state of the key was set to false.
See Also:
Key

getG

short getG(byte[] buffer,
           short offset)
           throws CryptoException
Returns the base parameter value of the key in plain text. The data format is big-endian and right-aligned (the least significant bit is the least significant bit of last byte).

Parameters:
buffer - the output buffer
offset - the offset into the output buffer at which the base parameter value begins
Returns:
the byte length of the base parameter value returned
Throws:
CryptoException - with the following reason code:
  • CryptoException.UNINITIALIZED_KEY if the base parameter has not been successfully initialized since the time the initialized state of the key was set to false.
See Also:
Key