org.aselect.server.authspprotocol.handler
Class IP

java.lang.Object
  extended by org.aselect.server.authspprotocol.handler.IP
All Implemented Interfaces:
IAuthSPProtocolHandler

public class IP
extends java.lang.Object
implements IAuthSPProtocolHandler

The IP AuthSP Handler.

Description:
The IP AuthSP Handler communicates with the IP AuthSP by using redirections.

Concurrency issues:
None

Protocol Description
Outgoing request going to the IP AuthSP:

name value
ridA-Select Server request id
uidA-Select Server user ID
as_urlA-Select Server url
iprange[1..n]All configured ip ranges (numbered)
a-select-serverA-Select Server ID
signature signature of all paramater values in the above sequence

Incoming response, which is returned by the IP AuthSP:
name value
ridA-Select Server request id
result_codeAuthSP result code
a-select-serverA-Select Server ID
signature Signature over the following data:
  1. rid
  2. The URL that was created in computeAuthenticationRequest()
  3. result_code
  4. a-select-server

Author:
Alfa & Ariss

Constructor Summary
IP()
           
 
Method Summary
 java.util.Hashtable computeAuthenticationRequest(java.lang.String sRid)
          Creates the authentication request URL.
 void init(java.lang.Object oAuthSPConfig, java.lang.Object oAuthSPResource)
          Initializes the IP AuthSP handler.
 java.util.Hashtable verifyAuthenticationResponse(java.util.Hashtable htAuthSPResponse)
          Verifies the response from the AuthSP.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IP

public IP()
Method Detail

init

public void init(java.lang.Object oAuthSPConfig,
                 java.lang.Object oAuthSPResource)
          throws ASelectAuthSPException
Initializes the IP AuthSP handler.

Description:
Performs the following steps:

Specified by:
init in interface IAuthSPProtocolHandler
Parameters:
oAuthSPConfig - Object containing the authsp specific configuration.
oAuthSPResource - Object containing the authsp specific resource(s).
Throws:
ASelectAuthSPException - If initialization fails.
See Also:
IAuthSPProtocolHandler.init(java.lang.Object, java.lang.Object)

computeAuthenticationRequest

public java.util.Hashtable computeAuthenticationRequest(java.lang.String sRid)
Creates the authentication request URL.

Description:
This method creates a hashtable with the follwing contents:
key value
result Errors.ERROR_ASELECT_SUCCESS or an error code if creating the authentication request URL fails
redirect_url The URL to the AuthSP including the protocol parameters as specified if the class description.

Specified by:
computeAuthenticationRequest in interface IAuthSPProtocolHandler
Parameters:
sRid - Needed parameter in the redirect URL. Can also be used to retrieve session information from the SessionManager.
Returns:
Hashtable containing at least:
  • result
  • redirect_url
See Also:
IAuthSPProtocolHandler.computeAuthenticationRequest(java.lang.String)

verifyAuthenticationResponse

public java.util.Hashtable verifyAuthenticationResponse(java.util.Hashtable htAuthSPResponse)
Verifies the response from the AuthSP.

Description:
This method verifies the response from the AuthSP. The response parameters are placed in htAuthspResponse and are described in the class description.

This method creates a hashtable with the following contents:
key value
result Errors.ERROR_ASELECT_SUCCESS or an error code if the authentication response was invalid or the user was not authenticated.
rid The A-Select request identifier of this authentication.

Specified by:
verifyAuthenticationResponse in interface IAuthSPProtocolHandler
Parameters:
htAuthSPResponse - Hashtable containing all parameters that were received from the AuthSP. It should contain at least:
  • rid
Returns:
Hashtable containing at least:
  • result
  • rid
See Also:
IAuthSPProtocolHandler.verifyAuthenticationResponse(java.util.Hashtable)


Copyright © 2008 SURFnet BV. All Rights Reserved.