13.2.2. Configure Authentication in a Security Domain

Procedure 13.8. Setup Authentication Settings for a Security Domain

1. Open the security domain's detailed view.

   1. Click the Configuration label at the top of the management console.
   2. Select the profile to modify from the Profile selection box at the top left of the Profile view.
   3. Expand the Security menu, and select Security Domains.
   4. Click the View link for the security domain you want to edit.

2. Navigate to the Authentication subsystem configuration.

   Select the Authentication label at the top of the view if it is not already selected.
   The configuration area is divided into two areas: Login Modules and Details. The login module is the basic unit of configuration. A security domain can include several login modules, each of which can include several attributes and options.

3. Add an authentication module.

   Click Add to add a JAAS authentication module. Fill in the details for your module.
   The Code is the class name of the module. The Flag setting controls how the module relates to other authentication modules within the same security domain.
   Explanation of the Flags

   The Java Enterprise Edition 6 specification provides the following explanation of the flags for security modules. The following list is taken from http://docs.oracle.com/javase/6/docs/technotes/guides/security/jaas/JAASRefGuide.html#AppendixA. Refer to that document for more detailed information.

   Expand

   Flag	Details
   required	The LoginModule is required to succeed. If it succeeds or fails, authentication still continues to proceed down the LoginModule list.
   requisite	LoginModule is required to succeed. If it succeeds, authentication continues down the LoginModule list. If it fails, control immediately returns to the application (authentication does not proceed down the LoginModule list).
   sufficient	The LoginModule is not required to succeed. If it does succeed, control immediately returns to the application (authentication does not proceed down the LoginModule list). If it fails, authentication continues down the LoginModule list.
   optional	The LoginModule is not required to succeed. If it succeeds or fails, authentication still continues to proceed down the LoginModule list.

   Show more

4. Edit authentication settings

   After you have added your module, you can modify its Code or Flags by clicking Edit in the Details section of the screen. Be sure the Attributes tab is selected.

5. Optional: Add or remove module options.

   If you need to add options to your module, click its entry in the Login Modules list, and select the Module Options tab in the Details section of the page. Click the Add button, and provide the key and value for the option. Use the Remove button to remove an option.