saml/saml2/metadata/impl/XMLMetadataProvider.cpp

   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  * XMLMetadataProvider.cpp
  19  *
  20  * Supplies metadata from an XML file
  21  */
  22
  23 #include "internal.h"
  24 #include "saml2/metadata/Metadata.h"
  25 #include "saml2/metadata/MetadataFilter.h"
  26 #include "saml2/metadata/AbstractMetadataProvider.h"
  27
  28 #include <xmltooling/util/NDC.h>
  29 #include <xmltooling/util/ReloadableXMLFile.h>
  30 #include <xmltooling/validation/ValidatorSuite.h>
  31
  32 using namespace opensaml::saml2md;
  33 using namespace xmltooling::logging;
  34 using namespace xmltooling;
  35 using namespace std;
  36
  37 #if defined (_MSC_VER)
  38     #pragma warning( push )
  39     #pragma warning( disable : 4250 )
  40 #endif
  41
  42 namespace opensaml {
  43     namespace saml2md {
  44
  45         class SAML_DLLLOCAL XMLMetadataProvider : public AbstractMetadataProvider, public ReloadableXMLFile
  46         {
  47         public:
  48             XMLMetadataProvider(const DOMElement* e)
  49                 : AbstractMetadataProvider(e), ReloadableXMLFile(e, Category::getInstance(SAML_LOGCAT".MetadataProvider.XML")),
  50                     m_object(NULL), m_maxCacheDuration(m_reloadInterval) {
  51             }
  52             virtual ~XMLMetadataProvider() {
  53                 delete m_object;
  54             }
  55
  56             void init() {
  57                 load(); // guarantees an exception or the metadata is loaded
  58             }
  59
  60             const XMLObject* getMetadata() const {
  61                 return m_object;
  62             }
  63
  64         protected:
  65             pair<bool,DOMElement*> load();
  66
  67         private:
  68             using AbstractMetadataProvider::index;
  69             void index();
  70
  71             XMLObject* m_object;
  72             time_t m_maxCacheDuration;
  73         };
  74
  75         MetadataProvider* SAML_DLLLOCAL XMLMetadataProviderFactory(const DOMElement* const & e)
  76         {
  77             return new XMLMetadataProvider(e);
  78         }
  79
  80     };
  81 };
  82
  83 #if defined (_MSC_VER)
  84     #pragma warning( pop )
  85 #endif
  86
  87 pair<bool,DOMElement*> XMLMetadataProvider::load()
  88 {
  89     // Load from source using base class.
  90     pair<bool,DOMElement*> raw = ReloadableXMLFile::load();
  91
  92     // If we own it, wrap it for now.
  93     XercesJanitor<DOMDocument> docjanitor(raw.first ? raw.second->getOwnerDocument() : NULL);
  94
  95     // Unmarshall objects, binding the document.
  96     auto_ptr<XMLObject> xmlObject(XMLObjectBuilder::buildOneFromElement(raw.second, true));
  97     docjanitor.release();
  98
  99     if (!dynamic_cast<const EntitiesDescriptor*>(xmlObject.get()) && !dynamic_cast<const EntityDescriptor*>(xmlObject.get()))
 100         throw MetadataException(
 101             "Root of metadata instance not recognized: $1", params(1,xmlObject->getElementQName().toString().c_str())
 102             );
 103
 104     // Preprocess the metadata (even if we schema-validated).
 105     try {
 106         SchemaValidators.validate(xmlObject.get());
 107     }
 108     catch (exception& ex) {
 109         m_log.error("metadata intance failed manual validation checking: %s", ex.what());
 110         throw MetadataException("Metadata instance failed manual validation checking.");
 111     }
 112
 113     doFilters(*xmlObject.get());
 114     xmlObject->releaseThisAndChildrenDOM();
 115     xmlObject->setDocument(NULL);
 116
 117     // Swap it in.
 118     bool changed = m_object!=NULL;
 119     delete m_object;
 120     m_object = xmlObject.release();
 121     index();
 122     if (changed)
 123         emitChangeEvent();
 124
 125     // If a remote resource, reduce the reload interval if cacheDuration is set.
 126     if (!m_local) {
 127         const CacheableSAMLObject* cacheable = dynamic_cast<const CacheableSAMLObject*>(m_object);
 128         if (cacheable && cacheable->getCacheDuration() && cacheable->getCacheDurationEpoch() < m_maxCacheDuration)
 129             m_reloadInterval = cacheable->getCacheDurationEpoch();
 130         else
 131             m_reloadInterval = m_maxCacheDuration;
 132     }
 133
 134     return make_pair(false,(DOMElement*)NULL);
 135 }
 136
 137 void XMLMetadataProvider::index()
 138 {
 139     time_t exp = SAMLTIME_MAX;
 140
 141     clearDescriptorIndex();
 142     EntitiesDescriptor* group=dynamic_cast<EntitiesDescriptor*>(m_object);
 143     if (group) {
 144         if (!m_local && group->getCacheDuration())
 145             exp = time(NULL) + group->getCacheDurationEpoch();
 146         AbstractMetadataProvider::index(group, exp);
 147         return;
 148     }
 149     EntityDescriptor* site=dynamic_cast<EntityDescriptor*>(m_object);
 150     if (!m_local && site->getCacheDuration())
 151         exp = time(NULL) + site->getCacheDurationEpoch();
 152     AbstractMetadataProvider::index(site, exp);
 153 }