Class DOMRSAPSSSignatureMethod

  • All Implemented Interfaces:
    javax.xml.crypto.AlgorithmMethod, javax.xml.crypto.dsig.SignatureMethod, javax.xml.crypto.XMLStructure
    Direct Known Subclasses:
    DOMRSAPSSSignatureMethod.RSAPSS

    public abstract class DOMRSAPSSSignatureMethod
    extends AbstractDOMSignatureMethod
    DOM-based abstract implementation of SignatureMethod for RSA-PSS.
    • Field Summary

      Fields 
      Modifier and Type Field Description
      private java.lang.String digestName  
      private static java.lang.String DOM_SIGNATURE_PROVIDER  
      private static java.lang.System.Logger LOG  
      private javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec params  
      (package private) static java.lang.String RSA_PSS  
      private int saltLength  
      private java.security.Signature signature  
      private int trailerField  
      • Fields inherited from interface javax.xml.crypto.dsig.SignatureMethod

        DSA_SHA1, DSA_SHA256, ECDSA_SHA1, ECDSA_SHA224, ECDSA_SHA256, ECDSA_SHA384, ECDSA_SHA512, HMAC_SHA1, HMAC_SHA224, HMAC_SHA256, HMAC_SHA384, HMAC_SHA512, RSA_SHA1, RSA_SHA224, RSA_SHA256, RSA_SHA384, RSA_SHA512, SHA1_RSA_MGF1, SHA224_RSA_MGF1, SHA256_RSA_MGF1, SHA384_RSA_MGF1, SHA512_RSA_MGF1
    • Constructor Summary

      Constructors 
      Constructor Description
      DOMRSAPSSSignatureMethod​(java.security.spec.AlgorithmParameterSpec params)
      Creates a DOMSignatureMethod.
      DOMRSAPSSSignatureMethod​(org.w3c.dom.Element smElem)
      Creates a DOMSignatureMethod from an element.
    • Method Summary

      All Methods Instance Methods Concrete Methods 
      Modifier and Type Method Description
      (package private) void checkParams​(javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec params)
      Checks if the specified parameters are valid for this algorithm.
      private javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec getDefaultParameterSpec()  
      java.security.spec.AlgorithmParameterSpec getParameterSpec()  
      (package private) void marshalParams​(org.w3c.dom.Element parent, java.lang.String prefix)
      Marshals the algorithm-specific parameters to an Element and appends it to the specified parent element.
      (package private) boolean paramsEqual​(java.security.spec.AlgorithmParameterSpec spec)
      Returns true if parameters are equal; false otherwise.
      (package private) byte[] sign​(java.security.Key key, javax.xml.crypto.dsig.SignedInfo si, javax.xml.crypto.dsig.XMLSignContext context)
      Signs the bytes with the specified key, using the underlying Signature or Mac algorithm.
      (package private) javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec unmarshalParams​(org.w3c.dom.Element paramsElem)
      Unmarshals SignatureMethodParameterSpec from the specified Element.
      (package private) boolean verify​(java.security.Key key, javax.xml.crypto.dsig.SignedInfo si, byte[] sig, javax.xml.crypto.dsig.XMLValidateContext context)
      Verifies the passed-in signature with the specified key, using the underlying Signature or Mac algorithm.
      • Methods inherited from class java.lang.Object

        clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait
      • Methods inherited from interface javax.xml.crypto.AlgorithmMethod

        getAlgorithm
      • Methods inherited from interface javax.xml.crypto.XMLStructure

        isFeatureSupported
    • Field Detail

      • DOM_SIGNATURE_PROVIDER

        private static final java.lang.String DOM_SIGNATURE_PROVIDER
        See Also:
        Constant Field Values
      • LOG

        private static final java.lang.System.Logger LOG
      • params

        private final javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec params
      • signature

        private java.security.Signature signature
      • trailerField

        private int trailerField
      • saltLength

        private int saltLength
      • digestName

        private java.lang.String digestName
    • Constructor Detail

      • DOMRSAPSSSignatureMethod

        DOMRSAPSSSignatureMethod​(java.security.spec.AlgorithmParameterSpec params)
                          throws java.security.InvalidAlgorithmParameterException
        Creates a DOMSignatureMethod.
        Parameters:
        params - the algorithm-specific params (may be null)
        Throws:
        java.security.InvalidAlgorithmParameterException - if the parameters are not appropriate for this signature method
      • DOMRSAPSSSignatureMethod

        DOMRSAPSSSignatureMethod​(org.w3c.dom.Element smElem)
                          throws javax.xml.crypto.MarshalException
        Creates a DOMSignatureMethod from an element. This ctor invokes the unmarshalParams method to unmarshal any algorithm-specific input parameters.
        Parameters:
        smElem - a SignatureMethod element
        Throws:
        javax.xml.crypto.MarshalException
    • Method Detail

      • checkParams

        void checkParams​(javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec params)
                  throws java.security.InvalidAlgorithmParameterException
        Description copied from class: AbstractDOMSignatureMethod
        Checks if the specified parameters are valid for this algorithm. By default, this method throws an exception if parameters are specified since most SignatureMethod algorithms do not have parameters. Subclasses should override it if they have parameters.
        Overrides:
        checkParams in class AbstractDOMSignatureMethod
        Parameters:
        params - the algorithm-specific params (may be null)
        Throws:
        java.security.InvalidAlgorithmParameterException - if the parameters are not appropriate for this signature method
      • getParameterSpec

        public final java.security.spec.AlgorithmParameterSpec getParameterSpec()
      • marshalParams

        void marshalParams​(org.w3c.dom.Element parent,
                           java.lang.String prefix)
                    throws javax.xml.crypto.MarshalException
        Description copied from class: AbstractDOMSignatureMethod
        Marshals the algorithm-specific parameters to an Element and appends it to the specified parent element. By default, this method throws an exception since most SignatureMethod algorithms do not have parameters. Subclasses should override it if they have parameters.
        Overrides:
        marshalParams in class AbstractDOMSignatureMethod
        Parameters:
        parent - the parent element to append the parameters to
        prefix - the algorithm parameters prefix to use
        Throws:
        javax.xml.crypto.MarshalException - if the parameters cannot be marshalled
      • unmarshalParams

        javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec unmarshalParams​(org.w3c.dom.Element paramsElem)
                                                                         throws javax.xml.crypto.MarshalException
        Description copied from class: AbstractDOMSignatureMethod
        Unmarshals SignatureMethodParameterSpec from the specified Element. By default, this method throws an exception since most SignatureMethod algorithms do not have parameters. Subclasses should override it if they have parameters.
        Overrides:
        unmarshalParams in class AbstractDOMSignatureMethod
        Parameters:
        paramsElem - the Element holding the input params
        Returns:
        the algorithm-specific SignatureMethodParameterSpec
        Throws:
        javax.xml.crypto.MarshalException - if the parameters cannot be unmarshalled
      • verify

        boolean verify​(java.security.Key key,
                       javax.xml.crypto.dsig.SignedInfo si,
                       byte[] sig,
                       javax.xml.crypto.dsig.XMLValidateContext context)
                throws java.security.InvalidKeyException,
                       java.security.SignatureException,
                       javax.xml.crypto.dsig.XMLSignatureException
        Description copied from class: AbstractDOMSignatureMethod
        Verifies the passed-in signature with the specified key, using the underlying Signature or Mac algorithm.
        Specified by:
        verify in class AbstractDOMSignatureMethod
        Parameters:
        key - the verification key
        si - the SignedInfo
        sig - the signature bytes to be verified
        context - the XMLValidateContext
        Returns:
        true if the signature verified successfully, false if not
        Throws:
        java.security.InvalidKeyException - if the key is improperly encoded, of the wrong type, or parameters are missing, etc
        java.security.SignatureException - if an unexpected error occurs, such as the passed in signature is improperly encoded
        javax.xml.crypto.dsig.XMLSignatureException - if an unexpected error occurs
      • sign

        byte[] sign​(java.security.Key key,
                    javax.xml.crypto.dsig.SignedInfo si,
                    javax.xml.crypto.dsig.XMLSignContext context)
             throws java.security.InvalidKeyException,
                    javax.xml.crypto.dsig.XMLSignatureException
        Description copied from class: AbstractDOMSignatureMethod
        Signs the bytes with the specified key, using the underlying Signature or Mac algorithm.
        Specified by:
        sign in class AbstractDOMSignatureMethod
        Parameters:
        key - the signing key
        si - the SignedInfo
        context - the XMLSignContext
        Returns:
        the signature
        Throws:
        java.security.InvalidKeyException - if the key is improperly encoded, of the wrong type, or parameters are missing, etc
        javax.xml.crypto.dsig.XMLSignatureException - if an unexpected error occurs
      • paramsEqual

        boolean paramsEqual​(java.security.spec.AlgorithmParameterSpec spec)
        Description copied from class: AbstractDOMSignatureMethod
        Returns true if parameters are equal; false otherwise. Subclasses should override this method to compare algorithm-specific parameters.
        Overrides:
        paramsEqual in class AbstractDOMSignatureMethod
      • getDefaultParameterSpec

        private javax.xml.crypto.dsig.spec.SignatureMethodParameterSpec getDefaultParameterSpec()