archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-26 22:34:27 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8284553: Deprecate the DEFAULT static field of OAEPParameterSpec

Browse source 
Reviewed-by: mullan
This commit is contained in:
Valerie Peng 2022-04-20 17:23:06 +00:00
parent e8016f7443
commit 15ce8c6195
2 changed files with 35 additions and 38 deletions
Download patch file Download diff file Expand all files Collapse all files

67
src/java.base/share/classes/javax/crypto/spec/OAEPParameterSpec.java
View file

@ -71,13 +71,6 @@ import java.security.spec.MGF1ParameterSpec;
* }
* EncodingParameters ::= OCTET STRING(SIZE(0..MAX))
* </pre>
* <p>Note: the OAEPParameterSpec.DEFAULT uses the following:
* <pre>
* message digest -- "SHA-1"
* mask generation function (mgf) -- "MGF1"
* parameters for mgf -- MGF1ParameterSpec.SHA1
* source of encoding input -- PSource.PSpecified.DEFAULT
* </pre>
*
* @see java.security.spec.MGF1ParameterSpec
* @see PSource
@ -88,39 +81,49 @@ import java.security.spec.MGF1ParameterSpec;
*/
public class OAEPParameterSpec implements AlgorithmParameterSpec {
private String mdName = "SHA-1";
private String mgfName = "MGF1";
private AlgorithmParameterSpec mgfSpec = MGF1ParameterSpec.SHA1;
private PSource pSrc = PSource.PSpecified.DEFAULT;
private final String mdName;
private final String mgfName;
private final AlgorithmParameterSpec mgfSpec;
private final PSource pSrc;
/**
* The OAEP parameter set with all default values.
* The OAEP parameter set with all default values, i.e. "SHA-1" as message
* digest algorithm, "MGF1" as mask generation function (mgf) algorithm,
* {@code MGF1ParameterSpec.SHA1} as parameters for the mask generation
* function, and {@code PSource.PSpecified.DEFAULT} as the source of the
* encoding input.
*
* @deprecated This field uses the default values defined in the PKCS #1
* standard. Some of these defaults are no longer recommended due
* to advances in cryptanalysis -- see
* <a href="https://www.rfc-editor.org/rfc/rfc8017#appendix-B.1">Appendix B.1 of PKCS #1</a>
* for more details. Thus, it is recommended to create
* a new {@code OAEPParameterSpec} with the desired parameter values
* using the
* {@link #OAEPParameterSpec(String, String, AlgorithmParameterSpec, PSource)} constructor.
*
*/
public static final OAEPParameterSpec DEFAULT = new OAEPParameterSpec();
/**
* Constructs a parameter set for OAEP padding as defined in
* the PKCS #1 standard using the default values.
*/
private OAEPParameterSpec() {
}
@Deprecated(since="19")
public static final OAEPParameterSpec DEFAULT = new OAEPParameterSpec(
"SHA-1", "MGF1", MGF1ParameterSpec.SHA1,
PSource.PSpecified.DEFAULT);
/**
* Constructs a parameter set for OAEP padding as defined in
* the PKCS #1 standard using the specified message digest
* algorithm <code>mdName</code>, mask generation function
* algorithm <code>mgfName</code>, parameters for the mask
* generation function <code>mgfSpec</code>, and source of
* the encoding input P <code>pSrc</code>.
* algorithm {@code mdName}, mask generation function
* algorithm {@code mgfName}, parameters for the mask
* generation function {@code mgfSpec}, and source of
* the encoding input P {@code pSrc}.
*
* @param mdName the algorithm name for the message digest.
* @param mgfName the algorithm name for the mask generation
* function.
* @param mgfSpec the parameters for the mask generation function.
* If null is specified, null will be returned by getMGFParameters().
* @param pSrc the source of the encoding input P.
* @exception NullPointerException if <code>mdName</code>,
* <code>mgfName</code>, or <code>pSrc</code> is null.
* @param mdName the algorithm name for the message digest
* @param mgfName the algorithm name for the mask generation function
* @param mgfSpec the parameters for the mask generation function;
* if {@code null} is specified, {@code null} will be returned by
* {@link #getMGFParameters()}
* @param pSrc the source of the encoding input P
* @throws NullPointerException if {@code mdName},
* {@code mgfName}, or {@code pSrc} is {@code null}
*/
public OAEPParameterSpec(String mdName, String mgfName,
AlgorithmParameterSpec mgfSpec,