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

Cross-domain Group Family

When you configure a Group Family, you choose containers that hold the objects you want Group Family to assemble into groups (managed object containers) as well as the container to hold those groups (controlled group container). The Group Family policy has the option allowing you to select managed object containers from any domains registered with Active Roles. With this option, managed object containers may be from different domains and the domain of the controlled group container may be different from the domain of the managed object containers. Depending on the location of the managed object containers, the groups controlled by Group Family can include objects from domains other than the domain that holds the controlled group container (external domains).

Active Directory has restrictions regarding the types of groups that can have members from external domains, and the types of groups that can have membership in other groups. All these restrictions apply to the groups controlled by Group Family. Thus, Active Roles does not allow Group Family to add objects from external domains to global groups, nor does it allow Group Family to add domain local groups to a global group. With these natural restrictions, you can configure Group Family so that its controlled groups include members from any domains registered with Active Roles.

As stated above, whether managed object containers can be selected from external domains depends upon the Group Family policy. If you want to use this capability, select the Enable cross-domain membership policy option. For more information, see Group Family policy options.

Group Family policy options

Group Family policy options determine the Group Family processing behavior. For instance, there is a policy option that determines whether controlled groups can have members from external domains.

You can view or change Group Family policy options in the Active Roles Console as follows:

  1. In the Console tree, select Configuration > Policies > Administration > Builtin.

  2. In the details pane, double-click Built-in Policy - Group Family.

  3. In the Built-in Policy - Group Family Properties dialog, click Policies, select the policy, and click View/Edit.

  4. In the Policy Properties dialog that appears, click Policy Settings.

The Policy Settings tab includes the following options:

  • Enable cross-domain membership: Select this option if you want Group Family to support the grouping of objects from external domains. When selected, this option allows each Group Family instance to have managed object containers from any domains that are registered with Active Roles. If this option is not selected, the managed object containers must be from the domain of the Group Family configuration storage group.

    Selecting this option should be considered a long-term commitment to scenarios where objects managed by Group Family may reside in domains other than the domain of the Group Family configuration storage group—external domains. Once you have enabled cross-domain membership, you can configure Group Family instances to look for managed objects in any domains registered with Active Roles. However, if you later decide to un-select this policy options, the Group Family instances that were configured to look for managed objects in external domains will cease to function. You will have to inspect and, if needed, reconfigure your existing Group Family instances to limit scope of managed objects to the domain of the Group Family configuration storage group.

  • Enable support for non-stored virtual attributes: When selected, this option makes it possible for Group Family to perform grouping based on custom non-stored virtual attributes-the attributes that have their value calculated by a certain policy rather than stored in the Active Roles database. This option can have a negative effect on Group Family performance, so select it only if you have any of the Group Family group-by properties implemented as a custom non-stored virtual attribute.

    This option is normally not selected for performance reasons, which causes Group Family not to create controlled groups that use a custom non-stored virtual attribute as a group-by property. You need to select this option if you want Group Family to create controlled groups by grouping objects based on custom non-stored virtual attributes.

Creating a Group Family

Creating a Group Family has two steps:

  1. Creating the Group Family configuration.

  2. Running the Group Family to initially create or capture groups.

The Active Roles Console provides the New Group Family Wizard for creating the Group Family configuration. The wizard creates a group, referred to as configuration storage group, and populates that group with the configuration data you specify. The wizard also allows you to run the Group Family immediately or schedule the Group Family to run on a regular basis.

NOTE: You can create any number of Group Families, with each Group Family intended to control a certain collection of groups. When linking a group to a grouping, the Group Family engine ensures the group is under the control of only the Group Family that created the link, thereby avoiding conflicts.

Groups created through Group Family does not support group name with special characters, such as, /\[]:;|=*?<>".

