opensaml::SecurityPolicyRule Class Reference

A rule that a protocol request and message must meet in order to be valid and secure. More...

#include <saml/binding/SecurityPolicyRule.h>

List of all members.

Public Member Functions

virtual const char * getType () const =0
 Returns the rule's class/type.
virtual bool evaluate (const xmltooling::XMLObject &message, const xmltooling::GenericRequest *request, SecurityPolicy &policy) const =0
 Evaluates the rule against the given request and message.

Detailed Description

A rule that a protocol request and message must meet in order to be valid and secure.

Rules must be stateless and thread-safe across evaluations. Evaluation should not result in an exception if the request/message properties do not apply to the rule (e.g. particular security mechanisms that are not present).


Member Function Documentation

virtual bool opensaml::SecurityPolicyRule::evaluate ( const xmltooling::XMLObject &  message,
const xmltooling::GenericRequest *  request,
SecurityPolicy policy 
) const [pure virtual]

Evaluates the rule against the given request and message.

An exception will be raised if the message is fatally invalid according to a policy rule.

The return value is used to indicate whether a message was ignored or successfully processed. A false value signals that the rule wasn't successful because the rule was inapplicable to the message, but allows other rules to return an alternate result.

Parameters:
message the incoming message
request the protocol request
policy SecurityPolicy to provide various components and track message data
Returns:
indicator as to whether a message was understood and processed
virtual const char* opensaml::SecurityPolicyRule::getType (  )  const [pure virtual]

Returns the rule's class/type.

Returns:
the class/type of the object

The documentation for this class was generated from the following file:

Generated on 9 Jan 2013 for opensaml-2.5.2 by  doxygen 1.6.1