iaik.pkcs.pkcs1
Class RSAOaepPSourceParameterSpec

java.lang.Object
  |
  +--iaik.pkcs.pkcs1.PKCS1AlgorithmParameterSpec
        |
        +--iaik.pkcs.pkcs1.RSAOaepPSourceParameterSpec

All Implemented Interfaces:

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 ::= AlgorithmIdentifer { {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

static AlgorithmID	DEFAULT_PSOURCE_ALGORITHM Default PSourceAlgorithm (id-pSpecified).
protected AlgorithmID	pSourceAlgorithm_ PSourceAlgorithm.

Constructor Summary

RSAOaepPSourceParameterSpec(AlgorithmID pSourceAlgorithm)
Creates a RSAOaepPSourceParameterSpec for the given PSourceAlgorithm.

Method Summary

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.
void	setLabel(byte[] label) Sets the value of the label parameter.
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, equals, finalize, getClass, hashCode, 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(AlgorithmID pSourceAlgorithm)

Creates a RSAOaepPSourceParameterSpec for the given PSourceAlgorithm.

Parameters:

pSourceAlgorithm - the PSourceAlgorithm to be used.

Throws:

IllegalArgumentException - pSourceAlgorithm is null

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:

NullPointerException - if the PSourceAlgorithm is not set

toString

public String toString()

Gets a String representation of this RSAOaepPSourceParameterSpec.

Overrides:

toString in class Object

Returns:

a string representation of this RSAOaepPSourceParameterSpec