Security Roles Property Editor

Tip Note that this feature might not be included in your version of the IDE. If it is not available, you can edit the deployment descriptor (web.xml) file using the editor of your choice. For more information, see Java Servlet 2.3 Specification available at http://java.sun.com/products/servlet .

You can use the Security Roles property editor to add, edit, and remove security roles from the web module. A role is an abstract logical grouping of users that is defined by you, the application developer, or by the assembler. You can use security roles to indicate which groups of users can gain access to different resources within the web module. Resources are defined by the web resource collection.
Security roles can be used for programmatic security, in which case they are mapped to security role references. Security roles are also used for declarative security, in which case they are mapped to web resource collections.
Each entry in the Security Roles property editor corresponds to a <security-role> element in the deployment descriptor.

To display the Security Roles property editor:

  1. Click the Security tab of the web.xml property sheet.
  2. Click the Security Roles value field to make the ellipsis button appear.
  3. Click the ellipsis button to display the property editor.

To add security roles:

  1. From the Security Roles property editor, click the Add button. The Add Security Role dialog box appears.
  2. Type the name of the security role in the Role Name text field. A security role is simply a token that classifies users. For instance, you might type member or guest.
  3. Type an optional description of the security role in the Role Description text field. For instance, you could type Employee of company XYZ, Inc., manager with hiring/firing/budgeting authority, application administrator, representative from the human resources department. This description is optional and is useful to guide the deployer or the deployment tool in setting the security role values.

To edit security roles:

  1. From the Security Roles property editor, select the desired securty role information, and click the Edit button. The Edit Security Role dialog box appears.
  2. Edit the name of the security role in the Role Name text field.
  3. Edit the description of the security role in the Role Description text field.

To remove security roles:

  1. From the Security Roles property editor, select the row containing the desired security role information, and click the Remove button. The security role is removed from the table.
  2. Click OK to confirm the action, or click Cancel to stop the action.
See also
Editing Web Module Securities Properties

Legal Notices