
SymmetricDecryption |
ptolemy.actor.lib.security.SymmetricDecryption |
Decrypt an unsigned byte array using a symmetric algorithm.
<p>See <a href="../../../../ptolemy/actor/lib/security/SymmetricEncryption.xml">ptolemy.actor.lib.security.SymmetricEncryption</a> for a
description of symmetric vs. asymmetric algorithms.
<p>This actor reads an unsigned byte array at the <i>input</i> port,
decrypts the data using the data from the <i>key</i> port and then
writes the unsigned byte array results to the <i>output</i> port.
<p>The <i>key</i> should be the same for both the SymmetricEncryption
actor and this actor.
The <i>algorithm</i> parameter determines which algorithm is used.
The algorithm specified must be symmetric. The mode and padding can also
be specified in the <i>mode</i> and <i>padding</i> parameters. In
case a provider specific instance of an algorithm is needed the
provider may also be specified in the <i>provider</i> parameter.
<p>Note that for simplicity, this actor does not support the
notion of algorithm parameters, so the algorithm must not require
that algorithm parameters be transmitted separately from the key.
If the user selects an algorithm that uses algorithm parameters, then
an exception will likely be thrown.
<p>This actor relies on the Java Cryptography Architecture (JCA) and Java
Cryptography Extension (JCE). See the
<a href="../../../../ptolemy/actor/lib/security/CryptographyActor.xml">ptolemy.actor.lib.security.CryptographyActor</a> documentation for
resources about JCA and JCE.
Author(s): Christopher Hylands Brooks, Contributor: Rakesh Reddy
Version:$Id: SymmetricDecryption.doc.html,v 1.1 2006/02/22 18:42:26 mangal Exp $
Pt.Proposed Rating:Green (cxh)
Pt.Accepted Rating:Yellow (cxh)
key
The key port. This port contains the key that is used to
decrypt data from the <i>input</i> port. The type is KeyToken
that contains a java.security.key