shibboleth-3.0.1
|
Interface to server request being processed. More...
#include <shibsp/SPRequest.h>
Public Types | |
enum | SPLogLevel { SPDebug, SPInfo, SPWarn, SPError, SPCrit } |
Portable logging levels. More... | |
Public Member Functions | |
virtual const ServiceProvider & | getServiceProvider () const =0 |
Returns the locked ServiceProvider processing the request. More... | |
virtual RequestMapper::Settings | getRequestSettings () const =0 |
Returns RequestMapper Settings associated with the request, guaranteed to be valid for the request's duration. More... | |
virtual const Application & | getApplication () const =0 |
Returns the Application governing the request. More... | |
virtual Session * | getSession (bool checkTimeout=true, bool ignoreAddress=false, bool cache=true)=0 |
Returns a locked Session associated with the request. More... | |
virtual const char * | getHandlerURL (const char *resource=nullptr) const =0 |
Returns the effective base Handler URL for a resource, or the current request URL. More... | |
virtual std::string | getSecureHeader (const char *name) const =0 |
Returns a non-spoofable request header value, if possible. More... | |
virtual void | clearHeader (const char *rawname, const char *cginame)=0 |
Ensures no value exists for a request header. More... | |
virtual void | setHeader (const char *name, const char *value)=0 |
Sets a value for a request header. More... | |
virtual void | setRemoteUser (const char *user)=0 |
Establish REMOTE_USER identity in request. More... | |
virtual void | setAuthType (const char *authtype)=0 |
Establish AUTH_TYPE for request. More... | |
virtual void | log (SPLogLevel level, const std::string &msg) const =0 |
Log to native server environment. More... | |
virtual bool | isPriorityEnabled (SPLogLevel level) const =0 |
Test logging level. More... | |
virtual long | returnDecline ()=0 |
Indicates that processing was declined, meaning no action is required during this phase of processing. More... | |
virtual long | returnOK ()=0 |
Indicates that processing was completed. More... | |
Interface to server request being processed.
To supply information from the surrounding web server environment, a shim must be supplied in the form of this interface to adapt the library to different proprietary server APIs.
This interface need not be threadsafe.
Portable logging levels.
|
pure virtual |
Ensures no value exists for a request header.
rawname | raw name of header to clear |
cginame | CGI-equivalent name of header |
|
pure virtual |
Returns the Application governing the request.
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Returns the effective base Handler URL for a resource, or the current request URL.
resource | resource URL to compute handler for |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Returns RequestMapper Settings associated with the request, guaranteed to be valid for the request's duration.
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Returns a non-spoofable request header value, if possible.
Platforms that support environment export can redirect header lookups by overriding this method.
name | the name of the secure header to return |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Returns the locked ServiceProvider processing the request.
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Returns a locked Session associated with the request.
checkTimeout | true iff the last-used timestamp should be updated and any timeout policy enforced |
ignoreAddress | true iff all address checking should be ignored, regardless of policy |
cache | true iff the request should hold the Session lock itself and unlock during cleanup |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Test logging level.
level | logging level |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Log to native server environment.
level | logging level |
msg | message to log |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Indicates that processing was declined, meaning no action is required during this phase of processing.
|
pure virtual |
Indicates that processing was completed.
|
pure virtual |
Establish AUTH_TYPE for request.
authtype | AUTH_TYPE value to set or nullptr to clear |
Implemented in shibsp::AbstractSPRequest.
|
pure virtual |
Sets a value for a request header.
name | name of header to set |
value | value to set |
|
pure virtual |
Establish REMOTE_USER identity in request.
user | REMOTE_USER value to set or nullptr to clear |