Change API to permit session initiators to modify the entityID mid-chain.
[shibboleth/sp.git] / shibsp / handler / impl / WAYFSessionInitiator.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  * WAYFSessionInitiator.cpp
19  * 
20  * Shibboleth WAYF support.
21  */
22
23 #include "internal.h"
24 #include "Application.h"
25 #include "exceptions.h"
26 #include "SPRequest.h"
27 #include "handler/AbstractHandler.h"
28 #include "handler/SessionInitiator.h"
29
30 #include <ctime>
31 #include <xmltooling/XMLToolingConfig.h>
32 #include <xmltooling/util/URLEncoder.h>
33
34 using namespace shibsp;
35 using namespace opensaml;
36 using namespace xmltooling;
37 using namespace std;
38
39 namespace shibsp {
40
41 #if defined (_MSC_VER)
42     #pragma warning( push )
43     #pragma warning( disable : 4250 )
44 #endif
45
46     class SHIBSP_DLLLOCAL WAYFSessionInitiator : public SessionInitiator, public AbstractHandler
47     {
48     public:
49         WAYFSessionInitiator(const DOMElement* e, const char* appId)
50                 : AbstractHandler(e, Category::getInstance(SHIBSP_LOGCAT".SessionInitiator.WAYF")), m_url(NULL) {
51             pair<bool,const char*> url = getString("URL");
52             if (!url.first)
53                 throw ConfigurationException("WAYF SessionInitiator requires a URL property.");
54             m_url = url.second;
55         }
56         virtual ~WAYFSessionInitiator() {}
57         
58         pair<bool,long> run(SPRequest& request, string& entityID, bool isHandler=true) const;
59
60     private:
61         const char* m_url;
62     };
63
64 #if defined (_MSC_VER)
65     #pragma warning( pop )
66 #endif
67
68     SessionInitiator* SHIBSP_DLLLOCAL WAYFSessionInitiatorFactory(const pair<const DOMElement*,const char*>& p)
69     {
70         return new WAYFSessionInitiator(p.first, p.second);
71     }
72
73 };
74
75 pair<bool,long> WAYFSessionInitiator::run(SPRequest& request, string& entityID, bool isHandler) const
76 {
77     // The IdP CANNOT be specified for us to run. Otherwise, we'd be redirecting to a WAYF
78     // anytime the IdP's metadata was wrong.
79     if (!entityID.empty())
80         return make_pair(false,0L);
81
82     string target;
83     const char* option;
84     const Handler* ACS=NULL;
85     const Application& app=request.getApplication();
86
87     if (isHandler) {
88         option=request.getParameter("acsIndex");
89         if (option) {
90             ACS=app.getAssertionConsumerServiceByIndex(atoi(option));
91             if (!ACS)
92                 request.log(SPRequest::SPWarn, "invalid acsIndex specified in request, using default ACS location");
93         }
94
95         option = request.getParameter("target");
96         if (option)
97             target = option;
98         recoverRelayState(request.getApplication(), request, request, target, false);
99     }
100     else {
101         // We're running as a "virtual handler" from within the filter.
102         // The target resource is the current one and everything else is defaulted.
103         target=request.getRequestURL();
104     }
105     
106     // Since we're not passing by index, we need to fully compute the return URL.
107     if (!ACS) {
108         pair<bool,unsigned int> index = getUnsignedInt("defaultACSIndex");
109         if (index.first) {
110             ACS = app.getAssertionConsumerServiceByIndex(index.second);
111             if (!ACS)
112                 request.log(SPRequest::SPWarn, "invalid defaultACSIndex, using default ACS location");
113         }
114         if (!ACS)
115             ACS = app.getDefaultAssertionConsumerService();
116     }
117
118     m_log.debug("sending request to WAYF (%s)", m_url);
119
120     // Compute the ACS URL. We add the ACS location to the base handlerURL.
121     string ACSloc=request.getHandlerURL(target.c_str());
122     pair<bool,const char*> loc=ACS ? ACS->getString("Location") : pair<bool,const char*>(false,NULL);
123     if (loc.first) ACSloc+=loc.second;
124
125     if (isHandler) {
126         // We may already have RelayState set if we looped back here,
127         // but just in case target is a resource, we reset it back.
128         option = request.getParameter("target");
129         if (option)
130             target = option;
131     }
132     preserveRelayState(request.getApplication(), request, target);
133
134     // WAYF requires a target value.
135     if (target.empty())
136         target = "default";
137
138     char timebuf[16];
139     sprintf(timebuf,"%lu",time(NULL));
140     const URLEncoder* urlenc = XMLToolingConfig::getConfig().getURLEncoder();
141     string req=string(m_url) + (strchr(m_url,'?') ? '&' : '?') + "shire=" + urlenc->encode(ACSloc.c_str()) +
142         "&time=" + timebuf + "&target=" + urlenc->encode(target.c_str()) +
143         "&providerId=" + urlenc->encode(app.getString("entityID").second);
144
145     return make_pair(true, request.sendRedirect(req.c_str()));
146 }