Chat now with support
Chat with Support

Active Roles 7.5.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 One Identity Starling Two-factor Authentication for Active Roles Managing One Identity Starling Connect 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 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 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 Federated Authentication Appendix F: Active Roles integration with other One Identity and Quest products Appendix G: Active Roles integration with Duo Appendix H: Active Roles integration with Okta

Action summary log

Clicking the View Log button displays a log containing summary information about the last run of the Group Family. The log includes descriptions of the error situations, if any occurred during the run, and summarizes the quantitative results of the run, such as the number of updated groups, the number of created groups, and the number of objects that have group memberships changed.

The log can be divided into three sections: Prolog, Error List, and Epilog. The Prolog and Epilog sections are always present in the log, whereas the Error List section only appears if any errors or warnings occurred during the run.

The Prolog section provides the following information:

  • The date and time the run was started
  • The number of managed objects found in the Group Family scope
  • The total amount of groupings found by analyzing the group-by properties

The Epilog section provides the following information:

  • The number of errors, if any occurred
  • The number of invalid combinations of group-by property values, if any detected
  • The number of groups the Group Family created during the run
  • The number of groups the Group Family updated during the run

The Error List section provides information about all errors and warnings the Group Family encountered during the run.

Steps for administering a Group Family

This topic covers some task-specific procedures that you can use to change configuration and properties of an existing Group Family.

To open the property sheet for a Group Family

  • Right-click the Group Family configuration storage group, and then click Properties.

To view or modify grouping rules

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Groupings tab, and then click Configure.
  3. Follow Steps 5 through 7 of the procedure for creating a Group Family (see Steps for creating a Group Family).
  4. On the Group-by Properties page, click Finish.
  5. Click OK to close the property sheet.

To view or modify group creation-related rules

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Controlled Groups tab, and then click Manage Rules.
  3. Follow Steps 9 through 12 of the procedure for creating a Group Family (see Steps for creating a Group Family).
  4. On the Exchange-related Settings page, click Finish.
  5. Click OK to close the property sheet.

To manually add a group to a Group Family

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Controlled Groups tab, and then click Capture Groups.
  3. In the Capture Groups window, click Add.
    1. In the Assign Group to Grouping dialog box, do the following, and then click OK:
    2. Click Select, and then select the group you want to add.
  4. In Group-by property, type a value of the group-by property. If multiple group-by properties are defined, type a value for each, so as to determine the grouping to which you want the group to be assigned.
  5. Click OK to close the Capture Groups window.
  6. Click OK to close the property sheet.

To remove a group from a group family

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Controlled Groups tab, and then click Capture Groups.
  3. In the Capture Groups window, select the group you want to remove from the Group Family, click Remove, and then click OK.
  4. Click OK to close the property sheet.

To schedule a Group Family update

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Schedule tab, and then click Configure.
  3. On the Group Family Scheduling page, do the following, and then click Finish:
    1. Select Schedule Group Family to run, and then set the appropriate date, time, and frequency of Group Family update.
    2. If you also want the Group Family to run one time immediately after you close the property sheet, select Run Group Family once after completing this page.
    3. From the Run on this server list, select the Administration Service you want to run the Group Family.
  4. Click OK to close the property sheet.

To view results of a Group Family update

  1. Open the property sheet for the Group Family (see instructions earlier in this topic).
  2. Click the Action Summary tab, and then click View Log.

To delete a Group Family

  • Right-click the Group Family configuration storage group, and then click Delete.

NOTE: Deleting a Group Family only deletes the configuration storage group of the Group Family. This operation does not delete the controlled groups of the Group Family. Later, you can configure another Group Family to take control of those groups.

Scenario: Departmental Group Family

Suppose the organizational unit (OU) named Users contains a number of user accounts. Also assume that for each of the values listed below there are one or more user accounts in the Users OU with the Department property set to that value. Thus, the following values of the Department property are encountered in the user accounts held in the Users OU:

  • Accounting
  • Executive Services
  • Facilities
  • Finance
  • Government Services
  • Human Resources
  • Information Technology
  • Operations

In this section, you can find the instructions on how to implement a Group Family that creates and maintains a separate group for users in each of those departments. The Group Family configuration storage group will be created in the organizational unit named Groups. The Group Family will be configured to create the departmental groups in that same OU.

Open the Active Roles console, and perform the following steps to implement the Group Family.

To create and run the Departmental Group Family

  1. Right-click the Groups OU and select New | Group Family.

This will start the New Group Family wizard. The remaining steps apply to that wizard.

  1. On the Welcome page, click Next.
  2. In the Group Family name box, type Departmental Group Family. Click Next.
  3. Click the Pre-configured grouping by option, click Department in the list under that option, and then click Next.
  4. Remove the Groups OU from the Containers list, and add the Users OU to that list. Click Next.
  5. Click the User option, and then click Next.
  6. Verify that the Group by these properties list includes the only entry—Department. Click Next.
  7. Select the Skip this step, without capturing groups manually check box. Click Next.
  8. Click Next to accept the default rule for group naming: CG-%<key.department>
  9. Click Next to accept the default group scope and type.
  10. Click Next to accept the default location for the controlled groups: Group Family home OU
  11. Click Next to accept the default settings related to Exchange.
  12. Select the Run Group Family once after completing this page check box. Click Next.
  13. Click Finish.

Once you have completed these steps, the Group Family performs all the necessary processing to create the groups, one group per department, and adds users to the appropriate groups based on the Department property.

You might look at the contents of the Groups OU in the Active Roles console to verify that the departmental groups are created successfully. You might also examine properties of a group generated by the Group Family, to verify that the membership list of the group is correct. For example, the membership list of the CG-Executive Services group consists of the user accounts that have the Department property set to Executive Services.

Dynamic Groups

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating