org.aselect.server.cross
Interface ISelectorHandler

All Known Implementing Classes:
DefaultSelectorHandler, IdpSelectorHandler, RedirectSelectorHandler, RegexSelectorHandler, SFSSelectorHandler

public interface ISelectorHandler

Handler to determine the remote A-Select Server.

Description:
Selector handler will 'tell' A-Select which remote A-Select Server should be used to set up a 'cross-authenticate' request.
Handlers may use HTML forms to gather user information.
If applicable, the handler can also pass a user-id to A-Select.


Concurrency issues:
- Only one instance of a Handler is created within A-Select that will be active till A-Select stops/restarts.

Author:
Alfa & Ariss

Method Summary
 java.util.Hashtable getRemoteServerId(java.util.Hashtable htServiceRequest, javax.servlet.http.HttpServletResponse servletResponse, java.io.PrintWriter pwOut)
          Entry point of the handler during cross-authentication.
 void init(java.lang.Object oHandlerConfig)
          Handler specific initialization.
 

Method Detail

init

void init(java.lang.Object oHandlerConfig)
          throws ASelectException
Handler specific initialization.

Description:
-

Concurrency issues:
Called at startup of A-Select.

Preconditions:
-

Postconditions:
-

Parameters:
oHandlerConfig -
Throws:
ASelectConfigException
ASelectException

getRemoteServerId

java.util.Hashtable getRemoteServerId(java.util.Hashtable htServiceRequest,
                                      javax.servlet.http.HttpServletResponse servletResponse,
                                      java.io.PrintWriter pwOut)
                                      throws ASelectException
Entry point of the handler during cross-authentication. Handler may present the user with a HTML page here to gather more information. If done so, the function must return null.
The HTML page should contain a form with request=cross_login.
If enough information is gathered, the function should return a Hashtable as described below.

Parameters:
htServiceRequest -
servletResponse -
pwOut -
Returns:
Hashtable containing
  • 'organization_id'
  • 'user_id' (optional)
or NULL
Throws:
ASelectException


Copyright © 2008 SURFnet BV. All Rights Reserved.