Entry type: Parent OU Property
When you select Parent OU Property under Entry type in the Add Entry window, the Entry properties area looks as follows.
Figure 51: Add Entry: Parent OU Property
Using this entry type, you can configure a value based on a property of a parent Organizational Unit (OU) of the object being managed by this policy. To choose an OU property, click Select.
If you want the entry to include the entire value of the property, click All characters of the property value. Otherwise, click The first, and specify the number of characters to include in the entry.
In the latter case, you can select the If value is shorter, add filling characters at the end of value check box, and type a character in the Filling character box. This character will fill the missing characters in the value of the OU property if the value is shorter than specified in the box next to the option The first.
You can also specify the level of the OU you want to the policy to use. To use the property of the OU in which the object resides, click Immediate parent OU of the object being managed by this policy. To use the property of a parent OU of a different level, click More distant parent OU and then, in the Level box, specify the level of the OU. Lower level means greater distance from the managed object in the hierarchy of containers above that object. OU level 1 is an immediate child OU of the domain.
When you are done configuring an entry, click OK to close the Add Entry window. The entry is added to the Configure Value dialog.
Entry type: Parent Domain Property
When you select Parent Domain Property under Entry type in the Add Entry window, the Entry properties area looks as follows.
Figure 52: Add Entry: Parent Domain Property
Using this entry type, you can configure a value based on a property of the domain of the object being managed by this policy. To choose a domain property, click Select.
If you want the entry to include the entire value of the property, click All characters of the property value. Otherwise, click The first, and specify the number of characters to include in the entry.
In the latter case, you can select the If value is shorter, add filling characters at the end of value check box, and type a character in the Filling character box. This character will fill the missing characters in the value of the domain property if the value is shorter than specified in the box next to the option The first.
When you are done configuring an entry, click OK to close the Add Entry window. The entry is added to the Configure Value dialog.
Entry type: Mask
When you select Mask under Entry type in the Add Entry window, the Entry properties area looks as follows.
Figure 53: Add Entry: Mask
With this entry type, you can define which characters (letters, numerals) are acceptable in the entry you add to the value of the controlled property.
If you want to allow the entry to include any series of characters, click Any characters or no characters.
If you want to specify a maximum number of allowed characters the entry may include, click At most the specified number of characters. In the Number of characters box, specify the number of allowed characters. The entry may include any number of characters not exceeding the specified number. Under Allowed characters, select check boxes to specify the allowed characters.
If you want to specify an exact number of allowed characters that the entry must include, click Exactly the specified number of characters. In the Number of characters box, specify the number of allowed characters. The entry must include exactly the specified number of characters. Under Allowed characters, select check boxes to specify the allowed characters.
When you are done configuring an entry, click OK to close the Add Entry window. The entry is added to the Configure Value dialog.
Configuring a Property Generation and Validation policy
To configure a Property Generation and Validation policy via the Active Roles Console (also known as the MMC interface, perform the following procedure.
To configure a Property Generation and Validation policy
-
Navigate to Configuration > Policies > Administration.
-
To open the New Provisioning Policy Object Wizard dialog, right-click in the middle pane to open the context menu, and then select New > Provisioning Policy.
-
On the Name and Description page, provide a unique Name for the new Policy Object. Optionally, also provide a Description. To continue, click Next.
-
On the Policy to Configure page, select Property Generation and Validation, and then click Next.
-
On the Controlled Property page, click Select to open the Select Object Type and Property dialog.
-
To select the object type and its object property you want the policy to control, use the settings of the Select Object Type and Property dialog:
-
Use the Object type drop-down menu to select the object type whose property you want to provision.
-
Use either the Look for Property search box to manually search for the object property you want to provision, or browse it in the Object Property list.
TIP: If you do not see the object type you need, expand the list by selecting Show all possible object types.
NOTE: Policy Object settings specific to Azure cloud-only objects (such as cloud-only Azure users, guest users, or contacts) are available only if your Active Roles deployment is licensed for managing cloud-only Azure objects. Contact One Identity support for more information.
Also, Policy Objects specific to Azure cloud-only objects will work correctly only if an Azure tenant is already configured in the AD of the organization, and Active Roles is already set as a consented Azure application for that Azure tenant. For more information on these settings, see Configuring an Azure tenant and Active Roles as an Azure application.
-
Once you selected the object and property, click OK to continue.
-
On the Configure Policy Rule page, specify the condition(s) you want to configure for the policy by selecting them in the Select conditions to configure policy rule list. The selected conditions then appear in the Edit policy rule text box.
-
(Optional) If the selected condition supports editing, then click the underlined part of the condition to open the Add Value dialog and edit its settings.
To specify additional configuration for the condition, enter a variable into the Value field, then click OK to close the Add Value dialog.
Alternatively, click Configure Value, then click Add, and configure an entry manually in the Add Entry dialog. For more information on manual configuration, see Steps for configuring entries. To close the Add Value dialog, click OK.
-
(Optional) If multiple conditions are selected, switch between the AND and OR logic of the condition relations by clicking and or or.
-
After selecting and configuring the condition(s), click Next.
-
(Optional) On the Policy Description page, modify the default description of the policy generated by the wizard. To do so, select Modify this policy description to make the description editable. Modify the description, then click Next.
-
On the Enforce Policy page, specify the objects to which the configured Policy Object will be applied. Click Add, and then use the Select Objects dialog to locate and select the objects.
TIP: When provisioning cloud-only Azure users or guest users, you can either select the respective object category (such as the Azure user or Azure guest user node) in this step, or the Azure tenant that contains the Azure objects.
- Click Next and then Finish to complete creating the Policy Object.