sun.security.x509

Class AlgIdDSA

java.lang.Object

sun.security.x509.AlgorithmId

sun.security.x509.AlgIdDSA

All Implemented Interfaces:

java.io.Serializable, java.security.interfaces.DSAParams, DerEncoder

public final class AlgIdDSA
extends 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);
 

Author:

David Brownell

See Also:

DSAParams, DSAPublicKey, KeyFactory, DSAPublicKeySpec, Serialized Form

Field Summary

Fields inherited from class sun.security.x509.AlgorithmId

DH_oid, DH_PKIX_oid, DSA_oid, DSA_OIW_oid, EC_oid, MD2_oid, md2WithRSAEncryption_oid, MD5_oid, md5WithRSAEncryption_oid, params, pbeWithMD5AndDES_oid, pbeWithMD5AndRC2_oid, pbeWithSHA1AndDES_oid, pbeWithSHA1AndDESede_oid, pbeWithSHA1AndRC2_40_oid, pbeWithSHA1AndRC2_oid, RSA_oid, RSAEncryption_oid, SHA_oid, sha1WithDSA_oid, sha1WithDSA_OIW_oid, sha1WithECDSA_oid, sha1WithRSAEncryption_oid, sha1WithRSAEncryption_OIW_oid, sha224WithECDSA_oid, SHA256_oid, sha256WithECDSA_oid, sha256WithRSAEncryption_oid, SHA384_oid, sha384WithECDSA_oid, sha384WithRSAEncryption_oid, SHA512_oid, sha512WithECDSA_oid, sha512WithRSAEncryption_oid, shaWithDSA_OIW_oid, specifiedWithECDSA_oid

Constructor Summary

Constructors

Constructor and Description
AlgIdDSA() Default constructor.
AlgIdDSA(java.math.BigInteger p, java.math.BigInteger q, java.math.BigInteger g) Constructs a DSS/DSA Algorithm ID from numeric parameters.
AlgIdDSA(byte[] encodedAlg) Construct an AlgIdDSA from an X.509 encoded byte array.
AlgIdDSA(byte[] p, byte[] q, byte[] g) Constructs a DSS/DSA Algorithm ID from unsigned integers that define the algorithm parameters.

Method Summary

Methods

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() Provides a human-readable description of the algorithm parameters.
java.lang.String	toString() Returns a string describing the algorithm and its parameters.

Methods inherited from class sun.security.x509.AlgorithmId

derEncode, 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

public AlgIdDSA()

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

AlgIdDSA

public AlgIdDSA(byte[] encodedAlg)
         throws java.io.IOException

Construct an AlgIdDSA from an X.509 encoded byte array.

Throws:

java.io.IOException

AlgIdDSA

public AlgIdDSA(byte[] p,
        byte[] q,
        byte[] g)
         throws java.io.IOException

Constructs a DSS/DSA Algorithm ID from unsigned integers that define the algorithm parameters. Those integers are encoded as big-endian byte arrays.

Parameters:

p - the DSS/DSA paramter "P"

q - the DSS/DSA paramter "Q"

g - the DSS/DSA paramter "G"

Throws:

java.io.IOException

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 paramter "P"

q - the DSS/DSA paramter "Q"

g - the DSS/DSA paramter "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 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 AlgorithmId

Throws:

java.io.IOException

toString

public java.lang.String toString()

Description copied from class: AlgorithmId

Returns a string describing the algorithm and its parameters.

Overrides:

toString in class AlgorithmId

paramsToString

protected java.lang.String paramsToString()

Description copied from class: AlgorithmId

Provides a human-readable description of the algorithm parameters. This may be redefined by subclasses which parse those parameters.

Overrides:

paramsToString in class AlgorithmId