Digital Authentication Framework
6.0.1.37
|
This implements DAKey in a basic sense, but returns errors for all crypto/storage calls. More...
Public Member Functions | |
DAMechanism[] | getMechanisms () |
Get the list of supported mechanisms. More... | |
void | encrypt (DAMessage msg) throws DAError |
Encrypt the message returned by msg.getPlaintext(), and place the result in msg. More... | |
void | decrypt (DAMessage msg) throws DAError |
Decrypt the ciphertext returned by msg.getCiphertext(), and place the plaintext in msg using msg.setPlaintext(). More... | |
void | sign (DAMessage msg) throws DAError |
Sign the message returned by msg.getPlaintext(), and place the signature in msg. More... | |
void | verify (DAMessage msg) throws DAError |
Verify the message returned by msg.getPlaintext() against the signature returned by msg.getCiphertext(). More... | |
byte[] | getData () throws DAError |
Returns the contents of a storage-only key. More... | |
void | setData (byte[] data) throws DAError |
Sets the contents of a storage-only key. More... | |
void | generateMaterial () throws DAError |
Regenerate underlying key material. More... | |
Public Member Functions inherited from com.good.daf.DAKey | |
DAMetaData | getInfo () |
Get information about this instance. More... | |
This implements DAKey in a basic sense, but returns errors for all crypto/storage calls.
This is a good base to build a real DAKey implementation, because you only need implement the methods you are interested in.
It does not provide the getInfo call, so is abstract.
Decrypt the ciphertext returned by msg.getCiphertext(), and place the plaintext in msg using msg.setPlaintext().
msg.getMechanism() will always return non-null here, specifying what decryption mechanism to use.
msg | the object containing the message ciphertext (on entry) and plaintext (on exit) |
DAError | on failure |
Implements com.good.daf.DAKey.
Encrypt the message returned by msg.getPlaintext(), and place the result in msg.
If msg.getMechanism() returns non-null, you should try to use that mechanism. If it is not supported, throw DAError.MechNotSupported.
If msg.getMechanism() returns null, choose an appropriate mechanism and call msg.setMechanism() to note your choice.
Place the ciphertext in msg using msg.setCiphertext(), and any IV likewise using msg.setIV().
msg | the object containing the message plaintext (on entry) and ciphertext (on exit) |
DAError | on failure |
Implements com.good.daf.DAKey.
void com.good.daf.basic.BasicKey.generateMaterial | ( | ) | throws DAError |
Regenerate underlying key material.
DAF calls this to roll over the key material. The type and capabilities of the key should remain the same. Class 1 implementations may throw DAError.NotImplemented in which case DAF will use setData() instead.
DAError | on failure |
Implements com.good.daf.DAKey.
byte [] com.good.daf.basic.BasicKey.getData | ( | ) | throws DAError |
Returns the contents of a storage-only key.
DAError | on failure |
Implements com.good.daf.DAKey.
DAMechanism [] com.good.daf.basic.BasicKey.getMechanisms | ( | ) |
Get the list of supported mechanisms.
This method is not allowed to fail except fatally (OutOfMemoryError, etc.).
Implements com.good.daf.DAKey.
void com.good.daf.basic.BasicKey.setData | ( | byte[] | data | ) | throws DAError |
Sets the contents of a storage-only key.
data | the new data to write to the storage. Never null. |
DAError | on failure |
Implements com.good.daf.DAKey.
Sign the message returned by msg.getPlaintext(), and place the signature in msg.
If msg.getMechanism() returns non-null, you should try to use that mechanism. If it is not supported, throw DAError.MechNotSupported.
If msg.getMechanism() returns null, choose an appropriate mechanism and call msg.setMechanism() to note your choice.
Place the signature in msg using msg.setCiphertext(), and any IV or nonce likewise using msg.setIV().
msg | the object containing the message plaintext (on entry) and signature (on exit) |
DAError | on failure |
Implements com.good.daf.DAKey.
Verify the message returned by msg.getPlaintext() against the signature returned by msg.getCiphertext().
msg.getMechanism() will always return non-null here, specifying what signature verification mechanism to use.
If the signature is invalid, throw DAError.VerifyFailed.
msg | the object containing the message plaintext and signature |
DAError | on failure |
Implements com.good.daf.DAKey.