c06a203124a98b73aa51f75884ea54ff5a98d17e
[shibboleth/cpp-sp.git] / adfs / adfs.cpp
1 /*
2  *  Copyright 2001-2005 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  * adfs.cpp
19  *
20  * ADFSv1 extension library
21  */
22
23 #if defined (_MSC_VER) || defined(__BORLANDC__)
24 # include "config_win32.h"
25 #else
26 # include "config.h"
27 #endif
28
29 #ifdef WIN32
30 # define _CRT_NONSTDC_NO_DEPRECATE 1
31 # define _CRT_SECURE_NO_DEPRECATE 1
32 # define ADFS_EXPORTS __declspec(dllexport)
33 #else
34 # define ADFS_EXPORTS
35 #endif
36
37 #include <shibsp/base.h>
38 #include <shibsp/exceptions.h>
39 #include <shibsp/Application.h>
40 #include <shibsp/ServiceProvider.h>
41 #include <shibsp/SessionCache.h>
42 #include <shibsp/SPConfig.h>
43 #include <shibsp/handler/AssertionConsumerService.h>
44 #include <shibsp/handler/LogoutHandler.h>
45 #include <shibsp/handler/SessionInitiator.h>
46 #include <xmltooling/logging.h>
47 #include <xmltooling/util/NDC.h>
48 #include <xmltooling/util/URLEncoder.h>
49 #include <xmltooling/util/XMLHelper.h>
50 #include <xercesc/util/XMLUniDefs.hpp>
51
52 #ifndef SHIBSP_LITE
53 # include <shibsp/attribute/resolver/ResolutionContext.h>
54 # include <saml/SAMLConfig.h>
55 # include <saml/saml1/core/Assertions.h>
56 # include <saml/saml1/profile/AssertionValidator.h>
57 # include <saml/saml2/core/Assertions.h>
58 # include <saml/saml2/metadata/Metadata.h>
59 # include <saml/saml2/metadata/EndpointManager.h>
60 # include <xmltooling/impl/AnyElement.h>
61 # include <xmltooling/validation/ValidatorSuite.h>
62 using namespace opensaml::saml2md;
63 #endif
64 using namespace shibsp;
65 using namespace opensaml;
66 using namespace xmltooling::logging;
67 using namespace xmltooling;
68 using namespace xercesc;
69 using namespace std;
70
71 #define WSFED_NS "http://schemas.xmlsoap.org/ws/2003/07/secext"
72 #define WSTRUST_NS "http://schemas.xmlsoap.org/ws/2005/02/trust"
73
74 namespace {
75
76 #ifndef SHIBSP_LITE
77     class SHIBSP_DLLLOCAL ADFSDecoder : public MessageDecoder
78     {
79         auto_ptr_XMLCh m_ns;
80     public:
81         ADFSDecoder() : m_ns(WSTRUST_NS) {}
82         virtual ~ADFSDecoder() {}
83         
84         XMLObject* decode(string& relayState, const GenericRequest& genericRequest, SecurityPolicy& policy) const;
85
86     protected:
87         void extractMessageDetails(
88             const XMLObject& message, const GenericRequest& req, const XMLCh* protocol, SecurityPolicy& policy
89             ) const {
90         }
91     };
92
93     MessageDecoder* ADFSDecoderFactory(const pair<const DOMElement*,const XMLCh*>& p)
94     {
95         return new ADFSDecoder();
96     }
97 #endif
98
99 #if defined (_MSC_VER)
100     #pragma warning( push )
101     #pragma warning( disable : 4250 )
102 #endif
103
104     class SHIBSP_DLLLOCAL ADFSSessionInitiator : public SessionInitiator, public AbstractHandler, public RemotedHandler
105     {
106     public:
107         ADFSSessionInitiator(const DOMElement* e, const char* appId)
108                 : AbstractHandler(e, Category::getInstance(SHIBSP_LOGCAT".SessionInitiator.ADFS")), m_appId(appId), m_binding(WSFED_NS) {
109             // If Location isn't set, defer address registration until the setParent call.
110             pair<bool,const char*> loc = getString("Location");
111             if (loc.first) {
112                 string address = m_appId + loc.second + "::run::ADFSSI";
113                 setAddress(address.c_str());
114             }
115         }
116         virtual ~ADFSSessionInitiator() {}
117         
118         void setParent(const PropertySet* parent) {
119             DOMPropertySet::setParent(parent);
120             pair<bool,const char*> loc = getString("Location");
121             if (loc.first) {
122                 string address = m_appId + loc.second + "::run::ADFSSI";
123                 setAddress(address.c_str());
124             }
125             else {
126                 m_log.warn("no Location property in ADFS SessionInitiator (or parent), can't register as remoted handler");
127             }
128         }
129
130         void receive(DDF& in, ostream& out);
131         pair<bool,long> run(SPRequest& request, const char* entityID=NULL, bool isHandler=true) const;
132
133     private:
134         pair<bool,long> doRequest(
135             const Application& application,
136             HTTPResponse& httpResponse,
137             const char* entityID,
138             const char* acsLocation,
139             string& relayState
140             ) const;
141         string m_appId;
142         auto_ptr_XMLCh m_binding;
143     };
144
145     class SHIBSP_DLLLOCAL ADFSConsumer : public shibsp::AssertionConsumerService
146     {
147     public:
148         ADFSConsumer(const DOMElement* e, const char* appId)
149             : shibsp::AssertionConsumerService(e, appId, Category::getInstance(SHIBSP_LOGCAT".SSO.ADFS"))
150 #ifndef SHIBSP_LITE
151                 ,m_protocol(WSFED_NS)
152 #endif
153             {}
154         virtual ~ADFSConsumer() {}
155
156 #ifndef SHIBSP_LITE
157         void generateMetadata(SPSSODescriptor& role, const char* handlerURL) const {
158             AssertionConsumerService::generateMetadata(role, handlerURL);
159             role.addSupport(m_protocol.get());
160         }
161
162         auto_ptr_XMLCh m_protocol;
163
164     private:
165         string implementProtocol(
166             const Application& application,
167             const HTTPRequest& httpRequest,
168             SecurityPolicy& policy,
169             const PropertySet* settings,
170             const XMLObject& xmlObject
171             ) const;
172 #endif
173     };
174
175     class SHIBSP_DLLLOCAL ADFSLogoutInitiator : public AbstractHandler, public RemotedHandler
176     {
177     public:
178         ADFSLogoutInitiator(const DOMElement* e, const char* appId)
179                 : AbstractHandler(e, Category::getInstance(SHIBSP_LOGCAT".LogoutInitiator.ADFS")), m_appId(appId), m_binding(WSFED_NS) {
180             // If Location isn't set, defer address registration until the setParent call.
181             pair<bool,const char*> loc = getString("Location");
182             if (loc.first) {
183                 string address = m_appId + loc.second + "::run::ADFSLI";
184                 setAddress(address.c_str());
185             }
186         }
187         virtual ~ADFSLogoutInitiator() {}
188         
189         void setParent(const PropertySet* parent) {
190             DOMPropertySet::setParent(parent);
191             pair<bool,const char*> loc = getString("Location");
192             if (loc.first) {
193                 string address = m_appId + loc.second + "::run::ADFSLI";
194                 setAddress(address.c_str());
195             }
196             else {
197                 m_log.warn("no Location property in ADFS LogoutInitiator (or parent), can't register as remoted handler");
198             }
199         }
200
201         void receive(DDF& in, ostream& out);
202         pair<bool,long> run(SPRequest& request, bool isHandler=true) const;
203
204 #ifndef SHIBSP_LITE
205         const char* getType() const {
206             return "LogoutInitiator";
207         }
208 #endif
209
210     private:
211         pair<bool,long> doRequest(
212             const Application& application, const char* requestURL, const char* entityID, HTTPResponse& httpResponse
213             ) const;
214
215         string m_appId;
216         auto_ptr_XMLCh m_binding;
217     };
218
219     class SHIBSP_DLLLOCAL ADFSLogout : public AbstractHandler, public LogoutHandler
220     {
221     public:
222         ADFSLogout(const DOMElement* e, const char* appId)
223                 : AbstractHandler(e, Category::getInstance(SHIBSP_LOGCAT".Logout.ADFS")), m_login(e, appId) {
224 #ifndef SHIBSP_LITE
225             m_initiator = false;
226             m_preserve.push_back("wreply");
227             string address = string(appId) + getString("Location").second + "::run::ADFSLO";
228             setAddress(address.c_str());
229 #endif
230         }
231         virtual ~ADFSLogout() {}
232
233         pair<bool,long> run(SPRequest& request, bool isHandler=true) const;
234
235 #ifndef SHIBSP_LITE
236         void generateMetadata(SPSSODescriptor& role, const char* handlerURL) const {
237             m_login.generateMetadata(role, handlerURL);
238             const char* loc = getString("Location").second;
239             string hurl(handlerURL);
240             if (*loc != '/')
241                 hurl += '/';
242             hurl += loc;
243             auto_ptr_XMLCh widen(hurl.c_str());
244             SingleLogoutService* ep = SingleLogoutServiceBuilder::buildSingleLogoutService();
245             ep->setLocation(widen.get());
246             ep->setBinding(m_login.m_protocol.get());
247             role.getSingleLogoutServices().push_back(ep);
248         }
249
250         const char* getType() const {
251             return m_login.getType();
252         }
253 #endif
254
255     private:
256         ADFSConsumer m_login;
257     };
258
259 #if defined (_MSC_VER)
260     #pragma warning( pop )
261 #endif
262
263     SessionInitiator* ADFSSessionInitiatorFactory(const pair<const DOMElement*,const char*>& p)
264     {
265         return new ADFSSessionInitiator(p.first, p.second);
266     }
267
268     Handler* ADFSLogoutFactory(const pair<const DOMElement*,const char*>& p)
269     {
270         return new ADFSLogout(p.first, p.second);
271     }
272
273     Handler* ADFSLogoutInitiatorFactory(const pair<const DOMElement*,const char*>& p)
274     {
275         return new ADFSLogoutInitiator(p.first, p.second);
276     }
277
278     const XMLCh RequestedSecurityToken[] =      UNICODE_LITERAL_22(R,e,q,u,e,s,t,e,d,S,e,c,u,r,i,t,y,T,o,k,e,n);
279     const XMLCh RequestSecurityTokenResponse[] =UNICODE_LITERAL_28(R,e,q,u,e,s,t,S,e,c,u,r,i,t,y,T,o,k,e,n,R,e,s,p,o,n,s,e);
280 };
281
282 extern "C" int ADFS_EXPORTS xmltooling_extension_init(void*)
283 {
284     SPConfig& conf=SPConfig::getConfig();
285     conf.SessionInitiatorManager.registerFactory("ADFS", ADFSSessionInitiatorFactory);
286     conf.LogoutInitiatorManager.registerFactory("ADFS", ADFSLogoutInitiatorFactory);
287     conf.AssertionConsumerServiceManager.registerFactory("ADFS", ADFSLogoutFactory);
288     conf.AssertionConsumerServiceManager.registerFactory(WSFED_NS, ADFSLogoutFactory);
289 #ifndef SHIBSP_LITE
290     SAMLConfig::getConfig().MessageDecoderManager.registerFactory(WSFED_NS, ADFSDecoderFactory);
291     XMLObjectBuilder::registerBuilder(QName(WSTRUST_NS,"RequestedSecurityToken"), new AnyElementBuilder());
292     XMLObjectBuilder::registerBuilder(QName(WSTRUST_NS,"RequestSecurityTokenResponse"), new AnyElementBuilder());
293 #endif
294     return 0;
295 }
296
297 extern "C" void ADFS_EXPORTS xmltooling_extension_term()
298 {
299     /* should get unregistered during normal shutdown...
300     SPConfig& conf=SPConfig::getConfig();
301     conf.SessionInitiatorManager.deregisterFactory("ADFS");
302     conf.LogoutInitiatorManager.deregisterFactory("ADFS");
303     conf.AssertionConsumerServiceManager.deregisterFactory("ADFS");
304     conf.AssertionConsumerServiceManager.deregisterFactory(WSFED_NS);
305 #ifndef SHIBSP_LITE
306     SAMLConfig::getConfig().MessageDecoderManager.deregisterFactory(WSFED_NS);
307 #endif
308     */
309 }
310
311 pair<bool,long> ADFSSessionInitiator::run(SPRequest& request, const char* entityID, bool isHandler) const
312 {
313     // We have to know the IdP to function.
314     if (!entityID || !*entityID)
315         return make_pair(false,0L);
316
317     string target;
318     const Handler* ACS=NULL;
319     const char* option;
320     const Application& app=request.getApplication();
321
322     if (isHandler) {
323         option = request.getParameter("target");
324         if (option)
325             target = option;
326
327         // Since we're passing the ACS by value, we need to compute the return URL,
328         // so we'll need the target resource for real.
329         recoverRelayState(request.getApplication(), request, target, false);
330     }
331     else {
332         // We're running as a "virtual handler" from within the filter.
333         // The target resource is the current one and everything else is defaulted.
334         target=request.getRequestURL();
335     }
336
337     // Since we're not passing by index, we need to fully compute the return URL.
338     // Get all the ADFS endpoints.
339     const vector<const Handler*>& handlers = app.getAssertionConsumerServicesByBinding(m_binding.get());
340
341     // Index comes from request, or default set in the handler, or we just pick the first endpoint.
342     pair<bool,unsigned int> index(false,0);
343     if (isHandler) {
344         option = request.getParameter("acsIndex");
345         if (option)
346             index = pair<bool,unsigned int>(true, atoi(option));
347     }
348     if (!index.first)
349         index = getUnsignedInt("defaultACSIndex");
350     if (index.first) {
351         for (vector<const Handler*>::const_iterator h = handlers.begin(); !ACS && h!=handlers.end(); ++h) {
352             if (index.second == (*h)->getUnsignedInt("index").second)
353                 ACS = *h;
354         }
355     }
356     else if (!handlers.empty()) {
357         ACS = handlers.front();
358     }
359     if (!ACS)
360         throw ConfigurationException("Unable to locate ADFS response endpoint.");
361
362     // Compute the ACS URL. We add the ACS location to the base handlerURL.
363     string ACSloc=request.getHandlerURL(target.c_str());
364     pair<bool,const char*> loc=ACS ? ACS->getString("Location") : pair<bool,const char*>(false,NULL);
365     if (loc.first) ACSloc+=loc.second;
366
367     if (isHandler) {
368         // We may already have RelayState set if we looped back here,
369         // but just in case target is a resource, we reset it back.
370         target.erase();
371         option = request.getParameter("target");
372         if (option)
373             target = option;
374     }
375
376     m_log.debug("attempting to initiate session using ADFS with provider (%s)", entityID);
377
378     if (SPConfig::getConfig().isEnabled(SPConfig::OutOfProcess))
379         return doRequest(app, request, entityID, ACSloc.c_str(), target);
380
381     // Remote the call.
382     DDF out,in = DDF(m_address.c_str()).structure();
383     DDFJanitor jin(in), jout(out);
384     in.addmember("application_id").string(app.getId());
385     in.addmember("entity_id").string(entityID);
386     in.addmember("acsLocation").string(ACSloc.c_str());
387     if (!target.empty())
388         in.addmember("RelayState").string(target.c_str());
389
390     // Remote the processing.
391     out = request.getServiceProvider().getListenerService()->send(in);
392     return unwrap(request, out);
393 }
394
395 void ADFSSessionInitiator::receive(DDF& in, ostream& out)
396 {
397     // Find application.
398     const char* aid=in["application_id"].string();
399     const Application* app=aid ? SPConfig::getConfig().getServiceProvider()->getApplication(aid) : NULL;
400     if (!app) {
401         // Something's horribly wrong.
402         m_log.error("couldn't find application (%s) to generate ADFS request", aid ? aid : "(missing)");
403         throw ConfigurationException("Unable to locate application for new session, deleted?");
404     }
405
406     const char* entityID = in["entity_id"].string();
407     const char* acsLocation = in["acsLocation"].string();
408     if (!entityID || !acsLocation)
409         throw ConfigurationException("No entityID or acsLocation parameter supplied to remoted SessionInitiator.");
410
411     DDF ret(NULL);
412     DDFJanitor jout(ret);
413
414     // Wrap the outgoing object with a Response facade.
415     auto_ptr<HTTPResponse> http(getResponse(ret));
416
417     string relayState(in["RelayState"].string() ? in["RelayState"].string() : "");
418
419     // Since we're remoted, the result should either be a throw, which we pass on,
420     // a false/0 return, which we just return as an empty structure, or a response/redirect,
421     // which we capture in the facade and send back.
422     doRequest(*app, *http.get(), entityID, acsLocation, relayState);
423     out << ret;
424 }
425
426 pair<bool,long> ADFSSessionInitiator::doRequest(
427     const Application& app,
428     HTTPResponse& httpResponse,
429     const char* entityID,
430     const char* acsLocation,
431     string& relayState
432     ) const
433 {
434 #ifndef SHIBSP_LITE
435     // Use metadata to invoke the SSO service directly.
436     MetadataProvider* m=app.getMetadataProvider();
437     Locker locker(m);
438     MetadataProvider::Criteria mc(entityID, &IDPSSODescriptor::ELEMENT_QNAME, m_binding.get());
439     pair<const EntityDescriptor*,const RoleDescriptor*> entity=m->getEntityDescriptor(mc);
440     if (!entity.first) {
441         m_log.error("unable to locate metadata for provider (%s)", entityID);
442         throw MetadataException("Unable to locate metadata for identity provider ($entityID)", namedparams(1, "entityID", entityID));
443     }
444     else if (!entity.second) {
445         m_log.error("unable to locate ADFS-aware identity provider role for provider (%s)", entityID);
446         return make_pair(false,0L);
447     }
448     const EndpointType* ep = EndpointManager<SingleSignOnService>(
449         dynamic_cast<const IDPSSODescriptor*>(entity.second)->getSingleSignOnServices()
450         ).getByBinding(m_binding.get());
451     if (!ep) {
452         m_log.error("unable to locate compatible SSO service for provider (%s)", entityID);
453         return make_pair(false,0L);
454     }
455
456     preserveRelayState(app, httpResponse, relayState);
457
458     // UTC timestamp
459     time_t epoch=time(NULL);
460 #ifndef HAVE_GMTIME_R
461     struct tm* ptime=gmtime(&epoch);
462 #else
463     struct tm res;
464     struct tm* ptime=gmtime_r(&epoch,&res);
465 #endif
466     char timebuf[32];
467     strftime(timebuf,32,"%Y-%m-%dT%H:%M:%SZ",ptime);
468
469     auto_ptr_char dest(ep->getLocation());
470     const URLEncoder* urlenc = XMLToolingConfig::getConfig().getURLEncoder();
471
472     string req=string(dest.get()) + (strchr(dest.get(),'?') ? '&' : '?') + "wa=wsignin1.0&wreply=" + urlenc->encode(acsLocation) +
473         "&wct=" + urlenc->encode(timebuf) + "&wtrealm=" + urlenc->encode(app.getString("entityID").second);
474     if (!relayState.empty())
475         req += "&wctx=" + urlenc->encode(relayState.c_str());
476
477     return make_pair(true, httpResponse.sendRedirect(req.c_str()));
478 #else
479     return make_pair(false,0L);
480 #endif
481 }
482
483 #ifndef SHIBSP_LITE
484
485 XMLObject* ADFSDecoder::decode(string& relayState, const GenericRequest& genericRequest, SecurityPolicy& policy) const
486 {
487 #ifdef _DEBUG
488     xmltooling::NDC ndc("decode");
489 #endif
490     Category& log = Category::getInstance(SHIBSP_LOGCAT".MessageDecoder.ADFS");
491
492     log.debug("validating input");
493     const HTTPRequest* httpRequest=dynamic_cast<const HTTPRequest*>(&genericRequest);
494     if (!httpRequest)
495         throw BindingException("Unable to cast request object to HTTPRequest type.");
496     if (strcmp(httpRequest->getMethod(),"POST"))
497         throw BindingException("Invalid HTTP method ($1).", params(1, httpRequest->getMethod()));
498     const char* param = httpRequest->getParameter("wa");
499     if (!param || strcmp(param, "wsignin1.0"))
500         throw BindingException("Missing or invalid wa parameter (should be wsignin1.0).");
501     param = httpRequest->getParameter("wctx");
502     if (param)
503         relayState = param;
504
505     param = httpRequest->getParameter("wresult");
506     if (!param)
507         throw BindingException("Request missing wresult parameter.");
508
509     log.debug("decoded ADFS response:\n%s", param);
510
511     // Parse and bind the document into an XMLObject.
512     istringstream is(param);
513     DOMDocument* doc = (policy.getValidating() ? XMLToolingConfig::getConfig().getValidatingParser()
514         : XMLToolingConfig::getConfig().getParser()).parse(is); 
515     XercesJanitor<DOMDocument> janitor(doc);
516     auto_ptr<XMLObject> xmlObject(XMLObjectBuilder::buildOneFromElement(doc->getDocumentElement(), true));
517     janitor.release();
518
519     if (!XMLHelper::isNodeNamed(xmlObject->getDOM(), m_ns.get(), RequestSecurityTokenResponse))
520         throw BindingException("Decoded message was not of the appropriate type.");
521
522     if (!policy.getValidating())
523         SchemaValidators.validate(xmlObject.get());
524
525     // Skip policy step here, there's no security in the wrapper.
526     // policy.evaluate(*xmlObject.get(), &genericRequest);
527     
528     return xmlObject.release();
529 }
530
531 string ADFSConsumer::implementProtocol(
532     const Application& application,
533     const HTTPRequest& httpRequest,
534     SecurityPolicy& policy,
535     const PropertySet* settings,
536     const XMLObject& xmlObject
537     ) const
538 {
539     // Implementation of ADFS profile.
540     m_log.debug("processing message against ADFS Passive Requester profile");
541
542     // With ADFS, all the security comes from the assertion, which is two levels down in the message.
543
544     const ElementProxy* response = dynamic_cast<const ElementProxy*>(&xmlObject);
545     if (!response || !response->hasChildren())
546         throw FatalProfileException("Incoming message was not of the proper type or contains no security token.");
547     response = dynamic_cast<const ElementProxy*>(response->getUnknownXMLObjects().front());
548     if (!response || !response->hasChildren())
549         throw FatalProfileException("Token wrapper element did not contain a security token.");
550     const saml1::Assertion* token = dynamic_cast<const saml1::Assertion*>(response->getUnknownXMLObjects().front());
551     if (!token || !token->getSignature())
552         throw FatalProfileException("Incoming message did not contain a signed SAML 1.1 assertion.");
553
554     // Extract message and issuer details from assertion.
555     extractMessageDetails(*token, m_protocol.get(), policy);
556
557     // Run the policy over the assertion. Handles replay, freshness, and
558     // signature verification, assuming the relevant rules are configured.
559     policy.evaluate(*token);
560     
561     // If no security is in place now, we kick it.
562     if (!policy.isAuthenticated())
563         throw SecurityPolicyException("Unable to establish security of incoming assertion.");
564
565     // Now do profile and core semantic validation to ensure we can use it for SSO.
566     // Profile validator.
567     time_t now = time(NULL);
568     saml1::AssertionValidator ssoValidator(application.getAudiences(), now);
569     ssoValidator.validateAssertion(*token);
570     if (!token->getConditions() || !token->getConditions()->getNotBefore() || !token->getConditions()->getNotOnOrAfter())
571         throw FatalProfileException("Assertion did not contain time conditions.");
572     else if (token->getAuthenticationStatements().empty())
573         throw FatalProfileException("Assertion did not contain an authentication statement.");
574
575     // With ADFS, we only have one token, but we need to put it in a vector.
576     vector<const Assertion*> tokens(1,token);
577     const saml1::AuthenticationStatement* ssoStatement=token->getAuthenticationStatements().front();
578
579     // Address checking.
580     saml1::SubjectLocality* locality = ssoStatement->getSubjectLocality();
581     if (locality && locality->getIPAddress()) {
582         auto_ptr_char ip(locality->getIPAddress());
583         checkAddress(application, httpRequest, ip.get());
584     }
585
586     m_log.debug("ADFS profile processing completed successfully");
587
588     saml1::NameIdentifier* n = ssoStatement->getSubject()->getNameIdentifier();
589
590     // Now we have to extract the authentication details for attribute and session setup.
591
592     // Session expiration for ADFS is purely SP-driven, and the method is mapped to a ctx class.
593     const PropertySet* sessionProps = application.getPropertySet("Sessions");
594     pair<bool,unsigned int> lifetime = sessionProps ? sessionProps->getUnsignedInt("lifetime") : pair<bool,unsigned int>(true,28800);
595     if (!lifetime.first || lifetime.second == 0)
596         lifetime.second = 28800;
597
598     // We've successfully "accepted" the SSO token.
599     // To complete processing, we need to extract and resolve attributes and then create the session.
600
601     // Normalize the SAML 1.x NameIdentifier...
602     auto_ptr<saml2::NameID> nameid(n ? saml2::NameIDBuilder::buildNameID() : NULL);
603     if (n) {
604         nameid->setName(n->getName());
605         nameid->setFormat(n->getFormat());
606         nameid->setNameQualifier(n->getNameQualifier());
607     }
608
609     // The context will handle deleting attributes and new tokens.
610         auto_ptr<ResolutionContext> ctx(
611         resolveAttributes(
612             application,
613             policy.getIssuerMetadata(),
614             m_protocol.get(),
615             n,
616             nameid.get(),
617             ssoStatement->getAuthenticationMethod(),
618             NULL,
619             &tokens
620             )
621         );
622
623     if (ctx.get()) {
624         // Copy over any new tokens, but leave them in the context for cleanup.
625         tokens.insert(tokens.end(), ctx->getResolvedAssertions().begin(), ctx->getResolvedAssertions().end());
626     }
627
628     return application.getServiceProvider().getSessionCache()->insert(
629         now + lifetime.second,
630         application,
631         httpRequest.getRemoteAddr().c_str(),
632         policy.getIssuerMetadata() ? dynamic_cast<const EntityDescriptor*>(policy.getIssuerMetadata()->getParent()) : NULL,
633         m_protocol.get(),
634         nameid.get(),
635         ssoStatement->getAuthenticationInstant() ? ssoStatement->getAuthenticationInstant()->getRawData() : NULL,
636         NULL,
637         ssoStatement->getAuthenticationMethod(),
638         NULL,
639         &tokens,
640         ctx.get() ? &ctx->getResolvedAttributes() : NULL
641         );
642 }
643
644 #endif
645
646 pair<bool,long> ADFSLogoutInitiator::run(SPRequest& request, bool isHandler) const
647 {
648     // Normally we'd do notifications and session clearage here, but ADFS logout
649     // is missing the needed request/response features, so we have to rely on
650     // the IdP half to notify us back about the logout and do the work there.
651     // Basically we have no way to tell in the Logout receiving handler whether
652     // we initiated the logout or not.
653
654     Session* session = NULL;
655     try {
656         session = request.getSession(false, true, false);  // don't cache it and ignore all checks
657         if (!session)
658             return make_pair(false,0L);
659
660         // We only handle ADFS sessions.
661         if (!XMLString::equals(session->getProtocol(), WSFED_NS) || !session->getEntityID()) {
662             session->unlock();
663             return make_pair(false,0L);
664         }
665     }
666     catch (exception& ex) {
667         m_log.error("error accessing current session: %s", ex.what());
668         return make_pair(false,0L);
669     }
670
671     string entityID(session->getEntityID());
672     session->unlock();
673
674     if (SPConfig::getConfig().isEnabled(SPConfig::OutOfProcess)) {
675         // When out of process, we run natively.
676         return doRequest(request.getApplication(), request.getRequestURL(), entityID.c_str(), request);
677     }
678     else {
679         // When not out of process, we remote the request.
680         Locker locker(session, false);
681         DDF out,in(m_address.c_str());
682         DDFJanitor jin(in), jout(out);
683         in.addmember("application_id").string(request.getApplication().getId());
684         in.addmember("url").string(request.getRequestURL());
685         in.addmember("entity_id").string(entityID.c_str());
686         out=request.getServiceProvider().getListenerService()->send(in);
687         return unwrap(request, out);
688     }
689 }
690
691 void ADFSLogoutInitiator::receive(DDF& in, ostream& out)
692 {
693 #ifndef SHIBSP_LITE
694     // Find application.
695     const char* aid=in["application_id"].string();
696     const Application* app=aid ? SPConfig::getConfig().getServiceProvider()->getApplication(aid) : NULL;
697     if (!app) {
698         // Something's horribly wrong.
699         m_log.error("couldn't find application (%s) for logout", aid ? aid : "(missing)");
700         throw ConfigurationException("Unable to locate application for logout, deleted?");
701     }
702     
703     // Set up a response shim.
704     DDF ret(NULL);
705     DDFJanitor jout(ret);
706     auto_ptr<HTTPResponse> resp(getResponse(ret));
707     
708     // Since we're remoted, the result should either be a throw, which we pass on,
709     // a false/0 return, which we just return as an empty structure, or a response/redirect,
710     // which we capture in the facade and send back.
711     doRequest(*app, in["url"].string(), in["entity_id"].string(), *resp.get());
712
713     out << ret;
714 #else
715     throw ConfigurationException("Cannot perform logout using lite version of shibsp library.");
716 #endif
717 }
718
719 pair<bool,long> ADFSLogoutInitiator::doRequest(
720     const Application& application, const char* requestURL, const char* entityID, HTTPResponse& response
721     ) const
722 {
723 #ifndef SHIBSP_LITE
724     try {
725         if (!entityID)
726             throw ConfigurationException("Missing entityID parameter.");
727
728         // With a session in hand, we can create a request message, if we can find a compatible endpoint.
729         MetadataProvider* m=application.getMetadataProvider();
730         Locker locker(m);
731         MetadataProvider::Criteria mc(entityID, &IDPSSODescriptor::ELEMENT_QNAME, m_binding.get());
732         pair<const EntityDescriptor*,const RoleDescriptor*> entity=m->getEntityDescriptor(mc);
733         if (!entity.first)
734             throw MetadataException("Unable to locate metadata for identity provider ($entityID)", namedparams(1, "entityID", entityID));
735         else if (!entity.second)
736             throw MetadataException("Unable to locate ADFS IdP role for identity provider ($entityID).", namedparams(1, "entityID", entityID));
737
738         const EndpointType* ep = EndpointManager<SingleLogoutService>(
739             dynamic_cast<const IDPSSODescriptor*>(entity.second)->getSingleLogoutServices()
740             ).getByBinding(m_binding.get());
741         if (!ep) {
742             throw MetadataException(
743                 "Unable to locate ADFS single logout service for identity provider ($entityID).",
744                 namedparams(1, "entityID", entityID)
745                 );
746         }
747
748         auto_ptr_char dest(ep->getLocation());
749
750         string req=string(dest.get()) + (strchr(dest.get(),'?') ? '&' : '?') + "wa=wsignout1.0";
751         return make_pair(true,response.sendRedirect(req.c_str()));
752     }
753     catch (exception& ex) {
754         m_log.error("error issuing ADFS logout request: %s", ex.what());
755     }
756
757     return make_pair(false,0L);
758 #else
759     throw ConfigurationException("Cannot perform logout using lite version of shibsp library.");
760 #endif
761 }
762
763 pair<bool,long> ADFSLogout::run(SPRequest& request, bool isHandler) const
764 {
765     // Defer to base class for front-channel loop first.
766     // This won't initiate the loop, only continue/end it.
767     pair<bool,long> ret = LogoutHandler::run(request, isHandler);
768     if (ret.first)
769         return ret;
770
771     // wa parameter indicates the "action" to perform
772     bool returning = false;
773     const char* param = request.getParameter("wa");
774     if (param) {
775         if (!strcmp(param, "wsignin1.0"))
776             return m_login.run(request, isHandler);
777         else if (strcmp(param, "wsignout1.0") && strcmp(param, "wsignoutcleanup1.0"))
778             throw FatalProfileException("Unsupported WS-Federation action paremeter ($1).", params(1, param));
779     }
780     else if (strcmp(request.getMethod(),"GET") || !request.getParameter("notifying"))
781         throw FatalProfileException("Unsupported request to ADFS protocol endpoint.");
782     else
783         returning = true;
784
785     param = request.getParameter("wreply");
786     const Application& app = request.getApplication();
787
788     // Get the session_id.
789     pair<string,const char*> shib_cookie = app.getCookieNameProps("_shibsession_");
790     const char* session_id = request.getCookie(shib_cookie.first.c_str());
791
792     if (!returning) {
793         // Pass control to the first front channel notification point, if any.
794         map<string,string> parammap;
795         if (param)
796             parammap["wreply"] = param;
797         pair<bool,long> result = notifyFrontChannel(app, request, request, &parammap);
798         if (result.first)
799             return result;
800     }
801
802     // Best effort on back channel and to remove the user agent's session.
803     if (session_id) {
804         vector<string> sessions(1,session_id);
805         notifyBackChannel(app, request.getRequestURL(), sessions, false);
806         try {
807             app.getServiceProvider().getSessionCache()->remove(session_id, app);
808         }
809         catch (exception& ex) {
810             m_log.error("error removing session (%s): %s", session_id, ex.what());
811         }
812         request.setCookie(shib_cookie.first.c_str(), shib_cookie.second);
813     }
814
815     if (param)
816         return make_pair(true, request.sendRedirect(param));
817     return sendLogoutPage(app, request, false, "Logout complete.");
818 }