edu.utexas.its.eis.tools.qwicap.servlet
Interface Auth2SchemeReply


public interface Auth2SchemeReply

Instances of classes implementing this interface inform Qwicap of the outcome of an authentication & authorization (Auth2) operation, as conducted by the Auth2Scheme.qwicapAuth2SchemeHit method. It tells Qwicap whether a user can access a web application's static content and/or its dynamic content. If the user is not be to permitted access to either type of content, Qwicap prevents all access to the web application, and does so in such a way that no server-side state is created for the user.

An authenication & authorization scheme that wishes to provide its client application with additional information about users should add the necessary retrieval methods to the class that implements this Auth2SchemeReply interface. The client application can retrieve the instance of that class which concerns the most recent, valid hit by invoking the Qwicap.getAuth2SchemeReply() method, and can then typecast the returned object to whatever class it knows that its Auth2Scheme is supplying. It can then use whatever methods that class supplies for retrieving information about the user. (Since it seems impossible to indentify a truly universal subset of authentication & authorization information, and its representation, the Auth2SchemeReply interface makes no effort to specify such methods.)

Author:
Chris W. Johnson
See Also:
Auth2Scheme, Auth2SchemeFactory

Method Summary
 boolean qwicapCanInvokeWebApplication()
          Returns true to inform Qwicap that requests intended for the web application should be passed along to it, or false if they should be discarded.
 boolean qwicapCanSendStaticFiles()
          Returns true to inform Qwicap that requests for static files in the web application should be fulfilled, or false if they should be refused.
 boolean qwicapShouldDiscardThisSession()
          Returns true to inform Qwicap to halt and discard the current session.
 

Method Detail

qwicapCanSendStaticFiles

boolean qwicapCanSendStaticFiles()
Returns true to inform Qwicap that requests for static files in the web application should be fulfilled, or false if they should be refused.

Returns:
true to inform Qwicap that requests for static files in the web application should be fulfilled, or false if they should be refused.

qwicapCanInvokeWebApplication

boolean qwicapCanInvokeWebApplication()
Returns true to inform Qwicap that requests intended for the web application should be passed along to it, or false if they should be discarded. This also applies to requests for Downloadable content.

Returns:
true to inform Qwicap that requests intended for the web application should be passed along to it, or false if they should be discarded.

qwicapShouldDiscardThisSession

boolean qwicapShouldDiscardThisSession()
Returns true to inform Qwicap to halt and discard the current session.

Returns:
true to inform Qwicap to halt and discard the current session, false otherwise.