Editing the Security Properties of an EAR 

Prerequisites

There must be at least one security role defined either during the Generating J2EE Components or during the Assembling a J2EE Application phase.

Procedure

...

       1.      In your DLP project choose the Deployer tab.

       2.      Choose the EAR file.

       3.      Manage the security roles and the user mapping.

Managing the Security Roles

...

       1.      Click the Security Roles tab.

       2.      You can select an already existing role from the Security Roles list and then edit its properties.

       3.      You can create a new Security Role. To do this:

                                                  i.       Enter a name for the role in the Role Name field.

                                                ii.       Enter description in the Security Role Description field (this description is optional).

                                               iii.       Click the Add button to add the new role to the Security Roles list.

       4.      If you want to modify a role:

                                                  i.       Select the role from the Security Roles list.

                                                ii.       Change its description in the Security Role Description field.

                                               iii.       Click the Modify button.

You can change only the description of a role.

If you change the name of a role, it will be treated as a new one and you will have to add it to the list if you want to keep your changes.

       5.      If you want to remove a role, select it and click the Remove button.

       6.      The Clearbutton clears the values in the fields, so that you can enter new ones for a new role.

Managing the User Mappings

...

       1.      Click the User Mapping tab.

       2.      Select a role from the Security Roles list.

       3.      Next:

                            a.      If you want to manage the default users on the server check the Server Security Role radio button. In this case, the roles are listed in the Server Roles list and you can choose from it a role to map to the security roles.

                            b.      If you want to map a role from the application to a role on the J2EE Engine, check the User Security Management radio button. A new pane opens, in which you can search for users and groups and select them from the available ones on the J2EE Engine.

The user must be connected to a running J2EE Engine in order to use this option.

       4.      Choose a user or a group from the available ones on the J2EE Engine.

       5.      Use the button with the arrows pointing to the left to add the selected role to the Selected Roles list.

       6.      Use the button with the arrows pointing to the right to remove the selected role from the Selected Roles list.

Searching Users and Groups on the J2EE Engine

This pane has two tabs – Searchand Tree.

The Tree pane lists all available groups and users on the J2EE Engine.

The Search pane provides functionality to perform searches of groups and users on the J2EE Engine. It has the following components:

·        Users tab– provides options to search for users:

¡        Name – the name of the user.

¡        Display – the maximum number of results that will be displayed.

¡        Locked Users – select this checkbox if you want to search only for locked users.

·        Groups tab– provides options for searching for groups:

¡        Name – the name of the group.

¡        Child Group – the name of a child group.

¡        Child User – the name of a child user

¡        Display – the maximum number of results that will be displayed.

·        Search button- click this option when you want to start the search with the selected criteria in one of the previous tabs. The results, that match any one of the criteria set in the panes will be listed in the field below the Search and Reset buttons.

·        Reset button- click this option when you want to clear the fields in the Users and Search tabs.