2 * Copyright 2001-2007 Internet2
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
8 * http://www.apache.org/licenses/LICENSE-2.0
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.
20 * Base class for handlers based on a DOMPropertySet.
24 #include "Application.h"
25 #include "exceptions.h"
26 #include "ServiceProvider.h"
27 #include "SPRequest.h"
28 #include "handler/AbstractHandler.h"
29 #include "remoting/ListenerService.h"
30 #include "util/SPConstants.h"
33 # include <saml/SAMLConfig.h>
34 # include <saml/binding/SAMLArtifact.h>
35 # include <saml/saml1/core/Protocols.h>
36 # include <saml/saml2/core/Protocols.h>
37 # include <saml/saml2/metadata/Metadata.h>
38 # include <saml/saml2/metadata/MetadataCredentialCriteria.h>
39 # include <saml/util/SAMLConstants.h>
40 # include <xmltooling/util/StorageService.h>
41 using namespace opensaml::saml2md;
43 # include "lite/SAMLConstants.h"
46 #include <xmltooling/XMLToolingConfig.h>
47 #include <xmltooling/util/URLEncoder.h>
49 using namespace shibsp;
50 using namespace samlconstants;
51 using namespace opensaml;
52 using namespace xmltooling;
53 using namespace log4cpp;
54 using namespace xercesc;
58 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory SAML1ConsumerFactory;
59 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory SAML2ConsumerFactory;
60 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory SAML2ArtifactResolutionFactory;
61 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory AssertionLookupFactory;
62 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory ChainingLogoutInitiatorFactory;
63 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory LocalLogoutInitiatorFactory;
64 SHIBSP_DLLLOCAL PluginManager< Handler,string,pair<const DOMElement*,const char*> >::Factory SAML2LogoutInitiatorFactory;
67 void SHIBSP_API shibsp::registerHandlers()
69 SPConfig& conf=SPConfig::getConfig();
71 conf.AssertionConsumerServiceManager.registerFactory(SAML1_PROFILE_BROWSER_ARTIFACT, SAML1ConsumerFactory);
72 conf.AssertionConsumerServiceManager.registerFactory(SAML1_PROFILE_BROWSER_POST, SAML1ConsumerFactory);
73 conf.AssertionConsumerServiceManager.registerFactory(SAML20_BINDING_HTTP_ARTIFACT, SAML2ConsumerFactory);
74 conf.AssertionConsumerServiceManager.registerFactory(SAML20_BINDING_HTTP_POST, SAML2ConsumerFactory);
75 conf.AssertionConsumerServiceManager.registerFactory(SAML20_BINDING_HTTP_POST_SIMPLESIGN, SAML2ConsumerFactory);
77 conf.ArtifactResolutionServiceManager.registerFactory(SAML20_BINDING_SOAP, SAML2ArtifactResolutionFactory);
79 conf.HandlerManager.registerFactory(SAML20_BINDING_URI, AssertionLookupFactory);
81 conf.LogoutInitiatorManager.registerFactory(CHAINING_LOGOUT_INITIATOR, ChainingLogoutInitiatorFactory);
82 conf.LogoutInitiatorManager.registerFactory(LOCAL_LOGOUT_INITIATOR, LocalLogoutInitiatorFactory);
83 conf.LogoutInitiatorManager.registerFactory(SAML2_LOGOUT_INITIATOR, SAML2LogoutInitiatorFactory);
86 AbstractHandler::AbstractHandler(
87 const DOMElement* e, log4cpp::Category& log, DOMNodeFilter* filter, const map<string,string>* remapper
88 ) : m_log(log), m_configNS(shibspconstants::SHIB2SPCONFIG_NS) {
89 load(e,log,filter,remapper);
94 void AbstractHandler::checkError(const XMLObject* response) const
96 const saml2p::StatusResponseType* r2 = dynamic_cast<const saml2p::StatusResponseType*>(response);
98 const saml2p::Status* status = r2->getStatus();
100 const saml2p::StatusCode* sc = status->getStatusCode();
101 const XMLCh* code = sc ? sc->getValue() : NULL;
102 if (code && !XMLString::equals(code,saml2p::StatusCode::SUCCESS)) {
103 FatalProfileException ex("SAML Response message contained an error.");
104 auto_ptr_char c1(code);
105 ex.addProperty("StatusCode", c1.get());
106 if (sc->getStatusCode()) {
107 code = sc->getStatusCode()->getValue();
108 auto_ptr_char c2(code);
109 ex.addProperty("StatusCode2", c2.get());
111 if (status->getStatusMessage()) {
112 auto_ptr_char msg(status->getStatusMessage()->getMessage());
113 ex.addProperty("StatusMessage", msg.get());
119 const saml1p::Response* r1 = dynamic_cast<const saml1p::Response*>(response);
121 const saml1p::Status* status = r1->getStatus();
123 const saml1p::StatusCode* sc = status->getStatusCode();
124 const QName* code = sc ? sc->getValue() : NULL;
125 if (code && *code != saml1p::StatusCode::SUCCESS) {
126 FatalProfileException ex("SAML Response message contained an error.");
127 ex.addProperty("StatusCode", code->toString().c_str());
128 if (sc->getStatusCode()) {
129 code = sc->getStatusCode()->getValue();
131 ex.addProperty("StatusCode2", code->toString().c_str());
133 if (status->getStatusMessage()) {
134 auto_ptr_char msg(status->getStatusMessage()->getMessage());
135 ex.addProperty("StatusMessage", msg.get());
142 void AbstractHandler::fillStatus(saml2p::StatusResponseType& response, const XMLCh* code, const XMLCh* subcode, const char* msg) const
144 saml2p::Status* status = saml2p::StatusBuilder::buildStatus();
145 saml2p::StatusCode* scode = saml2p::StatusCodeBuilder::buildStatusCode();
146 status->setStatusCode(scode);
147 scode->setValue(code);
149 saml2p::StatusCode* ssubcode = saml2p::StatusCodeBuilder::buildStatusCode();
150 scode->setStatusCode(ssubcode);
151 ssubcode->setValue(subcode);
154 pair<bool,bool> flag = getBool("detailedErrors", m_configNS.get());
155 auto_ptr_XMLCh widemsg((flag.first && flag.second) ? msg : "Error processing request.");
156 saml2p::StatusMessage* sm = saml2p::StatusMessageBuilder::buildStatusMessage();
157 status->setStatusMessage(sm);
158 sm->setMessage(widemsg.get());
160 response.setStatus(status);
163 long AbstractHandler::sendMessage(
164 const MessageEncoder& encoder,
166 const char* relayState,
167 const char* destination,
168 const saml2md::RoleDescriptor* role,
169 const Application& application,
170 HTTPResponse& httpResponse,
171 const char* signingOption,
175 const EntityDescriptor* entity = role ? dynamic_cast<const EntityDescriptor*>(role->getParent()) : NULL;
176 const PropertySet* relyingParty = application.getRelyingParty(entity);
177 pair<bool,const char*> flag = signIfPossible ? make_pair(true,"true") : relyingParty->getString(signingOption);
178 if (role && flag.first &&
179 (!strcmp(flag.second, "true") ||
180 (encoder.isUserAgentPresent() && !strcmp(flag.second, "front")) ||
181 (!encoder.isUserAgentPresent() && !strcmp(flag.second, "back")))) {
182 CredentialResolver* credResolver=application.getCredentialResolver();
184 Locker credLocker(credResolver);
185 // Fill in criteria to use.
186 MetadataCredentialCriteria mcc(*role);
187 mcc.setUsage(CredentialCriteria::SIGNING_CREDENTIAL);
188 pair<bool,const char*> keyName = relyingParty->getString("keyName");
190 mcc.getKeyNames().insert(keyName.second);
191 pair<bool,const XMLCh*> sigalg = relyingParty->getXMLString("signatureAlg");
193 mcc.setXMLAlgorithm(sigalg.second);
194 const Credential* cred = credResolver->resolve(&mcc);
197 return encoder.encode(
206 relyingParty->getXMLString("digestAlg").second
210 m_log.warn("no signing credential resolved, leaving message unsigned");
214 m_log.warn("no credential resolver installed, leaving message unsigned");
219 return encoder.encode(httpResponse, msg, destination, entity, relayState, &application);
224 void AbstractHandler::preserveRelayState(const Application& application, HTTPResponse& response, string& relayState) const
226 if (relayState.empty())
229 // No setting means just pass it by value.
230 pair<bool,const char*> mech=getString("relayState");
231 if (!mech.first || !mech.second || !*mech.second)
234 if (!strcmp(mech.second, "cookie")) {
235 // Here we store the state in a cookie and send a fixed
236 // value so we can recognize it on the way back.
237 if (relayState != "cookie") {
238 const URLEncoder* urlenc = XMLToolingConfig::getConfig().getURLEncoder();
239 pair<string,const char*> shib_cookie=application.getCookieNameProps("_shibstate_");
240 string stateval = urlenc->encode(relayState.c_str()) + shib_cookie.second;
241 response.setCookie(shib_cookie.first.c_str(),stateval.c_str());
242 relayState = "cookie";
245 else if (strstr(mech.second,"ss:")==mech.second) {
246 if (relayState.find("ss:")!=0) {
249 if (SPConfig::getConfig().isEnabled(SPConfig::OutOfProcess)) {
251 StorageService* storage = application.getServiceProvider().getStorageService(mech.second);
254 SAMLConfig::getConfig().generateRandomBytes(rsKey,10);
255 rsKey = SAMLArtifact::toHex(rsKey);
256 if (!storage->createString("RelayState", rsKey.c_str(), relayState.c_str(), time(NULL) + 600))
257 throw IOException("Attempted to insert duplicate storage key.");
258 relayState = string(mech.second-3) + ':' + rsKey;
261 m_log.error("Storage-backed RelayState with invalid StorageService ID (%s)", mech.second);
266 else if (SPConfig::getConfig().isEnabled(SPConfig::InProcess)) {
267 DDF out,in = DDF("set::RelayState").structure();
268 in.addmember("id").string(mech.second);
269 in.addmember("value").string(relayState.c_str());
270 DDFJanitor jin(in),jout(out);
271 out = application.getServiceProvider().getListenerService()->send(in);
273 throw IOException("StorageService-backed RelayState mechanism did not return a state key.");
274 relayState = string(mech.second-3) + ':' + out.string();
280 throw ConfigurationException("Unsupported relayState mechanism ($1).", params(1,mech.second));
283 void AbstractHandler::recoverRelayState(const Application& application, HTTPRequest& httpRequest, string& relayState, bool clear) const
285 SPConfig& conf = SPConfig::getConfig();
287 // Look for StorageService-backed state of the form "ss:SSID:key".
288 const char* state = relayState.c_str();
289 if (strstr(state,"ss:")==state) {
291 const char* key = strchr(state,':');
293 string ssid = relayState.substr(3, key - state);
295 if (!ssid.empty() && *key) {
296 if (conf.isEnabled(SPConfig::OutOfProcess)) {
298 StorageService* storage = conf.getServiceProvider()->getStorageService(ssid.c_str());
301 if (storage->readString("RelayState",ssid.c_str(),&relayState)>0) {
303 storage->deleteString("RelayState",ssid.c_str());
310 Category::getInstance(SHIBSP_LOGCAT".Handler").error(
311 "Storage-backed RelayState with invalid StorageService ID (%s)", ssid.c_str()
317 else if (conf.isEnabled(SPConfig::InProcess)) {
318 DDF out,in = DDF("get::RelayState").structure();
319 in.addmember("id").string(ssid.c_str());
320 in.addmember("key").string(key);
321 in.addmember("clear").integer(clear ? 1 : 0);
322 DDFJanitor jin(in),jout(out);
323 out = application.getServiceProvider().getListenerService()->send(in);
324 if (!out.isstring()) {
325 m_log.error("StorageService-backed RelayState mechanism did not return a state value.");
329 relayState = out.string();
337 if (conf.isEnabled(SPConfig::InProcess)) {
338 if (relayState == "cookie") {
339 // Pull the value from the "relay state" cookie.
340 pair<string,const char*> relay_cookie = application.getCookieNameProps("_shibstate_");
341 // In process, we should be able to cast down to a full SPRequest.
342 SPRequest& request = dynamic_cast<SPRequest&>(httpRequest);
343 const char* state = request.getCookie(relay_cookie.first.c_str());
344 if (state && *state) {
345 // URL-decode the value.
346 char* rscopy=strdup(state);
347 XMLToolingConfig::getConfig().getURLEncoder()->decode(rscopy);
352 request.setCookie(relay_cookie.first.c_str(),relay_cookie.second);
359 // Check for "default" value.
360 if (relayState.empty() || relayState == "default") {
361 pair<bool,const char*> homeURL=application.getString("homeURL");
362 relayState=homeURL.first ? homeURL.second : "/";
367 if (relayState == "default")