saml/saml2/profile/AssertionValidator.h

   1 /*
   2  *  Copyright 2001-2007 Internet2
   3  *
   4  * Licensed under the Apache License, Version 2.0 (the "License");
   5  * you may not use this file except in compliance with the License.
   6  * You may obtain a copy of the License at
   7  *
   8  *     http://www.apache.org/licenses/LICENSE-2.0
   9  *
  10  * Unless required by applicable law or agreed to in writing, software
  11  * distributed under the License is distributed on an "AS IS" BASIS,
  12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  13  * See the License for the specific language governing permissions and
  14  * limitations under the License.
  15  */
  16
  17 /**
  18  * @file saml/saml2/profile/AssertionValidator.h
  19  *
  20  * SAML 2.0 basic assertion validator
  21  */
  22
  23 #ifndef __saml2_assval_h__
  24 #define __saml2_assval_h__
  25
  26 #include <saml/base.h>
  27 #include <xmltooling/validation/Validator.h>
  28
  29 namespace opensaml {
  30     namespace saml2 {
  31
  32         class SAML_API Assertion;
  33         class SAML_API Condition;
  34
  35         /**
  36          * @deprecated
  37          * SAML 2.0 basic assertion validator provides time and audience condition checking.
  38          */
  39         class SAML_API AssertionValidator : public virtual xmltooling::Validator
  40         {
  41         public:
  42             /**
  43              * Constructor
  44              *
  45              * @param recipient name of assertion recipient (implicit audience)
  46              * @param audiences additional audience values
  47              * @param ts        timestamp to evaluate assertion conditions, or 0 to bypass check
  48              */
  49             AssertionValidator(const XMLCh* recipient, const std::vector<const XMLCh*>* audiences=NULL, time_t ts=0)
  50                 : m_recipient(recipient), m_audiences(audiences), m_ts(ts) {
  51             }
  52
  53             virtual ~AssertionValidator() {}
  54
  55             void validate(const xmltooling::XMLObject* xmlObject) const;
  56
  57             /**
  58              * Type-safe validation method.
  59              *
  60              * @param assertion assertion to validate
  61              */
  62             virtual void validateAssertion(const Assertion& assertion) const;
  63
  64             /**
  65              * Condition validation.
  66              *
  67              * <p>The base class version only understands AudienceRestriction conditions.
  68              * All other condition types will be rejected and require subclassing to
  69              * prevent validation failure.
  70              *
  71              * @param condition condition to validate
  72              */
  73             virtual void validateCondition(const Condition* condition) const;
  74
  75         protected:
  76             /** Name of recipient (implicit audience). */
  77             const XMLCh* m_recipient;
  78
  79             /** Additional audience values. */
  80             const std::vector<const XMLCh*>* m_audiences;
  81
  82             /** Timestamp to evaluate assertion conditions. */
  83             time_t m_ts;
  84         };
  85
  86     };
  87 };
  88
  89 #endif /* __saml2_assval_h__ */