|Home > Documentation > User's guide > Administration > Administrative Tasks > Configuring security > Configuring HTTP header-based authentication|
This chapter introduces the process of achieving Single Sign-on by using CA severs,such as Siteminder, to validate authentication information passed by the the HTTP headers. Single Sign-on is a method that provides access control for the server. It enables the user to be authenticated only once and gain access to the resource of multiple software systems. In other words, a user agent that wishes to authenticate itself with a server might need to do so only once for the same security realm using Single Sign-on.
During such authentication, a CA server cross-checks the information appended to the HTTP headers. If the information is consistent with that defined by the security realm, the identity of the client being authenticated is verified.
Applications which use the HTTP header-based authentication must configure their deployment descriptor as follows:
TestPropsRealmis the name of the security realm used for authentication.
A well known CA server is Siteminder, which helps to provide information to the application by setting specific headers on the HTTP request. By default, it uses the SM_USER header to pass the username, which is later authenticated by the
GenericHttpHeaderLoginmodule class in the Geronimo server.
You can configure the security realm for HTTP header-based authentication. The following TestPropsRealm.xml file is a deployment plan used to create a Properties file security realm on the Geronimo server. Applications which use this security realm can achieve Single Sign-on.
GenericHttpHeaderPropertiesFileLoginModule: is the class that enables the Generic Http Header to be used for authentication with Properties file security realms. When working with the LDAP Realm or Database (SQL) Realm, the
GenericHttpHeaderSqlLoginmoduleare used respectively.
<log:option name="groupsURI">var/security/demo_groups.properties</log:option>: indicates that the demo_groups.properties file is the properties file for the security realm.
SM_USERis the name of the header that passes the username to the server for authentication.
<log:option name="authenticationAuthority">Siteminder</log:option>: Siteminder is the Single Sign-on system.