Chat now with support
Chat with Support

Active Roles 8.1.4 - Administration Guide

Introduction Getting started with Active Roles Configuring rule-based administrative views Configuring role-based administration Rule-based autoprovisioning and deprovisioning
Provisioning Policy Objects Deprovisioning Policy Objects How Policy Objects work Policy Object management tasks Policy configuration tasks
Property Generation and Validation User Logon Name Generation Group Membership AutoProvisioning Exchange Mailbox AutoProvisioning AutoProvisioning in SaaS products OneDrive Provisioning Home Folder AutoProvisioning Script Execution Microsoft 365 and Azure Tenant Selection E-mail Alias Generation 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
Using rule-based and role-based tools for granular administration Workflows
Key workflow features and definitions About workflow processes Workflow processing overview Workflow activities overview Configuring a workflow
Creating a workflow definition for a workflow 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
Approval workflow Email-based approval Automation workflow Activity extensions
Temporal Group Memberships Group Family Dynamic groups Active Roles Reporting Management History Entitlement profile Recycle Bin AD LDS data management One Identity Starling Join and configuration through Active Roles Managing One Identity Starling Connect Configuring linked mailboxes with Exchange Resource Forest Management Configuring remote mailboxes for on-premises users Migrating Active Roles configuration with the Configuration Transfer Wizard Managing Skype for Business Server with Active Roles
About Skype for Business Server User Management Active Directory topologies supported by Skype for Business Server User Management User Management policy for Skype for Business Server User Management Master Account Management policy for Skype for Business Server User Management Access Templates for Skype for Business Server Configuring the Skype for Business Server User Management feature Managing Skype for Business Server users
Exchanging provisioning information with Active Roles SPML Provider Monitoring Active Roles with Management Pack for SCOM Configuring Active Roles for AWS Managed Microsoft AD Azure AD, Microsoft 365, and Exchange Online Management
Configuring Active Roles to manage Hybrid AD objects Unified provisioning policy for Azure M365 Tenant Selection, Microsoft 365 License Selection, Microsoft 365 Roles Selection, and OneDrive provisioning Changes to Active Roles policies for cloud-only Azure objects
Managing the configuration of Active Roles
Connecting to the Administration Service 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 Using regular expressions Administrative Template Configuring federated authentication Communication ports Active Roles and supported Azure environments Integrating Active Roles with other products and services Active Roles Language Pack Active Roles Diagnostic Tools Active Roles Add-on Manager

Configuring a Report Distribution policy

You can configure a new Report Distribution policy via the Policy to Configure page of the Active Roles Console.

To configure a Report Distribution policy

  1. On the Policy to Configure page, select Report Distribution Policy, then click Next.

  2. On the Report Recipients and Message page, do the following, then click Next:

    • Click the button next to Report recipients, then select one or more email recipients.

    • In Message Subject, type the subject of the message that the specified recipients will receive upon completion of a deprovisioning operation.

      Macros have the same syntax and semantics as values for policy conditions in Property Generation and Validation policies: An attribute’s LDAP display name enclosed in angle brackets (<>) and prefixed with the percent character (%) represents the value of that attribute. For instance, before sending a message, Active Roles replaces %<name> with the original name of the object that has been deprovisioned.

      NOTE: Active Roles retrieves the attribute value prior to starting the deprovisioning operation so the value is current as of the time the deprovisioning process begins. Even if you have a deprovisioning policy configured to update a given attribute, the message reads the original rather than updated value of that attribute.

    • Select the Send out the report only if any errors occur check box if you want the policy not to send the report if no errors occurred during the deprovisioning operation. Clear the check box if you want the policy to send the report regardless of whether or not any errors occurred.

  3. On the Outgoing Mail Server page, select the email configuration you want the policy to use. In the Outgoing mail server (SMTP) list, click the appropriate mail settings.

    This page is similar to the respective wizard page for Notification Distribution policies. For more information, see Configuring a Notification Distribution policy). You can select the email configuration you want the policy to use, and view or modify email settings in the selected configuration.

    First, from the Outgoing mail server (SMTP) list, select the email configuration you want the policy to use.

    NOTE: By default, the Outgoing mail server (SMTP) list includes a single entry. You can add more entries to the list using the Active Roles Console. In the Console tree, expand Configuration/Server Configuration, right-click Mail Configuration, select New > Mail Configuration, then follow the instructions in the wizard.

  4. If you want to view or modify the selected mail settings, click Settings, and use the Mail Setup tab. For more information, see Configuring email settings.

  5. Click Next.

  6. On the Enforce Policy page, you can specify objects to which this Policy Object is to be applied. To do so, click Add, then use the Select Objects dialog to locate and select the objects you want.

  7. Click Next, and then click Finish.

Scenario: Sending deprovisioning report

This scenario describes how to configure the following policy to monitor deprovisioning operations in all domains registered with Active Roles (managed domains):

  • When a deprovisioning operation is completed, verify if any errors occurred during the operation.

  • If any errors occurred, send the report on the deprovisioning results to the administrator.

To implement this scenario, you must perform the following actions:

  1. Create the appropriate email configuration.

  2. Create, configure, and apply the Policy Object that defines the appropriate policy.

As a result, upon completion of a deprovisioning operation in any managed domain, the administrator receives a report in the event of any error during that operation. The message subject includes the name of the object that has been deprovisioned.

The following two sections elaborate on the steps to implement this scenario.

Creating the email configuration

You can use the instructions in see Scenario: Sending deprovisioning notification to create the email configuration. When prompted to specify a name for the new configuration, type Deprovisioning Report Distribution.

Creating, configuring, and applying the Policy Object

You can create, configure, and apply the Policy Object you need by using the New Deprovisioning Policy Object Wizard. For information about the wizard, see Creating a Policy Object.

To configure the policy, click Report Distribution on the Select Policy Type page of the wizard. Then, click Next.

On the Report Recipients and Message page, click the button next to the Report recipients box to display the Deprovisioning Report Recipients dialog. In that dialog, type the administrator’s email address, such as, and then click OK.

Then, customize the message subject as necessary. For example, you might enter the following subject: Deprovisioning of %<objectClass> ’%<name>’ Completed with Errors. Verify that the Send out the report only if any errors occur check box is selected and then click Next to display the Outgoing Mail Server page.

From the list in the Outgoing mail server (SMTP) box, select Deprovisioning Report Distribution—the email configuration you have created in Step 1, and then click Next to display the Enforce Policy page.

On the Enforce Policy page, click Add and select the Active Directory folder to add to the list. Click Next, and then click Finish to close the wizard.

You can also use the Enforce Policy command on the Active Directory folder in the Console tree to apply the policy to that folder. For more information on how to apply a Policy Object, see Applying Policy Objects and Managing policy scope.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating