iaik.pkcs.pkcs1

Class RSAOaepPSourceParameterSpec

java.lang.Object

iaik.pkcs.pkcs1.PKCS1AlgorithmParameterSpec

iaik.pkcs.pkcs1.RSAOaepPSourceParameterSpec

All Implemented Interfaces:

java.security.spec.AlgorithmParameterSpec

Direct Known Subclasses:

RSAOaepParameterSpec

public class RSAOaepPSourceParameterSpec
extends PKCS1AlgorithmParameterSpec

Parameter specification to may be used for specifying the PSourceAlgorithm parameter for the PKCS#1v2.1 RSAES-OAEP encryption algorithm.

According PKCS#1v2.1 RSASES-OAEP parameters consist of hash algorithm id, mask generation function id, and PSourceAlgorithm:

 RSASES-OAEP-params :: = SEQUENCE {
      hashAlgorithm            [0] HashAlgorithm     DEFAULT sha1,
      maskGenerationAlgorithm  [1] MaskGenAlgorithm  DEFAULT mgf1SHA1,
      pSourceAlgorithm         [2] PSourceAlgorithm  DEFAULT pSpecifiedEmpty,
 }

 HashAlgorithm ::= Algorithmidentifier { {OAEP-PSSDigestAlgorithms} }

 MaskGenAlgorithm ::= AlgorithmIdentifier { {PKCS1MGFAlgorithms} }

 PSourceAlgorithm ::= AlgorithmIdentifier { {PKCS1PSourceAlgorithms} }
 

By default OAEP uses SHA-1 as hash function, MGF1 (with SHA-1 as hash function parameter) as mask generation algorithm, and id-pSpecified as PSourceAlgorithm (with an empty OCTET STRING as parameter).
The Java Cryptography Extensions (JCE), however, only may allow to set the PSourceAlgorithm as parameter. All other parameters are specified by the padding name of the transformation string when instantiating a RSA Cipher engine, e.g.:

 Cipher cipher = Cipher.getInstance("RSA/ECB/OAEPWithSHA1AndMGF1Padding");
 RSAOaepPSourceParameterSpec paramSpec = new RSAOaepPSourceParameterSpec((AlgorithmID)AlgorithmID.pSpecified.clone());
 byte[] label = ...;
 paramSpec.setLabel(label);
 rsa.init(Cipher.ENCRYPT_MODE, publicKey, paramSpec);
 byte[] encrypted = rsa.doFinal(data);
 

An OAEP padding scheme that implements the, for instance, "OAEPWithSHA1AndMGF1Padding" (in general: OAEPWith<digest>And<mgf>Padding) has to use SHA-1 as hash- and MGF1 as mask generation algorithm.

Version:

File Revision 9

Field Summary

Fields

Modifier and Type	Field and Description
static AlgorithmID	DEFAULT_PSOURCE_ALGORITHM Default PSourceAlgorithm (id-pSpecified).
protected AlgorithmID	pSourceAlgorithm_ PSourceAlgorithm.

Constructor Summary

Constructors

Constructor and Description
RSAOaepPSourceParameterSpec() Default constructor.
RSAOaepPSourceParameterSpec(AlgorithmID pSourceAlgorithm) Creates a RSAOaepPSourceParameterSpec for the given PSourceAlgorithm.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	equals(java.lang.Object obj) Compares this RSAOaepPSourceParameterSpec object with the supplied object.
static RSAOaepPSourceParameterSpec	getDefault() Creates a RSAOaepPSourceParameterSpec with the default PSourceAlgorithm id-pSpecified with empty OCTET STRING parameter.
byte[]	getLabel() Returns the value of the label parameter, if set.
AlgorithmID	getPSourceAlgorithm() Gets the PSourceAlgorithm.
int	hashCode() Gets a hash code for this object.
void	setLabel(byte[] label) Sets the value of the label parameter.
java.lang.String	toString() Gets a String representation of this RSAOaepPSourceParameterSpec.

Methods inherited from class iaik.pkcs.pkcs1.PKCS1AlgorithmParameterSpec

getSecureRandom, setSecureRandom

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

DEFAULT_PSOURCE_ALGORITHM

public static final AlgorithmID DEFAULT_PSOURCE_ALGORITHM

Default PSourceAlgorithm (id-pSpecified).

pSourceAlgorithm_

protected AlgorithmID pSourceAlgorithm_

PSourceAlgorithm.

Constructor Detail

RSAOaepPSourceParameterSpec

public RSAOaepPSourceParameterSpec()

Default constructor. Creates a RSAOaepPSourceParameterSpec with default PSourceAlgorithm id-pSpecified with empty OCTET STRING parameter.

RSAOaepPSourceParameterSpec

public RSAOaepPSourceParameterSpec(AlgorithmID pSourceAlgorithm)

Creates a RSAOaepPSourceParameterSpec for the given PSourceAlgorithm.

Parameters:

pSourceAlgorithm - the PSourceAlgorithm to be used.

Throws:

java.lang.IllegalArgumentException - pSourceAlgorithm is null or contains invalid parameters

Method Detail

getDefault

public static RSAOaepPSourceParameterSpec getDefault()

Creates a RSAOaepPSourceParameterSpec with the default PSourceAlgorithm id-pSpecified with empty OCTET STRING parameter.

Returns:

the default RSAOaepPSourceParameterSpec

getPSourceAlgorithm

public AlgorithmID getPSourceAlgorithm()

Gets the PSourceAlgorithm.

Returns:

the PSourceAlgorithm

getLabel

public byte[] getLabel()

Returns the value of the label parameter, if set.

Returns:

the value (maybe an empty byte array) of the label parameter, if included; otherwise null

setLabel

public void setLabel(byte[] label)

Sets the value of the label parameter.

Parameters:

label - the value of the label parameter

Throws:

java.lang.NullPointerException - if the PSourceAlgorithm is not set

hashCode

public int hashCode()

Gets a hash code for this object.

Overrides:

hashCode in class java.lang.Object

Returns:

the hash code

equals

public boolean equals(java.lang.Object obj)

Compares this RSAOaepPSourceParameterSpec object with the supplied object.

Overrides:

equals in class java.lang.Object

Parameters:

obj - the object to be compared

Returns:

true if the two objects are equal false otherwise

toString

public java.lang.String toString()

Gets a String representation of this RSAOaepPSourceParameterSpec.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of this RSAOaepPSourceParameterSpec