WAS v8.5 > Secure applications > Secure Service integration > Secure service integration > Administer authorization permissions > Administer destination rolesAdd users and groups to destination roles
Service integration bus security uses role-based authorization. By adding users and groups to the destination roles for a secured bus, we can control which users and group members can undertake messaging operations at a bus destination.
Ensure the following conditions are met:
- Security is enabled for the bus. For more information, see Secure buses.
- The users and groups to add to destination roles must exist already in the user repository.
By adding users or groups to the destination role, you grant the users or groups authority to undertake the operation defined by the role at a selected destination. The destination roles are sender, receiver, browser, and creator, depending on the destination type.
In this task we use the dmgr console Security wizard to retrieve selected users or groups from the user repository, and add them to destination roles for selected bus destinations.
To add a large number of users to destination roles, it is advisable to create a group in the user repository, and add the group to the destination roles.
- Start the dmgr console.
- Click Service integration -> Buses -> security_value -> [Authorization Policy] Manage destination access roles. A list of the destinations defined for the selected bus is displayed in the Destinations panel.
- Select one or more destination to work with:
- Click a single destination name.
- Select the check boxes next to multiple destination names, and then click Manage Access Roles.
The Destination access roles panel is displayed. The information for each destination we have selected is displayed in a collapsed section.
- Expand a destination header to list the users and groups that have been assigned to roles for this destination. We can verify the user or group to add does not already have a role at this destination.
- Click Add to start the Security wizard. The wizard takes you through the following steps to add selected users or groups to access roles for the expanded destination:
- Search for the users or groups to add to access roles for the expanded destination:
- Users or Groups
- Select either Users or Groups to specify whether to grant access roles to users or groups.
- Search pattern
- This field is mandatory. Specify a search string that is matched against user IDs or group names in the user repository. Only user IDs or group names that match the search pattern are retrieved, subject to the maximum number of search results. Wildcard characters are allowed.
- Maximum number of search results to display
- This field is mandatory. Specify the maximum number of user IDs or group names you want the dmgr console to display.
- Click Next. The wizard displays the users or groups in the user repository that match the information that you provided in the previous step.
- Select the check boxes next to the user IDs or group names to add to access roles for the currently expanded destination, and click Next. A list of user IDs or group names that we can add to destination roles is displayed. Note that some users or groups might already be assigned to access roles for this destination.
- Select the appropriate access role icon for the user ID or group name to add to the role at this destination. For example, select the Receiver icon for a user ID or group name to add to the receiver role. The icon changes from to to show that we have added the user or group to the access role for the resource.
- Repeat the previous step to add more users or groups to access roles for the currently expanded destination, and then click Next. A summary of your access role assignments is displayed.
- Optional: Click Previous to review and change your assignments, if required.
- Click Finish to confirm your assignments.
- Repeat steps 4 and 5 for each destination to work with.
- Save your changes to the master configuration.
Results
The selected users and groups are added to the access roles for the currently expanded destination. The new access role assignments are displayed in the Destination access roles panel.
Example
A group called MyGroup receives messages from three queues, Queue 1, Queue 2, and Queue 3. If you want the group MyGroup to produce and consume messages at an additional destination, Queue 4, you add MyGroup to Queue 4, and then add MyGroup to the sender and receiver roles for Queue 4.
Use the dmgr console to complete other security administrative tasks.
Related concepts:
Messaging security
Destination security
Role-based authorization
Bus destinations
Reference:
Access role assignments for bus security resources
addGroupToDestinationRole command
addUserToDestinationRole command
Related information:
Remove users and groups from destination roles
List users and groups in destination roles
Restoring default inheritance for a destination
Disable inheritance from the default resource
Overriding inheritance from the default resource for a destination
Destinations access roles [Settings]