Chat now with support
Chat with Support

Active Roles 7.4.1 - 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 License Management Office 365 Roles Management 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_Overview
Config ARS to Manage Hybrid AD Objects Managing Hybrid AD Users Office 365 roles management for hybrid environment users Managing Office 365 Contacts Managing Hybrid AD Groups Managing Azure O365 or Unified Groups
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 delegation for Federated Authentication

E-mail Alias Generation

Policies of this category are intended to automate the assignment of the e-mail alias when designating a user as mailbox-enabled on Microsoft Exchange Server. By default, Microsoft Exchange Server provides for the following recipient e-mail address format: <e-mail alias>@<domain name>

You can use pre-defined rules to generate e-mail aliases, or configure custom rules. For example, you can configure a policy to compose the e-mail alias of the first initial followed by the last name of the user. Custom rules provide for addition of an incremental numeric value, to ensure uniqueness of the alias. You can also specify whether the alias can be modified by the operator who creates or updates the user account.

How this policy works

When making a user mailbox-enabled, Active Roles relies on this policy to assign a certain e-mail alias to the user account. The policy generates the alias based on user properties, such as the pre-Windows 2000 user logon name, first name, initials, and last name. A custom rule can be configured to use other properties.

A custom rule can also be configured to add so-called uniqueness number. Uniqueness number is a numeric value the policy includes into the alias, incrementing that value in the event of an alias naming conflict. For example, the policy can automatically change the generated alias from John.Smith to John1.Smith if a mailbox with the alias John.Smith already exists. If the alias John1.Smith is also in use, the new alias will be changed to John2.Smith, and so on.

The policy configuration provides the option to allow or disallow manual edits of policy-generated aliases. Permission to modify a policy-generated alias can be restricted to the case where the alias is in use by another mailbox.

Some specific features of the policy behavior are as follows:

  • With a rule that does not use a uniqueness number, Active Roles simply attempts to assign the generated alias to the user account. The operation may fail if the generated alias is not unique, that is, the alias is already assigned to a different user account. If the policy allows manual edits of policy-generated aliases, the alias can be corrected by the operator who creates the user account.
  • With a custom rule that uses a uniqueness number, Active Roles adds a button at the client side, next to the Alias field on the user creation and modification forms.

    To generate an alias, the client user (operator) must click that button, which also serves the situation where the generated alias is in use. Clicking the Generate button increases the uniqueness number by one, thereby allowing the alias to be made unique.

  • With a custom rule configured to include user properties that are normally not displayed on the user creation forms, an extra page is added to the New Object - User wizard in the Active Roles console, thus making it possible to specify the user properties required to generate the alias.
  • The policy defines a list of characters that are unacceptable in
    e-mail aliases. Acceptable are neither space characters nor these characters: @ * + | = \ ; : ? [ ] , < > /
  • The policy causes to deny processing of operation requests that assign the “empty” value to the e-mail alias.
  • When checking user accounts forActive Roles policy compliance (see later in this document), Active Roles detects, and reports of, the aliases that are set up not as prescribed by the alias generation policy.

How to configure an E-mail Alias Generation policy

To configure an E-mail Alias Generation policy, select E-mail Alias Generation on the Policy to Configure page in the New Provisioning Policy Object wizard or in the Add Provisioning Policy wizard. Then, click Next to display the E-mail Alias Generation Rule page:

Figure 56: E-mail Alias Generation Rule

On the E-mail Alias Generation Rule page, you can select a pre-configured rule or create a custom alias-generation rule. The first four options on the page are self-explanatory. For example, the first option makes the e-mail alias the same as the user logon name (pre-Windows 2000). The option Other combination of user properties, discussed later in this section, allows you to configure a custom rule, including the addition of uniqueness number.

By selecting the Allow manual edits of e-mail alias check box, you authorize the operator who creates or updates the user account to make changes to the policy-generated alias. If this check box is cleared, Active Roles displays the Alias field as read-only on the user creation and modification forms.

By selecting the Always option, you authorize the operator to modify the alias at his or her discretion. With the option Only if a unique alias cannot be generated by this policy, you limit manual changes to the situation where a unique alias cannot be generated in accordance with the policy rules.

Configuring a custom generation rule

Configuring a custom generation rule

To configure a custom rule, click Other combination of user 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 ‘Alias’ 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 20: Available entries

Type of Entry



Adds a text string to the value.

Uniqueness Number

Adds a numeric value the policy will increment in the event of an alias naming conflict.

User Property

Adds a selected property (or a part of a property) of the user account to which the policy will assign the alias.

Parent OU Property

Adds a selected property (or a part of a property) of an organizational unit in the hierarchy of containers above the user account to which the policy will assign the alias.

Parent Domain Property

Adds a selected property (or a part of a property) of the domain of the user account to which the policy will assign the alias.

Instructions on how to configure an entry depend on the type of the entry. For each type of an entry, you can find the instructions earlier in this chapter:

When you are done configuring a value, click OK to close the Configure Value dialog box. This will add the value to the policy rule. If necessary, you can modify the value by clicking the Configure button and then managing the list of entries in the Configure Value dialog box.

When you are done configuring the policy rule, click Next on the E-mail Alias Generation Rule page and follow the instructions in the wizard to create the Policy Object.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating