com.tencent.kona.sun.security.x509

Class AlgIdDSA

java.lang.Object

com.tencent.kona.sun.security.x509.AlgorithmId

com.tencent.kona.sun.security.x509.AlgIdDSA

All Implemented Interfaces:

com.tencent.kona.sun.security.util.DerEncoder, java.io.Serializable, java.security.interfaces.DSAParams

public final class AlgIdDSA
extends com.tencent.kona.sun.security.x509.AlgorithmId
implements java.security.interfaces.DSAParams

This class identifies DSS/DSA Algorithm variants, which are distinguished by using different algorithm parameters P, Q, G. It uses the NIST/IETF standard DER encoding. These are used to implement the Digital Signature Standard (DSS), FIPS 186.

NOTE: DSS/DSA Algorithm IDs may be created without these parameters. Use of DSS/DSA in modes where parameters are either implicit (e.g. a default applicable to a site or a larger scope), or are derived from some Certificate Authority's DSS certificate, is not supported directly. The application is responsible for creating a key containing the required parameters prior to using the key in cryptographic operations. The follwoing is an example of how this may be done assuming that we have a certificate called currentCert which doesn't contain DSS/DSA parameters and we need to derive DSS/DSA parameters from a CA's certificate called caCert.

 // key containing parameters to use
 DSAPublicKey cAKey = (DSAPublicKey)(caCert.getPublicKey());
 // key without parameters
 DSAPublicKey nullParamsKey = (DSAPublicKey)(currentCert.getPublicKey());

 DSAParams cAKeyParams = cAKey.getParams();
 KeyFactory kf = KeyFactory.getInstance("DSA");
 DSAPublicKeySpec ks = new DSAPublicKeySpec(nullParamsKey.getY(),
                                            cAKeyParams.getP(),
                                            cAKeyParams.getQ(),
                                            cAKeyParams.getG());
 DSAPublicKey usableKey = kf.generatePublic(ks);
 

See Also:

DSAParams, DSAPublicKey, KeyFactory, DSAPublicKeySpec, Serialized Form

Field Summary

Fields inherited from class com.tencent.kona.sun.security.x509.AlgorithmId

DSA_oid, EC_oid, ed25519_oid, ed448_oid, encodedParams, MD2_oid, MD2withRSA_oid, MD5_oid, MD5withRSA_oid, MGF1_oid, RSAEncryption_oid, RSASSA_PSS_oid, SHA_oid, SHA1withECDSA_oid, SHA1withRSA_oid, SHA224_oid, SHA224withECDSA_oid, SHA224withRSA_oid, SHA256_oid, SHA256withECDSA_oid, SHA256withRSA_oid, SHA3_224_oid, SHA3_224withRSA_oid, SHA3_256_oid, SHA3_256withRSA_oid, SHA3_384_oid, SHA3_384withRSA_oid, SHA3_512_oid, SHA3_512withRSA_oid, SHA384_oid, SHA384withECDSA_oid, SHA384withRSA_oid, SHA512_224_oid, SHA512_256_oid, SHA512_oid, SHA512$224withRSA_oid, SHA512$256withRSA_oid, SHA512withECDSA_oid, SHA512withRSA_oid, SM2_OID, SM3_OID, SM3withSM2_OID, x25519_oid, x448_oid

Constructor Summary

Constructors

Constructor and Description
AlgIdDSA() Deprecated.
AlgIdDSA(java.math.BigInteger p, java.math.BigInteger q, java.math.BigInteger g) Constructs a DSS/DSA Algorithm ID from numeric parameters.

Method Summary

Modifier and Type	Method and Description
protected void	decodeParams() Parses algorithm parameters P, Q, and G.
java.math.BigInteger	getG() Returns the DSS/DSA parameter "G"
java.lang.String	getName() Returns "DSA", indicating the Digital Signature Algorithm (DSA) as defined by the Digital Signature Standard (DSS), FIPS 186.
java.math.BigInteger	getP() Returns the DSS/DSA parameter "P"
java.math.BigInteger	getQ() Returns the DSS/DSA parameter "Q"
protected java.lang.String	paramsToString()
java.lang.String	toString()

Methods inherited from class com.tencent.kona.sun.security.x509.AlgorithmId

clearAliasOidsTable, encode, encode, equals, equals, equals, get, get, getAlgorithmId, getEncodedParams, getOID, getParameters, hashCode, parse

Methods inherited from class java.lang.Object

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

Constructor Detail

AlgIdDSA

@Deprecated
public AlgIdDSA()

Deprecated.

Default constructor. The OID and parameters must be deserialized before this algorithm ID is used.

AlgIdDSA

public AlgIdDSA(java.math.BigInteger p,
                java.math.BigInteger q,
                java.math.BigInteger g)

Constructs a DSS/DSA Algorithm ID from numeric parameters. If all three are null, then the parameters portion of the algorithm id is set to null. See note in header regarding use.

Parameters:

p - the DSS/DSA parameter "P"

q - the DSS/DSA parameter "Q"

g - the DSS/DSA parameter "G"

Method Detail

getP

public java.math.BigInteger getP()

Returns the DSS/DSA parameter "P"

Specified by:

getP in interface java.security.interfaces.DSAParams

getQ

public java.math.BigInteger getQ()

Returns the DSS/DSA parameter "Q"

Specified by:

getQ in interface java.security.interfaces.DSAParams

getG

public java.math.BigInteger getG()

Returns the DSS/DSA parameter "G"

Specified by:

getG in interface java.security.interfaces.DSAParams

getName

public java.lang.String getName()

Returns "DSA", indicating the Digital Signature Algorithm (DSA) as defined by the Digital Signature Standard (DSS), FIPS 186.

Overrides:

getName in class com.tencent.kona.sun.security.x509.AlgorithmId

decodeParams

protected void decodeParams()
                     throws java.io.IOException

Parses algorithm parameters P, Q, and G. They're found in the "params" member, which never needs to be changed.

Overrides:

decodeParams in class com.tencent.kona.sun.security.x509.AlgorithmId

Throws:

java.io.IOException

toString

public java.lang.String toString()

Overrides:

toString in class com.tencent.kona.sun.security.x509.AlgorithmId

paramsToString

protected java.lang.String paramsToString()

Overrides:

paramsToString in class com.tencent.kona.sun.security.x509.AlgorithmId