4.5. Configure a Web Application to use an Authenticator Valve

Procedure 4.2. Configure an Application to use an Authenticator Valve

1. Configure the valve

   When using a local valve, it must be configured in the applications jboss-web.xml deployment descriptor. Refer to Section 4.4, “Configure a Web Application to use a Valve”.
   When using a global valve, this is unnecessary.

2. Add security configuration to web.xml

   Add the security configuration to the web.xml file for your application, using the standard elements such as security-constraint, login-config, and security-role. In the login-config element, set the value of auth-method to the name of the authenticator valve. The realm-name element also needs to be set to the name of the JBoss security realm being used by the application.

   <login-config>
      <auth-method>VALVE_NAME</auth-method>
      <realm-name>REALM_NAME</realm-name>
   </login-config>