To create the Group Family configuration and run the Group Family

  1. To start the New Group Family Wizard, in the Console tree, right-click the Organizational Unit in which you want to create the Group Family configuration storage group, and select New > Group Family.

  2. Follow the instructions on the wizard pages.

  3. On the Name the Group Family page, specify a name for the Group Family.

    The wizard creates the Group Family configuration storage group with the name you specify on this page.

  4. On the Grouping Options page, do one of the following, then click Next:

    • To use a preconfigured grouping criterion, click Pre-configured grouping by, then select a criterion from the list.

    • To configure a custom grouping criterion, click Custom Grouping.

  5. On the Location of Managed Objects page, do one of the following, then click Next:

    • To assemble objects into groups, click Add, then select a container that holds the objects.

    • To remove a selected container from the Containers list, click Remove.

  6. On the Selection of Managed Objects page, configure the object type and/or filtering rule for group family membership, then click Next:

    • To choose an object by type, click one of the four topmost options. Alternatively, click Other, then click Specify to choose an object type from the Object Types list.

    • To filter objects, click Filter, and complete the Filter dialog.

    When ready, to view the list of objects that meet your specified conditions, click Preview.

  7. On the Group-by Properties page, Click Add, then select an object property from the Object property list. To continue, click Next.

  8. On the Capture Existing Groups Manually page, select Skip this step, without capturing groups manually, then click Next.

  9. On the Group Naming Rule page, configure the naming rule as applicable, and click Next:

    • To configure a value, click Configure, and complete the Configure Value dialog.

    • To fine-tune group naming with a specific rule, click Fine-tune Naming Rule, and complete the Fine-tune Naming Rule dialog.

  10. On the Group Type and Scope page, configure the group settings as applicable, then click Next:

    • In the Group scope area, select a group scope.

    • In the Group type area, select a group type.

  11. On the Location of Groups page, do one of the following, then click Next:

    • To have the Group Family create new groups in the OU that holds the Group Family configuration storage group, click Group Family home OU.

    • To have the Group Family create new groups in a different OU, click This Organizational Unit, then click Select to choose the OU.

  12. On the Exchange-related Settings page, select or clear the Mail-enable groups created by Group Family as appropriate. If you select this check box, set up the Exchange-related options on this page. To continue, click Next.

  13. On the Group Family Scheduling page, configure the scheduling options as you need, then click Next.

    • If you want the Group Family to run once you completed the wizard, select Run Group Family once after completing this page.

    • If you want the Group Family to run on a scheduled basis, select Schedule Group Family to run, then set the appropriate date, time, and frequency of runs by using the options below this check box.

    • From the Run on this server list, select the Administration Service you want to run the Group Family.

  14. On the last page of the wizard, click Finish.

To complete the Filter dialog

  1. Select an object property under Select Property.

  2. Select an operator from the Select operator drop-down list.

  3. In Specify value (case-insensitive), enter a value for the selected property.

  4. Click Add to add the filter condition that you just specified, to the Conditions list.

  5. To add multiple filter conditions, repeat the previous steps.

To complete the Configure Value dialog

  1. Click Add.

  2. In the Add Entry dialog, do one of the following, then click OK:

    • To configure a text entry, click Text under Entry type, and then type a value in the Text value box.

    • To configure a group-by property entry, click Group-by Property under Entry Type. Then, under Entry properties, select a property from the list and do one of the following:

      • If you want the entry to include the entire value of the property, click All characters of the property value.

      • If you want the entry to include a part of the property value, click The first, and specify the number of characters to include in the entry.

  3. Optionally, do the following:

    • Add more entries, delete or edit existing ones, and use the arrow buttons to move entries up or down in the list.

    • Paste the Clipboard contents to the list of entries by clicking the button next to the Configured value box.

  4. Click OK.

To complete the Fine-tune Naming Rule dialog

  1. Select the check box and click Configure next to the naming property that you want to configure, then complete the Configure Value dialog by using the procedure outlined above.

  2. Click OK.

Starting the New Group Family Wizard

You can start the New Group Family Wizard in the Active Roles Console by using the New > Group Family command on the Organizational Unit in which you want to place the configuration storage group.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating