saml/saml1/binding/impl/SAML1ArtifactEncoder.cpp

   1 /*
   2  *  Copyright 2001-2010 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  * SAML1ArtifactEncoder.cpp
  19  *
  20  * SAML 1.x Artifact binding/profile message encoder
  21  */
  22
  23 #include "internal.h"
  24 #include "exceptions.h"
  25 #include "binding/ArtifactMap.h"
  26 #include "binding/MessageEncoder.h"
  27 #include "binding/SAMLArtifact.h"
  28 #include "saml1/core/Assertions.h"
  29 #include "saml1/core/Protocols.h"
  30 #include "saml2/metadata/Metadata.h"
  31
  32 #include <xmltooling/logging.h>
  33 #include <xmltooling/XMLToolingConfig.h>
  34 #include <xmltooling/io/HTTPResponse.h>
  35 #include <xmltooling/util/NDC.h>
  36 #include <xmltooling/util/URLEncoder.h>
  37
  38 using namespace opensaml::saml1;
  39 using namespace opensaml::saml1p;
  40 using namespace opensaml::saml2md;
  41 using namespace opensaml;
  42 using namespace xmlsignature;
  43 using namespace xmltooling::logging;
  44 using namespace xmltooling;
  45 using namespace std;
  46
  47 namespace opensaml {
  48     namespace saml1p {
  49         class SAML_DLLLOCAL SAML1ArtifactEncoder : public MessageEncoder
  50         {
  51         public:
  52             SAML1ArtifactEncoder() {}
  53             virtual ~SAML1ArtifactEncoder() {}
  54
  55             const XMLCh* getProtocolFamily() const {
  56                 return samlconstants::SAML11_PROTOCOL_ENUM;
  57             }
  58
  59             const char* getShortName() const {
  60                 return "Artifact";
  61             }
  62
  63             long encode(
  64                 GenericResponse& genericResponse,
  65                 XMLObject* xmlObject,
  66                 const char* destination,
  67                 const EntityDescriptor* recipient=nullptr,
  68                 const char* relayState=nullptr,
  69                 const ArtifactGenerator* artifactGenerator=nullptr,
  70                 const Credential* credential=nullptr,
  71                 const XMLCh* signatureAlg=nullptr,
  72                 const XMLCh* digestAlg=nullptr
  73                 ) const;
  74         };
  75
  76         MessageEncoder* SAML_DLLLOCAL SAML1ArtifactEncoderFactory(const pair<const DOMElement*,const XMLCh*>& p)
  77         {
  78             return new SAML1ArtifactEncoder();
  79         }
  80     };
  81 };
  82
  83 long SAML1ArtifactEncoder::encode(
  84     GenericResponse& genericResponse,
  85     XMLObject* xmlObject,
  86     const char* destination,
  87     const EntityDescriptor* recipient,
  88     const char* relayState,
  89     const ArtifactGenerator* artifactGenerator,
  90     const Credential* credential,
  91     const XMLCh* signatureAlg,
  92     const XMLCh* digestAlg
  93     ) const
  94 {
  95 #ifdef _DEBUG
  96     xmltooling::NDC ndc("encode");
  97 #endif
  98     Category& log = Category::getInstance(SAML_LOGCAT".MessageEncoder.SAML1Artifact");
  99
 100     log.debug("validating input");
 101     HTTPResponse* httpResponse=dynamic_cast<HTTPResponse*>(&genericResponse);
 102     if (!httpResponse)
 103         throw BindingException("Unable to cast response interface to HTTPResponse type.");
 104     if (xmlObject->getParent())
 105         throw BindingException("Cannot encode XML content with parent.");
 106     Assertion* assertion = dynamic_cast<Assertion*>(xmlObject);
 107     if (!assertion)
 108         throw BindingException("XML content for SAML 1.x Artifact Encoder must be a SAML 1.x <Assertion>.");
 109     if (!relayState)
 110         throw BindingException("SAML 1.x Artifact Encoder requires relay state (TARGET) value.");
 111
 112     // Signing is a protocol level issue, so no signing here...
 113
 114     ArtifactMap* mapper = SAMLConfig::getConfig().getArtifactMap();
 115     if (!mapper)
 116         throw BindingException("SAML 1.x Artifact Encoder requires ArtifactMap be set in configuration.");
 117
 118     // Obtain a fresh artifact.
 119     if (!artifactGenerator)
 120         throw BindingException("SAML 1.x Artifact Encoder requires an ArtifactGenerator instance.");
 121
 122     if (log.isDebugEnabled())
 123         log.debugStream() << "marshalled assertion:" << logging::eol << *xmlObject << logging::eol;
 124
 125     auto_ptr_char recipientID(recipient ? recipient->getEntityID() : nullptr);
 126     log.debug("obtaining new artifact for relying party (%s)", recipientID.get() ? recipientID.get() : "unknown");
 127     auto_ptr<SAMLArtifact> artifact(artifactGenerator->generateSAML1Artifact(recipient));
 128
 129     // Store the assertion. Last step in storage will be to delete the XML.
 130     log.debug("storing artifact and content in map");
 131     mapper->storeContent(xmlObject, artifact.get(), recipientID.get());
 132
 133     // Generate redirect.
 134     string loc = destination;
 135     loc += (strchr(destination,'?') ? '&' : '?');
 136     const URLEncoder* escaper = XMLToolingConfig::getConfig().getURLEncoder();
 137     loc = loc + "SAMLart=" + escaper->encode(artifact->encode().c_str()) + "&TARGET=" + escaper->encode(relayState);
 138     log.debug("message encoded, sending redirect to client");
 139     return httpResponse->sendRedirect(loc.c_str());
 140 }