#include <XSECProvider.hpp>
Collaboration diagram for XSECProvider:
The XSECProvider class is used to create and destroy signature objects and encryption objects. It provides a number of methods to create signature and encryption objects for a variety of situations - in particular creating an empty signature or cipher with which to create the DOM structure or creating a security object based on an already existing DOM structure.
Public Member Functions | |
Constructors and Destructors | |
XSECProvider () | |
Default constructor. | |
~XSECProvider () | |
Signature Creation Classes | |
DSIGSignature * | newSignatureFromDOM (XERCES_CPP_NAMESPACE_QUALIFIER DOMDocument *doc, XERCES_CPP_NAMESPACE_QUALIFIER DOMNode *sigNode) |
DSIGSignature creator for use with existing XML signatures or templates. | |
DSIGSignature * | newSignatureFromDOM (XERCES_CPP_NAMESPACE_QUALIFIER DOMDocument *doc) |
DSIGSignature creator for use with existing XML signatures or templates. | |
DSIGSignature * | newSignature (void) |
DSIGSignature creator for creating new XML signatures. | |
void | releaseSignature (DSIGSignature *toRelease) |
Method for destroying DSIGSignature objects created via this provider. | |
Encryption Creation Functions | |
XENCCipher * | newCipher (XERCES_CPP_NAMESPACE_QUALIFIER DOMDocument *doc) |
Create an XENCCipher object based on a particular DOM Document. | |
void | releaseCipher (XENCCipher *toRelease) |
Method to delete XENCCipher objects created via this provider. | |
XKMS Functions | |
XKMSMessageFactory * | getXKMSMessageFactory (void) |
Obtain a pointer to the XKMSMessageFactory. | |
Environmental Options | |
void | setDefaultURIResolver (XSECURIResolver *resolver) |
Set the default URIResolver. |
|
Default constructor. The provider class requires no parameters for construction |
|
|
|
Obtain a pointer to the XKMSMessageFactory. The XKMSMessageFactory is used to create and manipulate XKMS messages.
|
|
Create an XENCCipher object based on a particular DOM Document. XENCCipher is an engine class that is used to wrap encryption/decryption functions. Unlike the Signature functions, only a XENCCipher object attached to a particular document is required. Arbitrary objects within this document can then be encrypted/decrypted using this class.
|
|
DSIGSignature creator for creating new XML signatures. Create an empty DSIGSignature object that can be used to create new signature values. The returned signature object needs to be initialised with a document so a blank signature DOM structure can be created
|
|
DSIGSignature creator for use with existing XML signatures or templates. Create a DSIGSignature object based on an already existing DSIG Signature XML node. It is assumed that the underlying DOM structure is in place and works correctly. In this case, the XML-Security libraries will find the signature node.
|
|
DSIGSignature creator for use with existing XML signatures or templates. Create a DSIGSignature object based on an already existing DSIG Signature XML node. It is assumed that the underlying DOM structure is in place and works correctly. In this case, the caller can pass in the signature DOM Node for cases where there may be more than one signature in a document. The caller needs to specify which signature tree is to be used.
|
|
Method to delete XENCCipher objects created via this provider. The provider keeps track of all objects by it. This method can be used to delete any previously created XENCCipher objects prior to the provider being deleted. Any XENCCipher objects not released using this function will automatically be deleted when the provider goes out of scope (or is itself deleted).
|
|
Method for destroying DSIGSignature objects created via this provider. The provider keeps track of all signature objects created during the lifetime of the provider. This method can be called to delete a signature whilst the provider is still in scope. Otherwise the objects will be automatically deleted when the provider object goes out of scope. In cases where the DSIGSignature has been used to create a new DOM structure, it can be safely deleted once the signature operations have been completed without impacting the underlying DOM structure.
|
|
Set the default URIResolver. DSIGSignature objects require a URIResolver to allow them to de-reference URIs in reference elements. This function sets the resolver that will be used for all signatures created after this is set. The resolver is cloned, so the object passed in can be safely deleted once the function has been completed. |