Hitachi

uCosminexus Application Server Security Management Guide


16.2.9 The <ua:login/> tag

Organization of this subsection

(1) Description

Uses the specified JAAS configuration entry to log a user in. When this is done, the com.cosminexus.admin.auth.name and com.cosminexus.admin.auth.password parameters should be specified for the HTTP request object. If the <ua:logout/> tag for the <ua:login/> tag is not defined, the user is implicitly logged out when the session is disconnected.

(2) Tag attributes

The following table lists the tag attributes.

Table 16‒10: Tag attributes (<ua:login/> tag)

Tag attribute

Description

Type

Required?

C/E

id="id"

Specifies the identifier of an instance of the JAAS LoginContext class. This tag attribute can also be used for the name of the script variable that references this instance. This instance has a session scope, which means that it can be referenced from different JSP pages participating in the same session. The specified identifier should be unique for each scope.

javax.security.auth.login.LoginContext

R

C

entry="JAAS-entry"

Specifies the entry name of the JAAS configuration file.

n/a

R

E

attrFile="attrFile"

Specifies the name of a file that defines the attributes to be obtained from the user management repository. The file should be a CSV file that contains single sign-on authentication information. For details about this CSV file, see 14.3 CSV files containing single sign-on authentication information.

n/a

O#

E

attrEntName="attrEntName"

Specifies the identifier specified with the id tag attribute of the <ua:attributeEntries> tag.

n/a

E

excepId="excepId"

Specifies the identifier of an instance of an exception that occurs during the login processing. This instance has the scope that is specified with the excepScope tag attribute. The specified identifier should be unique for each scope. If the excepId tag attribute is omitted, exceptions that occur during login processing are propagated outside the <ua:login/> tag as JspException.

n/a

O

C

excepScope="scope"

Specifies the scope of the script variable that is specified with the excepId tag attribute. The scope can be specified as page, request, session, or application. For the meanings of these values, see the description for the <jsp:useBean/> tag. If the excepScope tag attribute is omitted, page is assumed.

n/a

O

C

Legend:

R: Required

O: Optional

n/a: Not applicable

C: Indicates that the tag attribute value is evaluated at JSP compile time.

E: Indicates that the tag attribute value is evaluated at execution time.

#

Specify either of these tag attributes.