Chat now with support
Chat with Support

Active Roles 7.5.3 - Administration Guide

Introduction About Active Roles Getting Started Rule-based Administrative Views Role-based Administration
Access Templates as administrative roles Access Template management tasks Examples of use Deployment considerations Windows claims-based Access Rules
Rule-based AutoProvisioning and Deprovisioning
About Policy Objects Policy Object management tasks Policy configuration tasks
Property Generation and Validation User Logon Name Generation Group Membership AutoProvisioning E-mail Alias Generation Exchange Mailbox AutoProvisioning AutoProvisioning for SaaS products OneDrive Provisioning Home Folder AutoProvisioning Script Execution Office 365 and Azure Tenant Selection User Account Deprovisioning Office 365 Licenses Retention Group Membership Removal Exchange Mailbox Deprovisioning Home Folder Deprovisioning User Account Relocation User Account Permanent Deletion Group Object Deprovisioning Group Object Relocation Group Object Permanent Deletion Notification Distribution Report Distribution
Deployment considerations Checking for policy compliance Deprovisioning users or groups Restoring deprovisioned users or groups Container Deletion Prevention policy Picture management rules Policy extensions
Understanding workflow Workflow activities overview Configuring a workflow
Creating a workflow definition Configuring workflow start conditions Configuring workflow parameters Adding activities to a workflow Configuring an Approval activity Configuring a Notification activity Configuring a Script activity Configuring an If-Else activity Configuring a Stop/Break activity Configuring an Add Report Section activity Configuring a Search activity Configuring CRUD activities Configuring a Save Object Properties activity Configuring a Modify Requested Changes activity Enabling or disabling an activity Enabling or disabling a workflow Using the initialization script
Example: Approval workflow E-mail based approval Automation workflow Activity extensions
Temporal Group Memberships Group Family Dynamic Groups Active Roles Reporting Management History
Understanding Management History Management History configuration Viewing change history
Workflow activity report sections Policy report items Active Roles internal policy report items
Examining user activity
Entitlement Profile Recycle Bin AD LDS Data Management One Identity Starling Management One Identity Starling Two-factor Authentication for Active Roles Managing One Identity Starling Connect Azure AD, Office 365, and Exchange Online management
Configuring Active Roles to manage hybrid AD objects Managing Hybrid AD Users Unified provisioning policy for Azure O365 Tenant Selection, Office 365 License Selection, and Office 365 Roles Selection, and OneDrive provisioning Office 365 roles management for hybrid environment users Managing Office 365 Contacts Managing Hybrid AD Groups Managing Office 365 Groups Managing Azure Security Groups Managing cloud-only Azure users Managing cloud-only Azure guest users Managing cloud-only Azure contacts Changes to Active Roles policies for cloud-only Azure objects Managing room mailboxes
Managing Configuration of Active Roles
Connecting to the Administration Service Adding and removing managed domains Using unmanaged domains Evaluating product usage Creating and using virtual attributes Examining client sessions Monitoring performance Customizing the console Using Configuration Center Changing the Active Roles Admin account Enabling or disabling diagnostic logs Active Roles Log Viewer
SQL Server Replication Appendix A: Using regular expressions Appendix B: Administrative Template Appendix C: Communication ports Appendix D: Active Roles and supported Azure environments Appendix E: Enabling Federated Authentication Appendix F: Active Roles integration with other One Identity and Quest products Appendix G: Active Roles integration with Duo Appendix H: Active Roles integration with Okta

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

  1. Open the Active Roles console.
  2. In the console tree, expand Configuration | Policies | Administration, and select Builtin under Administration.
  3. In the details pane, double-click Built-in Policy - Default Rules to Undo User Deprovisioning.
  4. 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

  1. In the Active Roles console, right-click the container and click Delegate Control to display the Active Roles Security window.
  2. In the Active Roles Security window, click Add to start the Delegation of Control wizard. Click Next.
  3. 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.
  4. On the Access Templates page, expand the Active Directory folder and then do the following:
    1. To delegate the task of restoring deprovisioned users, select the check box next to Users - Perform Undo Deprovision Tasks.

    2. To delegate the task of restoring deprovisioned groups, select the check box next to Groups - Perform Undo Deprovision Tasks.

  5. 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

  1. In the Active Roles console, right-click the user account, and then click Undo Deprovisioning.
  2. 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.

  1. Wait while Active Roles restores the user account.

To restore a deprovisioned group

  1. In the Active Roles console, right-click the group, and then click Undo Deprovisioning.
  2. 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.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating