Policy options to undo user deprovisioning
The behavior of the Undo Deprovisioning operation is determined by a configurable policy contained in a built-in Policy Object. This is the Policy Object named Built-in Policy - Default Rules to Undo User Deprovisioning and located in the Builtin container under Configuration/Policies/Administration. The Policy Object is applied to the Active Directory folder, thus taking effect in all domains that are registered with Active Roles (managed domains).
The option provided by this policy can be used to prevent restoration of group memberships and resetting of the user password:
- Restore group memberships. When selected, causes the Undo Deprovisioning operation on a deprovisioned user account to add the account to the distribution and security groups from which the account was removed in accord with the Group Membership Removal policy. If you do not want restored accounts to be automatically added to groups, clear this option.
Note that regardless of whether this option is selected, once a deprovisioned user account is restored, Active Roles automatically adds the account to the appropriate Dynamic Groups and Group Families depending on properties of the account.
- Leave password unchanged. Causes the Undo Deprovisioning operation on a deprovisioned user account to prevent resetting of the password for the restored account. Select this option if you want the password to be reset by the HelpDesk or by using a self-service password management solution after the account is restored.
- Prompt to reset password. Causes the Undo Deprovisioning operation on a deprovisioned user account to enable resetting of the password for the restored account. If this option is selected, the Undo Deprovisioning command displays a dialog box in which the password can be reset.
To view or modify the policy options
- Open the Active Roles console.
- In the console tree, expand Configuration | Policies | Administration, and select Builtin under Administration.
- In the details pane, double-click Built-in Policy - Default Rules to Undo User Deprovisioning.
- On the Policies tab in the Properties dialog box, click the policy in the list, and then click View/Edit to access the policy options.
Since the built-in Policy Object is normally applied to the Active Directory node in the Active Roles namespace, the policy options are in effect on any deprovisioned user account. If you need different policy options for different domains or containers, create a copy of the built-in Policy Object, and then configure and apply the copy as appropriate.
The Undo Deprovisioning operation is normally enabled in all domains that are registered with Active Roles. It is possible to prohibit this operation in individual domains or containers, or in all domains, by blocking or disabling the policy that governs the operation. In case of disabling the built-in Policy Object, an enabled copy of that Policy Object can be applied in order to allow the Undo Deprovisioning operation in individual domains or containers.
Delegating the task to undo deprovisioning
Restoring deprovisioned users or groups is, by default, a right of Active Roles Admin, the administrative account specified during Active Roles installation, but this task can be delegated to any group or user. A dedicated Access Template is provided for this purpose so you can delegate the use of the Undo Deprovisioning command without delegating the create or delete operation.
To delegate the task of restoring deprovisioned users or groups held in a certain container, such as an organizational unit or a Managed Unit, you should apply the Access Template as follows.
To delegate the Undo Deprovisioning task
- In the Active Roles console, right-click the container and click Delegate Control to display the Active Roles Security window.
- In the Active Roles Security window, click Add to start the Delegation of Control wizard. Click Next.
- On the Users or Groups page, click Add, and then select the users or groups to which you want to delegate the task. Click Next.
- On the Access Templates page, expand the Active Directory folder and then do the following:
-
To delegate the task of restoring deprovisioned users, select the check box next to Users - Perform Undo Deprovision Tasks.
-
To delegate the task of restoring deprovisioned groups, select the check box next to Groups - Perform Undo Deprovision Tasks.
- Click Next and follow the instructions in the wizard, accepting the default settings.
After you complete these steps, the users and groups you selected in Step 3 are authorized to restore deprovisioned users in the container you selected in Step 1, as well as in any sub-container of that container.
Using the Undo Deprovisioning command
The Undo Deprovisioning command is available in both the Active Roles console and Web Interface to those who are authorized to restore deprovisioned users or groups. By using this command, you start the Undo Deprovisioning operation on the objects you have selected, causing Active Roles to undo the results of deprovisioning on those objects.
To restore a deprovisioned user account
- In the Active Roles console, right-click the user account, and then click Undo Deprovisioning.
- In the Password Options dialog box, choose the options to apply to the password of the restored account, and then click OK.
For information about each option, open the Password Options dialog box, and then press F1.
- Wait while Active Roles restores the user account.
To restore a deprovisioned group
- In the Active Roles console, right-click the group, and then click Undo Deprovisioning.
- Wait while Active Roles restores the group.
The operation progress and results are displayed in the Results of Undo Deprovisioning window, which is similar to the Deprovisioning Results window discussed earlier in this chapter. When the operation is completed, the window displays the operation summary, and allows you to examine operation results in detail.
Report on results of undo deprovisioning
For each of the restored objects, the Results of Undo Deprovisioning window can be used to examine the restore operation results on that object. The Active Roles console or Web Interface opens the Results of Undo Deprovisioning window when carrying out the Undo Deprovisioning command.
The Results of Undo Deprovisioning window displays a report of the Undo Deprovisioning operation, which is similar to a deprovisioning-related report discussed earlier in this chapter. The report organizes operation results into sections, with each section containing report items specific to a certain category of deprovisioning policy. The report items within a particular section inform of the actions performed to roll back the changes that were made by the deprovisioning policy of the respective category.
When you click the heading at the top of the report, the report is fully expanded and all report items are shown. Alternatively, you can expand and contract individual sections within the report by clicking the heading for each section.
For certain items, the report provides the option to further expand the view and display additional information. By clicking the List option, you can display a list of items, such as user or groups properties, involved in the operation. By clicking the Details option, you can examine the operation result in more detail.
The Results of Undo Deprovisioning window also provides the ability to document all the operation results to a file for printing or viewing. Using the shortcut menu, you can export the report to a file as either HTML or XML, print the report, or send it out via e-mail.