net.named_data.jndn.encrypt

Class DecryptorV2

java.lang.Object

net.named_data.jndn.encrypt.DecryptorV2

public class DecryptorV2
extends Object

DecryptorV2 decrypts the supplied EncryptedContent element, using asynchronous operations, contingent on the retrieval of the CK Data packet, the KDK, and the successful decryption of both of these. For the meaning of "KDK", etc. see: https://github.com/named-data/name-based-access-control/blob/new/docs/spec.rst

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	DecryptorV2.ContentKey
static interface	DecryptorV2.DecryptSuccessCallback

Constructor Summary

Constructors

Constructor and Description
DecryptorV2(PibKey credentialsKey, Validator validator, KeyChain keyChain, Face face) Create a DecryptorV2 with the given parameters.

Method Summary

Modifier and Type	Method and Description
void	decrypt(EncryptedContent encryptedContent, DecryptorV2.DecryptSuccessCallback onSuccess, EncryptError.OnError onError) Asynchronously decrypt the encryptedContent.
void	shutdown()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DecryptorV2

public DecryptorV2(PibKey credentialsKey,
                   Validator validator,
                   KeyChain keyChain,
                   Face face)

Create a DecryptorV2 with the given parameters.

Parameters:

credentialsKey - The credentials key to be used to retrieve and decrypt the KDK.

validator - The validation policy to ensure the validity of the KDK and CK.

keyChain - The KeyChain that will be used to decrypt the KDK.

face - The Face that will be used to fetch the CK and KDK.

Method Detail

shutdown

public void shutdown()

decrypt

public final void decrypt(EncryptedContent encryptedContent,
                          DecryptorV2.DecryptSuccessCallback onSuccess,
                          EncryptError.OnError onError)
                   throws IOException

Asynchronously decrypt the encryptedContent.

Parameters:

encryptedContent - The EncryptedContent to decrypt, which must have a KeyLocator with a KEYNAME and and initial vector. This does not copy the EncryptedContent object. If you may change it later, then pass in a copy of the object.

onSuccess - On successful decryption, this calls onSuccess.onSuccess(plainData) where plainData is the decrypted Blob. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

onError - On failure, this calls onError.onError(errorCode, message) where errorCode is from the EncryptError.ErrorCode enum, and message is an error string. NOTE: The library will log any exceptions thrown by this callback, but for better error handling the callback should catch and properly handle any exceptions.

Throws:

IOException