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>
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"/>
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;
};
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 ------
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"
Report a bug