A trust engine that uses X.509 trust anchors and CRLs associated with a peer to perform PKIX validation of signatures and credentials. More...
#include <xmltooling/security/AbstractPKIXTrustEngine.h>
Classes | |
class | PKIXValidationInfoIterator |
Stateful interface that supplies PKIX validation data to the trust engine. More... | |
Public Member Functions | |
bool | validate (xmlsignature::Signature &sig, const CredentialResolver &credResolver, CredentialCriteria *criteria=0) const |
bool | validate (const XMLCh *sigAlgorithm, const char *sig, xmlsignature::KeyInfo *keyInfo, const char *in, unsigned int in_len, const CredentialResolver &credResolver, CredentialCriteria *criteria=0) const |
bool | validate (XSECCryptoX509 *certEE, const std::vector< XSECCryptoX509 * > &certChain, const CredentialResolver &credResolver, CredentialCriteria *criteria=0) const |
Determines whether an X.509 credential is valid with respect to the source of credentials supplied. | |
bool | validate (X509 *certEE, STACK_OF(X509)*certChain, const CredentialResolver &credResolver, CredentialCriteria *criteria=0) const |
Determines whether an X.509 credential is valid with respect to the source of credentials supplied. | |
virtual PKIXValidationInfoIterator * | getPKIXValidationInfoIterator (const CredentialResolver &pkixSource, CredentialCriteria *criteria=0) const =0 |
Provides access to the information necessary, for the given credential source, for PKIX validation of credentials. | |
Protected Member Functions | |
AbstractPKIXTrustEngine (const xercesc::DOMElement *e=0) | |
Constructor. | |
bool | checkEntityNames (X509 *certEE, const CredentialResolver &credResolver, const CredentialCriteria &criteria) const |
Checks that either the name of the peer with the given credentials or the names of the credentials match the subject or subject alternate names of the certificate. | |
Protected Attributes | |
std::string | m_checkRevocation |
Controls revocation checking, currently limited to CRLs and supports "off", "entityOnly", "fullChain". | |
bool | m_fullCRLChain |
Deprecated option, equivalent to checkRevocation="fullChain". |
A trust engine that uses X.509 trust anchors and CRLs associated with a peer to perform PKIX validation of signatures and credentials.
xmltooling::AbstractPKIXTrustEngine::AbstractPKIXTrustEngine | ( | const xercesc::DOMElement * | e = 0 |
) | [protected] |
Constructor.
If a DOM is supplied, the following XML content is supported:
e | DOM to supply configuration for provider |
bool xmltooling::AbstractPKIXTrustEngine::checkEntityNames | ( | X509 * | certEE, | |
const CredentialResolver & | credResolver, | |||
const CredentialCriteria & | criteria | |||
) | const [protected] |
Checks that either the name of the peer with the given credentials or the names of the credentials match the subject or subject alternate names of the certificate.
certEE | the credential for the entity to validate | |
credResolver | source of credentials | |
criteria | criteria for selecting credentials, including the peer name |
virtual PKIXValidationInfoIterator* xmltooling::AbstractPKIXTrustEngine::getPKIXValidationInfoIterator | ( | const CredentialResolver & | pkixSource, | |
CredentialCriteria * | criteria = 0 | |||
) | const [pure virtual] |
Provides access to the information necessary, for the given credential source, for PKIX validation of credentials.
Each set of validation information returned will be tried, in turn, until one succeeds or no more remain. The caller must free the returned interface when finished with it.
pkixSource | the peer for which validation rules are required | |
criteria | criteria for selecting validation rules |
bool xmltooling::AbstractPKIXTrustEngine::validate | ( | X509 * | certEE, | |
STACK_OF(X509)* | certChain, | |||
const CredentialResolver & | credResolver, | |||
CredentialCriteria * | criteria = 0 | |||
) | const [virtual] |
Determines whether an X.509 credential is valid with respect to the source of credentials supplied.
It is the responsibility of the application to ensure that the credentials supplied are in fact associated with the peer who presented the credential.
If criteria with a peer name are supplied, the "name" of the EE certificate may also be checked to ensure that it identifies the intended peer. The peer name itself or implementation-specific rules based on the content of the peer credentials may be applied. Implementations may omit this check if they deem it unnecessary.
certEE | end-entity certificate to validate | |
certChain | the complete set of certificates presented for validation (includes certEE) | |
credResolver | a locked resolver to supply trusted peer credentials to the TrustEngine | |
criteria | criteria for selecting peer credentials |
Implements xmltooling::OpenSSLTrustEngine.
bool xmltooling::AbstractPKIXTrustEngine::validate | ( | XSECCryptoX509 * | certEE, | |
const std::vector< XSECCryptoX509 * > & | certChain, | |||
const CredentialResolver & | credResolver, | |||
CredentialCriteria * | criteria = 0 | |||
) | const [virtual] |
Determines whether an X.509 credential is valid with respect to the source of credentials supplied.
It is the responsibility of the application to ensure that the credentials supplied are in fact associated with the peer who presented the credential.
If criteria with a peer name are supplied, the "name" of the EE certificate may also be checked to ensure that it identifies the intended peer. The peer name itself or implementation-specific rules based on the content of the peer credentials may be applied. Implementations may omit this check if they deem it unnecessary.
certEE | end-entity certificate to validate | |
certChain | the complete set of certificates presented for validation (includes certEE) | |
credResolver | a locked resolver to supply trusted peer credentials to the TrustEngine | |
criteria | criteria for selecting peer credentials |
Implements xmltooling::X509TrustEngine.
std::string xmltooling::AbstractPKIXTrustEngine::m_checkRevocation [protected] |
Controls revocation checking, currently limited to CRLs and supports "off", "entityOnly", "fullChain".
bool xmltooling::AbstractPKIXTrustEngine::m_fullCRLChain [protected] |
Deprecated option, equivalent to checkRevocation="fullChain".