Chat now with support
Chat with Support

Active Roles 7.6.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
Workflows
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 Managing One Identity Starling Connect Configuring linked mailboxes with Exchange Resource Forest Management Configuring remote mailboxes for on-premises users 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 distribution 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 cloud-only shared 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 Using regular expressions Administrative Template Communication ports Active Roles and supported Azure environments Active Roles integration with other One Identity and Quest products Active Roles integration with Duo Active Roles integration with Okta Active Roles Diagnostic Tools Active Roles Add-on Manager

Entry type: Initiator ID

Entry type: Initiator ID

When you select Initiator ID under Entry type in the Add Entry window, the Entry properties area looks like the following figure.

Figure 83: Entry type: Initiator ID

With this entry type, you can add a string that identifies the Initiator, that is, the user who originated the deprovisioning request. The policy generates the Initiator ID based on certain properties of the Initiator’s account, such as the user logon name. A custom rule can be configured to use other properties.

You can choose a pre-configured rule or configure a custom rule to generate the Initiator ID. The pre-configured rules allow you to set the Initiator ID to one of the following:

  • The pre-Windows 2000 user logon name of the Initiator, in the form DomainName\UserName
  • The user logon name of the Initiator

A custom rule allows you to compose the Initiator ID of other Initiator-related properties.

Configuring a custom rule to build the Initiator ID

Configuring a custom rule to build the Initiator ID

To configure a custom rule for Initiator ID, click the lowermost option under Entry properties, and then click the Configure button. This displays the Configure Value dialog box, discussed earlier in this chapter (see How to configure a Property Generation and Validation policy). You can use that dialog box to set up a value for the ‘Initiator ID’ must be condition, in the same way as you do when configuring a Property Generation and Validation policy.

To start configuring a value, click Add in the Configure Value dialog box. This displays the Add Entry window.

A value is a concatenation of one or more entries. In the Add Entry window, you can select the type of the entry to add, and then configure the entry. The following table summarizes the available types of entries.

Table 22: Available entries for Configuring a custom rule to build the Initiator ID

Type of entry

Description

Text

Adds a text string to the value.

Initiator Property

Adds a selected property (or a part of a property) of the Initiator’s user account.

Parent OU Property

Adds a selected property (or a part of a property) of an organizational unit in the hierarchy of containers above the Initiator’s user account.

Parent Domain Property

Adds a selected property (or a part of a property) of the domain of the Initiator’s user account.

Instructions on how to configure an entry depend on the type of the entry. For each type of entry, you can find the instructions in the How to configure a Property Generation and Validation policy section, earlier in this chapter:

When you are done configuring a value for the ‘Initiator ID’ must be condition, click OK to close the Configure Value dialog box. This will add the value to the Initiator ID entry properties. If necessary, you can modify the value by clicking the Configure button in the Add Entry window and then managing the list of entries in the Configure Value dialog box.

When you are done configuring the Initiator ID entry, click OK to close the Add Entry window. The entry is added to the Configure Value dialog box for the ‘name’ must be condition.

When you are done configuring a value for the ‘name’ must be condition, click OK to close the Configure Value dialog box. This will add the rule to the Options to Prevent Logon page of the wizard. If necessary, you can modify the rule by clicking the Configure button on that page and then managing the list of entries in the Configure Value dialog box.

Once you have completed the Options to Prevent Logon page, click Next to display the Properties to Be Updated page.

Figure 84: Properties to Be Updated

On this page, you can set up a list of user properties you want the policy to update. Each entry in the list includes the following information:

  • Property.  When deprovisioning a user, Active Roles will update this property of the user’s account.
  • LDAP Display Name.  Uniquely identifies the property to be updated.
  • Value to Assign.  After the deprovisioning operation is completed, the property has the value defined by this syntax.

You can use these buttons to manage the list on this page:

  • Add.  Allows you to select a user property and configure an update rule for that property. A property update rule specifies how to generate the new value to assign to the property.
  • Remove.  If you want the policy to no longer update a given property, select the property from the list and click Remove.
  • View/Edit.  Allows you to modify the update rule for the property you select from the list.

