Package javacard.security
Interface DSAKey
-
- All Known Subinterfaces:
DSAPrivateKey
,DSAPublicKey
public interface DSAKey
TheDSAKey
interface is the base interface for the DSA algorithm's private and public key implementations. A DSA private key implementation must also implement theDSAPrivateKey
interface methods. A DSA public key implementation must also implement theDSAPublicKey
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.
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description 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 theCipher
object specified viasetKeyCipher()
is notnull
, the prime parameter value is decrypted using theCipher
object.
- Parameters:
buffer
- the input bufferoffset
- the offset into the input buffer at which the prime parameter value beginslength
- 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.
- If the key object implements the
-
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 theCipher
object specified viasetKeyCipher()
is notnull
, the subprime parameter value is decrypted using theCipher
object.
- Parameters:
buffer
- the input bufferoffset
- the offset into the input buffer at which the subprime parameter value beginslength
- 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.
- If the key object implements the
-
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 theCipher
object specified viasetKeyCipher()
is notnull
, the base parameter value is decrypted using theCipher
object.
- Parameters:
buffer
- the input bufferoffset
- the offset into the input buffer at which the base parameter value beginslength
- 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.
- If the key object implements the
-
getP
short getP(byte[] buffer, short offset)
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 bufferoffset
- 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)
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 bufferoffset
- 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)
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 bufferoffset
- 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
-
-