2.5. Configuring Authentication


The default authentication configuration uses the jmx-console JAAS application profile. If deploying to an existing application server, it is possible that this profile has already been modified. In that case, refer to the application server documentation for instructions on adding new users. To change the default authentication, or add additional users, refer to the JBoss Enterprise BRMS Administrator Guide.
JBoss Enterprise Application Platform 5.x and JBoss Enterprise SOA Platform

When deploying to JBoss Enterprise Application Platform 5.x or JBoss Enterprise SOA Platform, add the login module policy to server/profile/login-config.xml. The org.jboss.security.auth.spi.UsersRolesLoginModule in the example below is provided as an example only.

<application-policy name="brms">
   <authentication>
      <login-module code="org.jboss.security.auth.spi.UsersRolesLoginModule" flag="required">
         <module-option name="usersProperties">props/brms-users.properties</module-option>
         <module-option name="rolesProperties">props/brms-roles.properties</module-option>
      </login-module>
   </authentication>
</application-policy>
Copy to Clipboard Toggle word wrap
JBoss Enterprise Application Platform 6

When deploying to JBoss Enterprise Application Platform 6, edit the jaas-config-name property in jboss-eap-6.0/standalone/deployments/jboss-brms.war/WEB-INF/components.xml to brms:

<security:identity authenticate-method="#{authenticator.authenticate}" jaas-config-name="brms"/>
Copy to Clipboard Toggle word wrap
JBoss Enterprise Web Server

When deploying to JBoss Enterprise Web Server, create a jaas.config file, and add the login module policy. The org.jboss.security.auth.spi.UsersRolesLoginModule in the example below is provided as an example only.

brms {
org.jboss.security.auth.spi.UsersRolesLoginModule required debug=true;
};
Copy to Clipboard Toggle word wrap
Save the file to the following location:
  • JBoss Enterprise Web Server 1:
    tomcat6/conf/
  • JBoss Enterprise Web Server 2:
    tomcat7/conf

Note

When using the above example for evaluation purposes, it is necessary to copy the jbosssx.jar from the JBoss Enterprise standalone download. Copy the jbosssx.jar file from the standalone download jboss-as/lib/ to the tomcat6/lib/ directory.
Open the tomcat/6/bin/catalina.sh file and search for the following line:
# ----- Execute The Requested Command ------
Copy to Clipboard Toggle word wrap
Add the following line directly after the above line:
JAVA_OPTS="$JAVA_OPTS -Xms1303m -Xmx1303m -XX:MaxPermSize=512m -Djava.security.auth.login.config=$CATALINA_BASE/conf/jaas.config"
Copy to Clipboard Toggle word wrap
Back to top
Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2025 Red Hat