nl.gx.webmanager.handler.forms.handling
Class DigiDHandler

java.lang.Object
  nl.gx.webmanager.handler.forms.foundation.FormHandlerBase
      nl.gx.webmanager.handler.forms.handling.DigiDHandler

All Implemented Interfaces:

FormComponent, Handler

public class DigiDHandler
extends FormHandlerBase
implements Handler

This handler is used for working with DigiD's CGI interface for user authentication. First, the handler is used in mode 'authenticate', with the 'appurl' as extra parameter. During this call DigiD is contacted and the result (containing the parameters 'as_url', 'rid', and 'result_code') is stored in the session. Then, the handler is used in mode 'verify'. DigiD is contacted using the credentials from the session information in the URL. The result, containing the parameters 'laatst_ingelogd', 'result_code', and 'uid', is stored in the session.

Variable	Type	Mode	Default	Description
url	Parameter	Required	-	A unique URL of the DigiD web service which one can use to get identified. Extra parameters are automatically appended to the end of this URL.
mode	Parameter	Required	-	Specifies the mode/command to be executed. Either 'authenticate' or 'verify'.
sessionkey	Parameter	Required	-	Session key to use for saving and loading the results to/from the DigiD service.
appurl	Parameter	Optional	URL of your webservice	The URL that DigiD will send the user's browser to after the user had logged in on the DigiD website. Used by the 'authenticate' mode.
ridcode	Parameter	Optional	-	Small XSLT tag which, when applied to the session, should return the DigiD ridcode. Used by the 'verify' mode.

Example usage:

• Communication with DigiD.

Field Summary

Fields inherited from class nl.gx.webmanager.handler.forms.foundation.FormHandlerBase

DEFAULT_STATEMENT_TIMEOUT, log, staticlog

Constructor Summary

DigiDHandler()

Method Summary

void	doHandle(FormDefinition form, State formState, javax.servlet.http.HttpServletRequest req, javax.servlet.http.HttpServletResponse res) Processes the form.
void	init(FormComponentConfig config) Passes the initialization parameters to the component.

Methods inherited from class nl.gx.webmanager.handler.forms.foundation.FormHandlerBase

close, close, close, executeInsertWithIdentityMSSQLMYSQL, executeInsertWithIdentityOracle, executeIntegerQuery, executeIntegerQuery, executeIntegersQuery, executeIntegersQuery, executeQuery, executeStringQuery, executeUpdate, fillValues, getDataSource, setArguments, setArguments

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DigiDHandler

public DigiDHandler()

Method Detail

init

public void init(FormComponentConfig config)
          throws InitializationException

Description copied from interface: FormComponent

Passes the initialization parameters to the component.

Specified by:

init in interface FormComponent

Parameters:

config - The FormComponentConfig object that contains configutation information for this component.

Throws:

InitializationException - If initialization failed

doHandle

public void doHandle(FormDefinition form,
                     State formState,
                     javax.servlet.http.HttpServletRequest req,
                     javax.servlet.http.HttpServletResponse res)
              throws HandleException

Description copied from interface: Handler

Processes the form.

Specified by:

doHandle in interface Handler

Parameters:

form - The definition of the form for which the submitted values should be handled.

formState - The session values for the form

req - The http request

res - The http response

Throws:

HandleException - If the form values could not be handled correctly