Clicking the Add button displays the Select Object Property dialog box where you can choose user properties you want to the policy to update. To choose a property, select the check box next to the property name, and then click OK.

You can select multiple check boxes. If you do so, the properties you have selected are added to the list on the wizard page, with the update rule configured to clear those properties, that is, to assign them the empty value.

If you select a single property in the Select Object Property dialog box, you are presented with the Add Value dialog box so you can proceed to configuring a property update rule.

Figure 85: Add Value

You can select one of these update options:

  • Clear value.  Causes the policy to assign the empty value to the property.
  • Configure value.  Allows you to configure a value for the ‘property’ must be condition.

With the second option, you must configure a value the policy will assign to the property upon the user deprovisioning. You can configure a value in the same way as you do when configuring a property update rule for the user name: Click the Configure button and follow the instructions provided earlier in this section (see Configuring a property update rule).

When you are done configuring a value, click OK to close the Add Value dialog box. The property name along with the property update rule is added to the wizard page. If necessary, you can modify the update rule by clicking the View/Edit button beneath the list of properties. This displays a dialog box, similar to the Add Value dialog box, allowing you to choose a different update option or set up a different value for the ‘property’ must be condition.

Once you have set up the list on the wizard page, click Next and follow the instructions in the wizard to create the Policy Object.

Steps for configuring a User Account Deprovisioning policy

To configure a User Account Deprovisioning policy

  1. On the Policy to Configure page, select User Account Deprovisioning, and then click Next.
  2. On the Option to Prevent Logon page, select the options you want the policy to apply when deprovisioning a user account. You can select any combination of these options:
    • Disable the user account
    • Set the user’s password to a random value
    • Set the user logon name to a random value
    • Set the user logon name (pre-Windows 2000) to a random value
    • Rename the user account to
  3. If you selected Rename the user account to, click Configure, and then complete the Configure Value dialog box by using the procedure outlined later in this topic, in order to specify how you want the policy to update the user name when deprovisioning a user account.
  4. Click Next.
  5. On the Properties to Be Updated page, specify how you want the policy to update user properties when deprovisioning a user account:
    • Click Add, and then complete the Select Object Property dialog box by using the procedure outlined later in this topic, in order to add property update rules.
    • Use View/Edit to modify existing rules.
    • Use Remove to delete existing rules.
  6. Click Next.
  7. On the Enforce Policy page, you can specify objects to which this Policy Object is to be applied:
    • Click Add, and use the Select Objects dialog box to locate and select the objects you want.
  8. Click Next, and then click Finish.

To complete the Configure Value dialog box

  1. Click Add.
  2. Configure an entry to include in the value (for instructions, see Steps for configuring entries).
  3. In the Configure Value dialog box, add more entries, delete or edit existing ones, and then click OK.

To complete Select Object Property dialog box

  1. From the Object property list, select an object property, and then click OK. The Add Value dialog box appears.

    If you select multiple properties, the Add Value dialog box is not displayed. The properties you have selected are added to the list on the Properties to Be Updated page, with the update rule configured to clear those properties, that is, to assign them the “empty” value.

  1. In the Add Value dialog box, do one of the following:
    • Select Clear value if you want the update rule to assign the empty value to the property.
    • Select Configure value if you want the update rule to assign a certain, non-empty value to the property. Then, click Configure and complete the Configure Value dialog box by using the instructions given earlier in this topic.

Scenario 1: Disabling and renaming the user account upon deprovisioning

The policy described in this scenario performs the following functions during the user deprovisioning process:

  • Disable the user account.
  • Append this suffix to the user name: - Deprovisioned, followed by the date that the user account was deprovisioned.

For example, the policy changes the user name John Smith to John Smith - Deprovisioned 12/11/2010.

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

  1. Create and configure the Policy Object that defines the appropriate policy.
  2. Apply the Policy Object to a domain, OU, or Managed Unit.

As a result, when deprovisioning a user account in the container you selected in Step 2, Active Roles disables and renames the user account as prescribed by this policy.

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

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating