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 * Interface to a Shibboleth ServiceProvider instance.
24 #include "exceptions.h"
25 #include "AccessControl.h"
26 #include "Application.h"
27 #include "ServiceProvider.h"
28 #include "SessionCache.h"
29 #include "SPRequest.h"
30 #include "attribute/Attribute.h"
31 #include "handler/SessionInitiator.h"
32 #include "util/TemplateParameters.h"
36 #include <xmltooling/XMLToolingConfig.h>
37 #include <xmltooling/util/NDC.h>
38 #include <xmltooling/util/URLEncoder.h>
39 #include <xmltooling/util/XMLHelper.h>
41 using namespace shibsp;
42 using namespace xmltooling;
46 SHIBSP_DLLLOCAL PluginManager<ServiceProvider,string,const DOMElement*>::Factory XMLServiceProviderFactory;
48 long SHIBSP_DLLLOCAL sendError(SPRequest& request, const Application* app, const char* page, TemplateParameters& tp, bool mayRedirect=false)
51 // Check for redirection on errors instead of template.
52 pair<bool,const char*> redirectErrors = app ? app->getString("redirectErrors") : pair<bool,const char*>(false,NULL);
53 if (redirectErrors.first) {
54 string loc(redirectErrors.second);
55 loc = loc + '?' + tp.toQueryString();
56 return request.sendRedirect(loc.c_str());
60 request.setContentType("text/html");
61 request.setResponseHeader("Expires","01-Jan-1997 12:00:00 GMT");
62 request.setResponseHeader("Cache-Control","private,no-store,no-cache");
64 // Error templates come from the request's settings or from the Errors property set.
65 pair<bool,const char*> pathname = pair<bool,const char*>(false,NULL);
67 RequestMapper::Settings settings = request.getRequestSettings();
68 string pagename(page);
70 pathname = settings.first->getString(pagename.c_str());
72 catch (exception& ex) {
73 request.log(SPRequest::SPError, ex.what());
76 // Nothing for request, so check app properties.
77 const PropertySet* props=app ? app->getPropertySet("Errors") : NULL;
78 if (!pathname.first && props)
79 pathname=props->getString(page);
82 ifstream infile(pathname.second);
84 tp.setPropertySet(props);
86 XMLToolingConfig::getConfig().getTemplateEngine()->run(infile, str, tp, tp.getRichException());
87 return request.sendResponse(str);
91 if (!strcmp(page,"access")) {
92 istringstream msg("Access Denied");
93 return request.sendResponse(msg, HTTPResponse::XMLTOOLING_HTTP_STATUS_FORBIDDEN);
96 string errstr = string("sendError could not process error template (") + page + ")";
97 request.log(SPRequest::SPError, errstr);
98 istringstream msg("Internal Server Error. Please contact the site administrator.");
99 return request.sendError(msg);
102 void SHIBSP_DLLLOCAL clearHeaders(SPRequest& request) {
103 request.clearHeader("Shib-Session-ID", "HTTP_SHIB_SESSION_ID");
104 request.clearHeader("Shib-Identity-Provider", "HTTP_SHIB_IDENTITY_PROVIDER");
105 request.clearHeader("Shib-Authentication-Method", "HTTP_SHIB_AUTHENTICATION_METHOD");
106 request.clearHeader("Shib-AuthnContext-Class", "HTTP_SHIB_AUTHNCONTEXT_CLASS");
107 request.clearHeader("Shib-AuthnContext-Decl", "HTTP_SHIB_AUTHNCONTEXT_DECL");
108 request.clearHeader("Shib-Assertion-Count", "HTTP_SHIB_ASSERTION_COUNT");
109 request.clearHeader("REMOTE_USER", "HTTP_REMOTE_USER");
110 //request.clearHeader("Shib-Application-ID"); handle inside app method
111 request.getApplication().clearAttributeHeaders(request);
115 void SHIBSP_API shibsp::registerServiceProviders()
117 SPConfig::getConfig().ServiceProviderManager.registerFactory(XML_SERVICE_PROVIDER, XMLServiceProviderFactory);
120 pair<bool,long> ServiceProvider::doAuthentication(SPRequest& request, bool handler) const
123 xmltooling::NDC ndc("doAuthentication");
126 const Application* app=NULL;
127 string targetURL = request.getRequestURL();
130 RequestMapper::Settings settings = request.getRequestSettings();
131 app = &(request.getApplication());
133 // If not SSL, check to see if we should block or redirect it.
134 if (!request.isSecure()) {
135 pair<bool,const char*> redirectToSSL = settings.first->getString("redirectToSSL");
136 if (redirectToSSL.first) {
137 #ifdef HAVE_STRCASECMP
138 if (!strcasecmp("GET",request.getMethod()) || !strcasecmp("HEAD",request.getMethod())) {
140 if (!stricmp("GET",request.getMethod()) || !stricmp("HEAD",request.getMethod())) {
142 // Compute the new target URL
143 string redirectURL = string("https://") + request.getHostname();
144 if (strcmp(redirectToSSL.second,"443")) {
145 redirectURL = redirectURL + ':' + redirectToSSL.second;
147 redirectURL += request.getRequestURI();
148 return make_pair(true, request.sendRedirect(redirectURL.c_str()));
151 TemplateParameters tp;
152 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
153 return make_pair(true,sendError(request, app, "ssl", tp));
158 const char* handlerURL=request.getHandlerURL(targetURL.c_str());
160 throw ConfigurationException("Cannot determine handler from resource URL, check configuration.");
162 // If the request URL contains the handler base URL for this application, either dispatch
163 // directly (mainly Apache 2.0) or just pass back control.
164 if (strstr(targetURL.c_str(),handlerURL)) {
166 return doHandler(request);
168 return make_pair(true, request.returnOK());
171 // Three settings dictate how to proceed.
172 pair<bool,const char*> authType = settings.first->getString("authType");
173 pair<bool,bool> requireSession = settings.first->getBool("requireSession");
174 pair<bool,const char*> requireSessionWith = settings.first->getString("requireSessionWith");
176 // If no session is required AND the AuthType (an Apache-derived concept) isn't shibboleth,
177 // then we ignore this request and consider it unprotected. Apache might lie to us if
178 // ShibBasicHijack is on, but that's up to it.
179 if ((!requireSession.first || !requireSession.second) && !requireSessionWith.first &&
180 #ifdef HAVE_STRCASECMP
181 (!authType.first || strcasecmp(authType.second,"shibboleth")))
183 (!authType.first || _stricmp(authType.second,"shibboleth")))
185 return make_pair(true,request.returnDecline());
187 // Fix for secadv 20050901
188 clearHeaders(request);
190 Session* session = NULL;
192 session = request.getSession();
194 catch (exception& e) {
195 request.log(SPRequest::SPWarn, string("error during session lookup: ") + e.what());
196 // If it's not a retryable session failure, we throw to the outer handler for reporting.
197 if (dynamic_cast<opensaml::RetryableProfileException*>(&e)==NULL)
202 // No session. Maybe that's acceptable?
203 if ((!requireSession.first || !requireSession.second) && !requireSessionWith.first)
204 return make_pair(true,request.returnOK());
206 // No session, but we require one. Initiate a new session using the indicated method.
207 const Handler* initiator=NULL;
208 if (requireSessionWith.first) {
209 initiator=app->getSessionInitiatorById(requireSessionWith.second);
211 throw ConfigurationException(
212 "No session initiator found with id ($1), check requireSessionWith command.",
213 params(1,requireSessionWith.second)
217 initiator=app->getDefaultSessionInitiator();
219 throw ConfigurationException("No default session initiator found, check configuration.");
222 return initiator->run(request,false);
225 // We're done. Everything is okay. Nothing to report. Nothing to do..
226 // Let the caller decide how to proceed.
227 request.log(SPRequest::SPDebug, "doAuthentication succeeded");
228 return make_pair(false,0);
230 catch (exception& e) {
231 TemplateParameters tp(&e);
232 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
233 return make_pair(true,sendError(request, app, "session", tp));
237 TemplateParameters tp;
238 tp.m_map["errorType"] = "Unexpected Error";
239 tp.m_map["errorText"] = "Caught an unknown exception.";
240 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
241 return make_pair(true,sendError(request, app, "session", tp));
246 pair<bool,long> ServiceProvider::doAuthorization(SPRequest& request) const
249 xmltooling::NDC ndc("doAuthorization");
252 const Application* app=NULL;
253 string targetURL = request.getRequestURL();
256 RequestMapper::Settings settings = request.getRequestSettings();
257 app = &(request.getApplication());
259 // Three settings dictate how to proceed.
260 pair<bool,const char*> authType = settings.first->getString("authType");
261 pair<bool,bool> requireSession = settings.first->getBool("requireSession");
262 pair<bool,const char*> requireSessionWith = settings.first->getString("requireSessionWith");
264 // If no session is required AND the AuthType (an Apache-derived concept) isn't shibboleth,
265 // then we ignore this request and consider it unprotected. Apache might lie to us if
266 // ShibBasicHijack is on, but that's up to it.
267 if ((!requireSession.first || !requireSession.second) && !requireSessionWith.first &&
268 #ifdef HAVE_STRCASECMP
269 (!authType.first || strcasecmp(authType.second,"shibboleth")))
271 (!authType.first || _stricmp(authType.second,"shibboleth")))
273 return make_pair(true,request.returnDecline());
275 // Do we have an access control plugin?
276 if (settings.second) {
277 const Session* session = NULL;
279 session = request.getSession(false);
281 catch (exception& e) {
282 request.log(SPRequest::SPWarn, string("unable to obtain session to pass to access control provider: ") + e.what());
285 Locker acllock(settings.second);
286 if (settings.second->authorized(request,session)) {
287 // Let the caller decide how to proceed.
288 request.log(SPRequest::SPDebug, "access control provider granted access");
289 return make_pair(false,0);
292 request.log(SPRequest::SPWarn, "access control provider denied access");
293 TemplateParameters tp;
294 tp.m_map["requestURL"] = targetURL;
295 return make_pair(true,sendError(request, app, "access", tp));
297 return make_pair(false,0);
300 return make_pair(true,request.returnDecline());
302 catch (exception& e) {
303 TemplateParameters tp(&e);
304 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
305 return make_pair(true,sendError(request, app, "access", tp));
309 TemplateParameters tp;
310 tp.m_map["errorType"] = "Unexpected Error";
311 tp.m_map["errorText"] = "Caught an unknown exception.";
312 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
313 return make_pair(true,sendError(request, app, "access", tp));
318 pair<bool,long> ServiceProvider::doExport(SPRequest& request, bool requireSession) const
321 xmltooling::NDC ndc("doExport");
324 const Application* app=NULL;
325 string targetURL = request.getRequestURL();
328 RequestMapper::Settings settings = request.getRequestSettings();
329 app = &(request.getApplication());
331 const Session* session = NULL;
333 session = request.getSession(false);
335 catch (exception& e) {
336 request.log(SPRequest::SPWarn, string("unable to obtain session to export to request: ") + e.what());
337 // If we have to have a session, then this is a fatal error.
345 throw opensaml::RetryableProfileException("Unable to obtain session to export to request.");
347 return make_pair(false,0); // just bail silently
350 request.setHeader("Shib-Application-ID", app->getId());
351 request.setHeader("Shib-Session-ID", session->getID());
353 // Export the IdP name and Authn method/context info.
354 const char* hval = session->getEntityID();
356 request.setHeader("Shib-Identity-Provider", hval);
357 hval = session->getAuthnContextClassRef();
359 request.setHeader("Shib-Authentication-Method", hval);
360 request.setHeader("Shib-AuthnContext-Class", hval);
362 hval = session->getAuthnContextDeclRef();
364 request.setHeader("Shib-AuthnContext-Decl", hval);
366 // Maybe export the assertion keys.
367 pair<bool,bool> exp=settings.first->getBool("exportAssertion");
368 if (exp.first && exp.second) {
369 const PropertySet* sessions=app->getPropertySet("Sessions");
370 pair<bool,const char*> exportLocation = sessions ? sessions->getString("exportLocation") : pair<bool,const char*>(false,NULL);
371 if (!exportLocation.first)
372 request.log(SPRequest::SPWarn, "can't export assertions without an exportLocation Sessions property");
374 const URLEncoder* encoder = XMLToolingConfig::getConfig().getURLEncoder();
375 string exportName = "Shib-Assertion-00";
377 if (!strncmp(exportLocation.second, "http", 4))
378 baseURL = exportLocation.second;
380 baseURL = string(request.getHandlerURL(targetURL.c_str())) + exportLocation.second;
381 baseURL = baseURL + "?key=" + session->getID() + "&ID=";
382 const vector<const char*>& tokens = session->getAssertionIDs();
383 vector<const char*>::size_type count = 0;
384 for (vector<const char*>::const_iterator tokenids = tokens.begin(); tokenids!=tokens.end(); ++tokenids) {
386 *(exportName.rbegin()) = '0' + (count%10);
387 *(++exportName.rbegin()) = '0' + (count/10);
388 string fullURL = baseURL + encoder->encode(*tokenids);
389 request.setHeader(exportName.c_str(), fullURL.c_str());
391 request.setHeader("Shib-Assertion-Count", exportName.c_str() + 15);
395 // Export the attributes.
396 bool remoteUserSet = false;
397 const multimap<string,const Attribute*>& attributes = session->getIndexedAttributes();
398 for (multimap<string,const Attribute*>::const_iterator a = attributes.begin(); a!=attributes.end(); ++a) {
399 const vector<string>& vals = a->second->getSerializedValues();
401 // See if this needs to be set as the REMOTE_USER value.
402 if (!remoteUserSet && !vals.empty() && app->getRemoteUserAttributeIds().count(a->first)) {
403 request.setRemoteUser(vals.front().c_str());
404 remoteUserSet = true;
407 // Handle the normal export case.
408 string header(request.getSecureHeader(a->first.c_str()));
409 for (vector<string>::const_iterator v = vals.begin(); v!=vals.end(); ++v) {
412 string::size_type pos = v->find_first_of(';',string::size_type(0));
413 if (pos!=string::npos) {
415 for (; pos != string::npos; pos = value.find_first_of(';',pos)) {
416 value.insert(pos, "\\");
425 request.setHeader(a->first.c_str(), header.c_str());
428 return make_pair(false,0);
430 catch (exception& e) {
431 TemplateParameters tp(&e);
432 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
433 return make_pair(true,sendError(request, app, "session", tp));
437 TemplateParameters tp;
438 tp.m_map["errorType"] = "Unexpected Error";
439 tp.m_map["errorText"] = "Caught an unknown exception.";
440 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
441 return make_pair(true,sendError(request, app, "session", tp));
446 pair<bool,long> ServiceProvider::doHandler(SPRequest& request) const
449 xmltooling::NDC ndc("doHandler");
452 const Application* app=NULL;
453 string targetURL = request.getRequestURL();
456 RequestMapper::Settings settings = request.getRequestSettings();
457 app = &(request.getApplication());
459 const char* handlerURL=request.getHandlerURL(targetURL.c_str());
461 throw ConfigurationException("Cannot determine handler from resource URL, check configuration.");
463 // Make sure we only process handler requests.
464 if (!strstr(targetURL.c_str(),handlerURL))
465 return make_pair(true, request.returnDecline());
467 const PropertySet* sessionProps=app->getPropertySet("Sessions");
469 throw ConfigurationException("Unable to map request to application session settings, check configuration.");
471 // Process incoming request.
472 pair<bool,bool> handlerSSL=sessionProps->getBool("handlerSSL");
474 // Make sure this is SSL, if it should be
475 if ((!handlerSSL.first || handlerSSL.second) && !request.isSecure())
476 throw opensaml::FatalProfileException("Blocked non-SSL access to Shibboleth handler.");
478 // We dispatch based on our path info. We know the request URL begins with or equals the handler URL,
479 // so the path info is the next character (or null).
480 const Handler* handler=app->getHandler(targetURL.c_str() + strlen(handlerURL));
482 throw ConfigurationException("Shibboleth handler invoked at an unconfigured location.");
484 pair<bool,long> hret=handler->run(request);
486 // Did the handler run successfully?
490 throw ConfigurationException("Configured Shibboleth handler failed to process the request.");
492 catch (opensaml::saml2md::MetadataException& e) {
493 TemplateParameters tp(&e);
494 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
495 // See if a metadata error page is installed.
496 const PropertySet* props=app ? app->getPropertySet("Errors") : NULL;
498 pair<bool,const char*> p=props->getString("metadata");
500 return make_pair(true,sendError(request, app, "metadata", tp, true));
502 return make_pair(true,sendError(request, app, "session", tp, true));
504 catch (exception& e) {
505 TemplateParameters tp(&e);
506 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
507 return make_pair(true,sendError(request, app, "session", tp, true));
511 TemplateParameters tp;
512 tp.m_map["errorType"] = "Unexpected Error";
513 tp.m_map["errorText"] = "Caught an unknown exception.";
514 tp.m_map["requestURL"] = targetURL.substr(0,targetURL.find('?'));
515 return make_pair(true,sendError(request, app, "session", tp, true));