saml/saml2/binding/impl/SAML2RedirectDecoder.cpp

   1 /*
   2  *  Copyright 2001-2009 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  * SAML2RedirectDecoder.cpp
  19  *
  20  * SAML 2.0 HTTP Redirect binding message encoder
  21  */
  22
  23 #include "internal.h"
  24 #include "exceptions.h"
  25 #include "binding/SecurityPolicy.h"
  26 #include "saml2/binding/SAML2MessageDecoder.h"
  27 #include "saml2/binding/SAML2Redirect.h"
  28 #include "saml2/core/Protocols.h"
  29 #include "saml2/metadata/Metadata.h"
  30 #include "saml2/metadata/MetadataProvider.h"
  31
  32 #include <xercesc/util/Base64.hpp>
  33 #include <xmltooling/logging.h>
  34 #include <xmltooling/XMLToolingConfig.h>
  35 #include <xmltooling/io/HTTPRequest.h>
  36 #include <xmltooling/util/NDC.h>
  37 #include <xmltooling/validation/ValidatorSuite.h>
  38
  39 using namespace opensaml::saml2md;
  40 using namespace opensaml::saml2p;
  41 using namespace opensaml::saml2;
  42 using namespace opensaml;
  43 using namespace xmlsignature;
  44 using namespace xmltooling::logging;
  45 using namespace xmltooling;
  46 using namespace std;
  47
  48 namespace opensaml {
  49     namespace saml2p {
  50         class SAML_DLLLOCAL SAML2RedirectDecoder : public SAML2MessageDecoder
  51         {
  52         public:
  53             SAML2RedirectDecoder() {}
  54             virtual ~SAML2RedirectDecoder() {}
  55
  56             xmltooling::XMLObject* decode(
  57                 std::string& relayState,
  58                 const GenericRequest& genericRequest,
  59                 SecurityPolicy& policy
  60                 ) const;
  61         };
  62
  63         MessageDecoder* SAML_DLLLOCAL SAML2RedirectDecoderFactory(const pair<const DOMElement*,const XMLCh*>& p)
  64         {
  65             return new SAML2RedirectDecoder();
  66         }
  67     };
  68 };
  69
  70 XMLObject* SAML2RedirectDecoder::decode(
  71     string& relayState,
  72     const GenericRequest& genericRequest,
  73     SecurityPolicy& policy
  74     ) const
  75 {
  76 #ifdef _DEBUG
  77     xmltooling::NDC ndc("decode");
  78 #endif
  79     Category& log = Category::getInstance(SAML_LOGCAT".MessageDecoder.SAML2Redirect");
  80
  81     log.debug("validating input");
  82     const HTTPRequest* httpRequest=dynamic_cast<const HTTPRequest*>(&genericRequest);
  83     if (!httpRequest)
  84         throw BindingException("Unable to cast request object to HTTPRequest type.");
  85     const char* msg = httpRequest->getParameter("SAMLResponse");
  86     if (!msg)
  87         msg = httpRequest->getParameter("SAMLRequest");
  88     if (!msg)
  89         throw BindingException("Request missing SAMLRequest or SAMLResponse query string parameter.");
  90     const char* state = httpRequest->getParameter("RelayState");
  91     if (state)
  92         relayState = state;
  93     else
  94         relayState.erase();
  95     state = httpRequest->getParameter("SAMLEncoding");
  96     if (state && strcmp(state,samlconstants::SAML20_BINDING_URL_ENCODING_DEFLATE)) {
  97         log.warn("SAMLEncoding (%s) was not recognized", state);
  98         throw BindingException("Unsupported SAMLEncoding value.");
  99     }
 100
 101     // Decode the compressed message into SAML. First we base64-decode it.
 102     xsecsize_t x;
 103     XMLByte* decoded=Base64::decode(reinterpret_cast<const XMLByte*>(msg),&x);
 104     if (!decoded)
 105         throw BindingException("Unable to decode base64 in Redirect binding message.");
 106
 107     // Now we have to inflate it.
 108     stringstream s;
 109     if (inflate(reinterpret_cast<char*>(decoded), x, s)==0) {
 110 #ifdef OPENSAML_XERCESC_HAS_XMLBYTE_RELEASE
 111         XMLString::release(&decoded);
 112 #else
 113         XMLString::release((char**)&decoded);
 114 #endif
 115         throw BindingException("Unable to inflate Redirect binding message.");
 116     }
 117     if (log.isDebugEnabled())
 118         log.debug("decoded SAML message:\n%s", s.str().c_str());
 119 #ifdef OPENSAML_XERCESC_HAS_XMLBYTE_RELEASE
 120     XMLString::release(&decoded);
 121 #else
 122     XMLString::release((char**)&decoded);
 123 #endif
 124
 125     // Parse and bind the document into an XMLObject.
 126     DOMDocument* doc = (policy.getValidating() ? XMLToolingConfig::getConfig().getValidatingParser()
 127         : XMLToolingConfig::getConfig().getParser()).parse(s);
 128     XercesJanitor<DOMDocument> janitor(doc);
 129     auto_ptr<XMLObject> xmlObject(XMLObjectBuilder::buildOneFromElement(doc->getDocumentElement(), true));
 130     janitor.release();
 131
 132     saml2::RootObject* root = NULL;
 133     StatusResponseType* response = NULL;
 134     RequestAbstractType* request = dynamic_cast<RequestAbstractType*>(xmlObject.get());
 135     if (!request) {
 136         response = dynamic_cast<StatusResponseType*>(xmlObject.get());
 137         if (!response)
 138             throw BindingException("XML content for SAML 2.0 HTTP-POST Decoder must be a SAML 2.0 protocol message.");
 139         root = static_cast<saml2::RootObject*>(response);
 140     }
 141     else {
 142         root = static_cast<saml2::RootObject*>(request);
 143     }
 144
 145     SchemaValidators.validate(root);
 146
 147     // Run through the policy.
 148     extractMessageDetails(*root, genericRequest, samlconstants::SAML20P_NS, policy);
 149     policy.evaluate(*root, &genericRequest);
 150
 151     // Check destination URL.
 152     auto_ptr_char dest(request ? request->getDestination() : response->getDestination());
 153     const char* dest2 = httpRequest->getRequestURL();
 154     const char* delim = strchr(dest2, '?');
 155     if ((root->getSignature() || httpRequest->getParameter("Signature")) && (!dest.get() || !*(dest.get()))) {
 156         log.error("signed SAML message missing Destination attribute");
 157         throw BindingException("Signed SAML message missing Destination attribute identifying intended destination.");
 158     }
 159     else if (dest.get() && *dest.get() && ((delim && strncmp(dest.get(), dest2, delim - dest2)) || (!delim && strcmp(dest.get(),dest2)))) {
 160         log.error("Redirect targeted at (%s), but delivered to (%s)", dest.get(), dest2);
 161         throw BindingException("SAML message delivered with Redirect to incorrect server URL.");
 162     }
 163
 164     return xmlObject.release();
 165 }