Delegating the Deprovision task
Deprovisioning is, by default, a right of Active Roles Admin, the administrative account specified during Active Roles installation, but the task of deprovisioning can be delegated to any group or user. A dedicated Access Template is provided for this purpose so that you can delegate the use of the Deprovision command without delegating the create or delete operation.
To delegate the task of deprovisioning users or groups in a certain container, such as an organizational unit or a Managed Unit, you should apply the Access Template as follows.
To delegate the Deprovision 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 deprovision task. Click Next.
- On the Access Templates page, expand the Active Directory folder and then do the following:
- To delegate the task of deprovisioning users, select the check box next to Users - Perform Deprovision Tasks.
- To delegate the task of deprovisioning groups, select the check box next to Groups - Perform 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 deprovision users or groups in the container you selected in Step 1, as well as in any sub-container of that container.
Using the Deprovision command
The Deprovision command is available in both the Active Roles console and Web Interface. By using the Deprovision command, you start the deprovisioning operation on the objects you have selected.
The operation progress and results are displayed in the Deprovisioning Results window. When the operation is completed, the window displays the operation summary, and allows you to examine operation results in detail.
The left pane of the Deprovisioning Results window lists the objects that have been deprovisioned. The right pane displays the operation status and error messages, if any.
To view operation results, select an object in the left pane. The right pane shows a report on all actions taken during the deprovisioning of the selected object. A typical report is discussed in the next section.
Report on deprovisioning results
For each deprovisioned object, the Deprovisioning Results window can be used to examine the deprovision operation results on that object.
The Active Roles console or Web Interface opens the Deprovisioning Results window when carrying out the Deprovision command. You can also open this window by using the Deprovisioning Results command, which is available on deprovisioned objects.
The Deprovisioning Results window displays a report of the deprovisioning operation. The report organizes operation results into sections named after policy categories, with each section containing report items specific to a certain policy 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 group properties, involved in the operation. By clicking the Details option, you can examine the operation result in more detail.
The Deprovisioning Results window also meets some common reporting requirements including 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.
Report contents
The following tables list the possible report items, one table per report section. The items in each section describe results of the actions that were taken in accord with the respective deprovisioning policy. Report items also inform about success or failure of each action. In the event of a failure, the report item includes an error description.
Not all the listed items must necessarily be present in a report. An actual report only includes the report items corresponding to the configured policy options. For example, if the policy is not configured to disable user accounts, the report does not include the item regarding this action.