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

Scheduling an Azure object synchronization task

You can use the Sync Azure O365 Objects scheduled task of the Active Roles Console (also known as the MMC interface) to synchronize the following Azure objects and Azure tenant information between the Azure Portal and the Active Roles database:

  • Azure users

  • Azure guest users

  • Azure contacts

  • O365 groups

  • The Azure tenant ID and environment information (that is, whether the tenant is set to a Non-federated, Synchronized identity, or Federated environment configuration.

To configure a scheduled Azure object synchronization task

  1. In the Active Roles Console, in the Active Directory (AD) tree, navigate to Configuration > Server Configuration > Scheduled Task > Builtin.

  2. Open the scheduling properties of the Sync Azure O365 Objects built-in scheduled task. To do so, either:

    • Double-click Sync Azure O365 Objects, then in the Properties window, open the Schedule tab.

    • Right-click Sync Azure O365 Objects, then click Properties > Schedule.

    Figure 164: Active Roles Console – Scheduling properties of the scheduled task

  3. To customize the scheduling settings of the task, open the Properties > Schedule tab.

  4. To change the default scheduling settings of the task for your needs, modify the options of the Schedule tab accordingly:

    • Schedule Task: Specifies how frequently Active Roles runs the task (each hour, every day, or on a weekly/monthly basis). By default, tasks are run on a daily basis.

    • Start time and Start date: These settings specify the time and date of the first scheduled task run. These settings are not available if Schedule Task is set to Once or When Service starts.

    • Schedule Task Hourly / Daily / Weekly / Monthly: These settings specify the time interval of repeating the configured task.

      For example, setting Schedule Task to Hourly lets you specify the time interval between two task runs in hours and minutes, while setting it to Weekly lets you specify not just the number of weeks between two task runs, but also the days of the week on which Active Roles must run the task.

      NOTE: This setting is not available if Schedule Task is set to Once or When Service starts.

    • Stop the task if it runs more than: When selected, this setting sets a timeout (in hours and minutes) after which the task stops if it runs longer than the specified interval.

TIP: If the contents of the Members and/or Azure Properties actions in the Active Roles Web Interface for an Azure object differ from the object information available on the Azure Portal, One Identity recommends running the scheduled Sync Azure O365 Objects task manually to synchronize the Azure objects and Azure tenant information.

Managing Azure Security Groups

Active Roles supports CRUD (create, read, update and delete) operations for Azure AD Security groups and also lets you specify owners and add/remove members to or from existing Azure AD Security groups in your organization.

Azure Security groups are security principals used to secure objects (such as Azure users, Azure guest users, devices, applications, or other Azure Security groups) in Azure AD. Typically, Azure Security groups are set up to delegate application licenses or other resource permissions to users based on their group membership. For more information on Azure Security groups, see Groups in Microsoft 365 and Azure in the Microsoft 365 community documentation.

You can administer Azure Security groups via the Active Roles Web Interface.

Creating an Azure Security Group with the Web Interface

You can use the Active Roles Web Interface to create and enable new Azure security groups.

For more information on Azure Security groups, see Groups in Microsoft 365 and Azure in the Microsoft 365 community documentation.

To create a new Azure Security group

  1. Navigate to Directory Management > Tree > Azure > <azure-tenant-name> > Security Groups.

    The list of existing Azure Security groups in the selected Azure tenant appears.

  2. In the right-side pane, click New Group.

    The New Group in Security Groups window appears.

  3. Specify the Group Azure Display Name of the configured group.

    TIP: You can configure multiple groups with the same Group Azure Display Name in the same Azure tenant.

  4. Provide a short Description for the group.

  5. Configure the Membership type of the group:

    • Assigned: When selected, you can add or remove members to or from the group manually later. For more information, see Adding or removing members from an Azure Security Group with the Web Interface.

    • Dynamic Members: When selected, Active Roles sets up the group as a dynamic membership group, and will automatically update group membership based on the configured Dynamic membership rule syntax.

    TIP: Consider the following when configuring the Membership type:

    • Select Dynamic Members to quickly configure a group based on a certain membership logic. For example, if you need to set up a group for employees from the same geographical location, business unit, or functional area, One Identity recommends configuring the group with Dynamic Members.

    • If you select Dynamic Members, you will not be able to manually add or remove members to or from the Azure Security group, unless you change its Membership type to Assigned later. However, you can still manually configure the owner(s) for a dynamic Azure Security group, as described in Adding or removing owners from an Azure Security Group with the Web Interface.

    • Although the Membership type drop-down setting does not offer a separate Dynamic Devices option, you can actually set up dynamic Azure Security groups in Active Roles with the appropriate dynamic device membership rules (such as device.displayName). However, the Active Roles Web Interface cannot display member devices and applications.

    • You can always change the Membership type later by navigating to the following option of the Active Roles Web Interface:

      Directory Management > Tree > Azure > <azure-tenant-name> > Security Groups > <azure-security-group-name> > Azure Properties > General.

    • Changing the Membership type from Dynamic Members to Assigned later will keep the last set of members that were dynamically assigned to the group.

  6. If you set the Membership type to Dynamic Members, specify the Dynamic membership rule syntax. Active Roles will send the logic configured in this field to Azure to automatically assign or remove members to or from the group later.

    NOTE: Consider the following when using the Dynamic membership rule syntax setting:

    • This setting is enabled only if Membership type is set to Dynamic Members. However, in that case, it is mandatory and cannot be empty.

    • The specified dynamic membership rule must meet all rule syntax requirements, otherwise the window will return an error. For more information on the available membership rule properties, operators and values, see Dynamic membership rules for groups in Azure Active Directory in the Microsoft 365 documentation.

    • Whenever you modify the dynamic membership rule of a dynamic O365 group, it can take several minutes for Azure to update the list of group members in the Directory Management > Tree > Azure > <azure-tenant-name> > Security Groups > <azure-security-group-name> > Dynamic Members window.

  7. To complete the configuration of the new Azure Security group, click Finish.

    The new Azure Security group will appear under the Directory Management > Tree > Azure > <azure-tenant-name> > Security Groups node.

Modifying an Azure Security Group with the Web Interface

You can use the Active Roles Web Interface to modify the Azure properties of an existing Azure Security group in your Azure tenant. This is typically useful if you have to:

  • Modify the display name of the Azure Security group, for example because of an organizational or security policy change.

  • Change the configured membership type (manually assigned or dynamic) of the Azure Security group.

To modify the Azure properties of an Azure Security group

  1. Navigate to Directory Management > Tree > Azure > <azure-tenant-name> > Security Groups.

    The list of existing Azure Security groups in the selected Azure tenant appears.

  2. Select the group that you want to configure.

  3. In the right-side pane, click Azure Properties.

  4. In the left-side pane of the Azure Properties window, click Properties.

  5. (Optional) Specify the Group Azure Display Name of the configured group.

    TIP: You can configure multiple groups with the same Group Azure Display Name in the same Azure tenant.

  6. (Optional) Provide a short Description for the group.

  7. (Optional) Configure the Membership type of the group:

    • Assigned: When selected, you can add or remove members to or from the group manually later. For more information, see Adding or removing members from an Azure Security Group with the Web Interface.

    • Dynamic Members: When selected, Active Roles sets up the group as a dynamic membership group, and will automatically update group membership based on the configured Dynamic membership rule syntax.

    TIP: Consider the following when configuring the Membership type:

    • Select Dynamic Members to quickly configure a group based on a certain membership logic. For example, if you need to set up a group for employees from the same geographical location, business unit, or functional area, One Identity recommends configuring the group with Dynamic Members.

    • If you select Dynamic Members, you will not be able to manually add or remove members to or from the Azure Security group, unless you change its Membership type to Assigned later. However, you can still manually configure the owner(s) for a dynamic Azure Security group, as described in Adding or removing owners from an Azure Security Group with the Web Interface.

    • Changing the Membership type from Dynamic Members to Assigned later will keep the last set of members that were dynamically assigned to the group.

  8. (Optional) If you set the Membership type to Dynamic Members, specify the Dynamic membership rule syntax. Active Roles will send the logic configured in this field to Azure to automatically assign or remove members to or from the group later. For more information on how to specify a membership rule, see Dynamic membership rules for groups in Azure Active Directory in the Microsoft 365 documentation.

  9. To apply your changes, click Save.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating