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:
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.
To view or modify 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.
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
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.
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
For information about each option, open the Password Options dialog box, and then press F1.
To restore a deprovisioned 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.
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.