The handle method

Description

Obtains authentication information, assigns to it a reference to the WebPasswordCallback object (Callback implementation class), and passes it to the login module in the user authentication library.

To Page Top

Syntax

public void handle(Callback[] callbacks)
  throws IOException, UnsupportedCallbackException;

To Page Top

Parameter

callbacks:

If this parameter specifies a reference to the WebPasswordCallback object, authentication information is set and returned. If it specifies a reference to the WebSSOCallback object, session information is set and returned. If it specifies a reference to another object, UnsupportedCallbackException occurs.

To Page Top

Exceptions

java.io.IOException:

HttpServletRequest does not contain the user ID or password. See Remarks for details about the parameters necessary for obtaining information.

javax.security.auth.callback.UnsupportedCallbackException:

An unsupported callbacks reference is specified.

To Page Top

Return value

Set a value for callbacks so that this value can be returned. This method does not return a value.

To Page Top

Remarks

Authentication information is read in the order shown below.

Figure 15‒1: Order of reading authentication information

You can obtain authentication information from HttpServletRequest by using the following parameters:

• com.cosminexus.admin.auth.name

  Specifies the user ID defined by the user.

• com.cosminexus.admin.auth.password

  Specifies the password defined by the user.

To Page Top