Class KeyInfoHeaderBlock

  • All Implemented Interfaces:
    SecurityHeaderBlock, javax.xml.soap.Node, javax.xml.soap.SOAPElement, Element, Node

    public class KeyInfoHeaderBlock
    extends SecurityHeaderBlockImpl
    Corresponds to the schema representation for a KeyInfo.
    
     <element name="KeyInfo" type="ds:KeyInfoType"/>
       <complexType name="KeyInfoType" mixed="true">
         <choice maxOccurs="unbounded">
           <element ref="ds:KeyName"/>
           <element ref="ds:KeyValue"/>
           <element ref="ds:RetrievalMethod"/>
           <element ref="ds:X509Data"/>
           <element ref="ds:PGPData"/>
           <element ref="ds:SPKIData"/>
           <element ref="ds:MgmtData"/>
           <element ref="wsse:SecurityTokenReference"/>
           <any processContents="lax" namespace="##other"/>
           <!-- (1,1) elements from (0,unbounded) namespaces -->
         </choice>
         <attribute name="Id" type="ID" use="optional"/>
       </complexType>
     
    • Constructor Detail

      • KeyInfoHeaderBlock

        public KeyInfoHeaderBlock​(Document ownerDoc)
                           throws com.sun.xml.wss.XWSSecurityException
        constructor that creates an empty KeyInfo
        Parameters:
        ownerDoc - the OwnerDocument of the KeyInfo
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • KeyInfoHeaderBlock

        public KeyInfoHeaderBlock​(org.apache.xml.security.keys.KeyInfo keyinfo)
                           throws com.sun.xml.wss.XWSSecurityException
        constructor that takes Apache KeyInfo
        Parameters:
        keyinfo - the KeyInfo from XML DSIG
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • KeyInfoHeaderBlock

        public KeyInfoHeaderBlock​(javax.xml.soap.SOAPElement element)
                           throws com.sun.xml.wss.XWSSecurityException
        parse and create the KeyInfo element
        Parameters:
        element - the KeyInfo element NOTE : this constructor assumes a fully initialized XML KeyInfo No additions are allowed on the keyinfo, only we can get existing values. For example addkeyName() will have no impact on the KeyInfo will not append a KeyName child to the KeyInfo.
        Throws:
        com.sun.xml.wss.XWSSecurityException
    • Method Detail

      • addKeyName

        public void addKeyName​(String keynameString)
        Method addKeyName.
        Parameters:
        keynameString -
      • addBinarySecret

        public void addBinarySecret​(javax.xml.soap.SOAPElement binarySecret)
        Method addBinarySecret
        Parameters:
        binarySecret -
      • addKeyName

        public void addKeyName​(javax.xml.soap.SOAPElement keyname)
                        throws com.sun.xml.wss.XWSSecurityException
        Method add.
        Parameters:
        keyname -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addKeyValue

        public void addKeyValue​(PublicKey pk)
        Method addKeyValue
        Parameters:
        pk -
      • addUnknownKeyValue

        public void addUnknownKeyValue​(javax.xml.soap.SOAPElement unknownKeyValueElement)
        Method addKeyValue
        Parameters:
        unknownKeyValueElement -
      • addDSAKeyValue

        public void addDSAKeyValue​(javax.xml.soap.SOAPElement dsakeyvalue)
                            throws com.sun.xml.wss.XWSSecurityException
        Method add
        Parameters:
        dsakeyvalue -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addRSAKeyValue

        public void addRSAKeyValue​(javax.xml.soap.SOAPElement rsakeyvalue)
                            throws com.sun.xml.wss.XWSSecurityException
        Method add
        Parameters:
        rsakeyvalue -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addKeyValue

        public void addKeyValue​(javax.xml.soap.SOAPElement keyvalue)
                         throws com.sun.xml.wss.XWSSecurityException
        Method addKeyValue
        Parameters:
        keyvalue -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addMgmtData

        public void addMgmtData​(String mgmtdata)
        Method addMgmtData
        Parameters:
        mgmtdata -
      • addMgmtData

        public void addMgmtData​(javax.xml.soap.SOAPElement mgmtdata)
                         throws com.sun.xml.wss.XWSSecurityException
        Method add
        Parameters:
        mgmtdata -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addPGPData

        public void addPGPData​(javax.xml.soap.SOAPElement pgpdata)
                        throws com.sun.xml.wss.XWSSecurityException
        Method addPGPData
        Parameters:
        pgpdata -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addRetrievalMethod

        public void addRetrievalMethod​(String URI,
                                       org.apache.xml.security.transforms.Transforms transforms,
                                       String type)
        Method addRetrievalMethod
        Parameters:
        URI -
        transforms -
        type -
      • addRetrievalMethod

        public void addRetrievalMethod​(javax.xml.soap.SOAPElement retrievalmethod)
                                throws com.sun.xml.wss.XWSSecurityException
        Method addRetrievalMethod
        Parameters:
        retrievalmethod -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addSPKIData

        public void addSPKIData​(javax.xml.soap.SOAPElement spkidata)
                         throws com.sun.xml.wss.XWSSecurityException
        Method add
        Parameters:
        spkidata -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addX509Data

        public void addX509Data​(javax.xml.soap.SOAPElement x509data)
                         throws com.sun.xml.wss.XWSSecurityException
        Method addX509Data
        Parameters:
        x509data -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addUnknownElement

        public void addUnknownElement​(javax.xml.soap.SOAPElement element)
        Method addUnknownElement
        Parameters:
        element -
      • keyNameCount

        public int keyNameCount()
        Method keyNameCount
      • keyValueCount

        public int keyValueCount()
        Method keyValueCount
      • mgmtDataCount

        public int mgmtDataCount()
        Method mgmtDataCount
      • pgpDataCount

        public int pgpDataCount()
        Method pgpDataCount
      • retrievalMethodCount

        public int retrievalMethodCount()
        Method retrievalMethodCount
      • spkiDataCount

        public int spkiDataCount()
        Method spkiDataCount
      • x509DataCount

        public int x509DataCount()
        Method x509DataCount
      • unknownElementCount

        public int unknownElementCount()
        Method unknownElementCount
      • getKeyName

        public javax.xml.soap.SOAPElement getKeyName​(int index)
                                              throws com.sun.xml.wss.XWSSecurityException
        Method getKeyName
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getKeyNameString

        public String getKeyNameString​(int index)
                                throws com.sun.xml.wss.XWSSecurityException
        Method getKeyNameString
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getKeyValueElement

        public javax.xml.soap.SOAPElement getKeyValueElement​(int index)
                                                      throws com.sun.xml.wss.XWSSecurityException
        Method getKeyValueElement
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getKeyValue

        public org.apache.xml.security.keys.content.KeyValue getKeyValue​(int index)
                                                                  throws com.sun.xml.wss.XWSSecurityException
        Method getKeyValue
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getMgmtData

        public javax.xml.soap.SOAPElement getMgmtData​(int index)
                                               throws com.sun.xml.wss.XWSSecurityException
        Method getMgmtData
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getPGPData

        public javax.xml.soap.SOAPElement getPGPData​(int index)
                                              throws com.sun.xml.wss.XWSSecurityException
        Method getPGPData
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getRetrievalMethod

        public javax.xml.soap.SOAPElement getRetrievalMethod​(int index)
                                                      throws com.sun.xml.wss.XWSSecurityException
        Method getRetrievalMethod
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getSPKIData

        public javax.xml.soap.SOAPElement getSPKIData​(int index)
                                               throws com.sun.xml.wss.XWSSecurityException
        Method getSPKIData
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getX509DataElement

        public javax.xml.soap.SOAPElement getX509DataElement​(int index)
                                                      throws com.sun.xml.wss.XWSSecurityException
        Method getX509DataElement
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getX509Data

        public org.apache.xml.security.keys.content.X509Data getX509Data​(int index)
                                                                  throws com.sun.xml.wss.XWSSecurityException
        Method getX509Data
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getUnknownElement

        public javax.xml.soap.SOAPElement getUnknownElement​(int index)
                                                     throws com.sun.xml.wss.XWSSecurityException
        Method getUnknownElement
        Parameters:
        index - 0 is the lowest index
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • containsKeyName

        public boolean containsKeyName()
        Method containsKeyName
      • containsKeyValue

        public boolean containsKeyValue()
        Method containsKeyValue
      • containsMgmtData

        public boolean containsMgmtData()
        Method containsMgmtData
      • containsPGPData

        public boolean containsPGPData()
        Method containsPGPData
      • containsRetrievalMethod

        public boolean containsRetrievalMethod()
        Method containsRetrievalMethod
      • containsSPKIData

        public boolean containsSPKIData()
        Method containsSPKIData
      • containsUnknownElement

        public boolean containsUnknownElement()
        Method containsUnknownElement
      • containsX509Data

        public boolean containsX509Data()
        Method containsX509Data
      • addSecurityTokenReference

        public void addSecurityTokenReference​(SecurityTokenReference reference)
                                       throws com.sun.xml.wss.XWSSecurityException
        Method addSecurityTokenReference
        Parameters:
        reference -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getSecurityTokenReference

        public SecurityTokenReference getSecurityTokenReference​(int index)
                                                         throws com.sun.xml.wss.XWSSecurityException
        Method getSecurityTokenReference
        Parameters:
        index -
        Returns:
        the index^th token reference element from the KeyInfo 0 is the lowest index.
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • securityTokenReferenceCount

        public int securityTokenReferenceCount()
        Method securityTokenReferenceCount
        Returns:
        the count of security token references
      • containsSecurityTokenReference

        public boolean containsSecurityTokenReference()
        Method containsSecurityTokenReference
        Returns:
        true if this KeyInfo contains wsse:SecurityTokenReference's
      • addEncryptedKey

        public void addEncryptedKey​(EncryptedKeyToken reference)
                             throws com.sun.xml.wss.XWSSecurityException
        Method addEncryptedKey
        Parameters:
        reference -
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • getEncryptedKey

        public EncryptedKeyToken getEncryptedKey​(int index)
                                          throws com.sun.xml.wss.XWSSecurityException
        Method getEncryptedKey
        Parameters:
        index -
        Returns:
        the index^th token reference element from the KeyInfo 0 is the lowest index.
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • encryptedKeyTokenCount

        public int encryptedKeyTokenCount()
        Method encryptedKeyTokenCount
        Returns:
        the count of encrypted key token references
      • containsEncryptedKeyToken

        public boolean containsEncryptedKeyToken()
        Method containsEncryptedKeyToken
        Returns:
        true if this KeyInfo contains wsse:SecurityTokenReference's
      • getBinarySecret

        public com.sun.xml.ws.security.trust.elements.BinarySecret getBinarySecret​(int index)
                                                                            throws com.sun.xml.wss.XWSSecurityException
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • binarySecretCount

        public int binarySecretCount()
        Method binarySecretCount
        Returns:
        the count of binarySecret tokens
      • containsBinarySecret

        public boolean containsBinarySecret()
        Method containsBinarySecret
        Returns:
        true if this KeyInfo contains BinarySecret
      • setId

        public void setId​(String id)
        Method setId
      • getKeyInfo

        public final org.apache.xml.security.keys.KeyInfo getKeyInfo()
        Method getKeyInfo
        Returns:
        the XML DSIG KeyInfo which is wrapped by this class
      • setBaseURI

        public void setBaseURI​(String uri)
        Method setBaseURI : BaseURI accepted by Apache KeyInfo Ctor
        Parameters:
        uri - Base URI to be used as context for all relative URIs.
      • setDocument

        public void setDocument​(Document doc)
        setDocument
        Parameters:
        doc - The owner Document of this KeyInfo
      • saveChanges

        public void saveChanges()
        This method should be called when changes are made inside an object through its reference obtained from any of the get methods of this class. As an example, if getKeyInfo() call is made and then changes are made inside the keyInfo, this method should be called to reflect changes when getAsSoapElement() is called finally.
      • fromSoapElement

        public static SecurityHeaderBlock fromSoapElement​(javax.xml.soap.SOAPElement element)
                                                   throws com.sun.xml.wss.XWSSecurityException
        Throws:
        com.sun.xml.wss.XWSSecurityException
      • addX509Data

        public void addX509Data​(org.apache.xml.security.keys.content.X509Data x509Data)
                         throws com.sun.xml.wss.XWSSecurityException
        Throws:
        com.sun.xml.wss.XWSSecurityException