Chat now with support
Chat with Support

Active Roles 8.1.1 - Administration Guide

Introduction 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
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 Configure 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 Azure AD, Microsoft 365, and Exchange Online Management
Configuring Active Roles to manage Hybrid AD objects Managing Hybrid AD users
Creating a new Azure AD user with the Web Interface Viewing or updating the Azure AD user properties with the Web Interface Viewing or modifying the manager of a hybrid Azure user Disabling an Azure AD user Enabling an Azure AD user Deprovisioning of an Azure AD user Undo deprovisioning of an Azure AD user Adding an Azure AD user to a group Removing an Azure AD user from a group View the change history and user activity for an Azure AD user Deleting an Azure AD user with the Web Interface Creating a new hybrid Azure user with the Active Roles Web Interface Converting an on-premises user with an Exchange mailbox to a hybrid Azure user Licensing a hybrid Azure user for an Exchange Online mailbox Viewing or modifying the Exchange Online properties of a hybrid Azure user Creating a new Azure AD user with Management Shell Updating the Azure AD user properties with the Management Shell Viewing the Azure AD user properties with the Management Shell Delete an Azure AD user with the Management Shell Assigning Microsoft 365 licenses to new hybrid users Assigning Microsoft 365 licenses to existing hybrid users Modifying or removing Microsoft 365 licenses assigned to hybrid users Updating Microsoft 365 licenses display names
Unified provisioning policy for Azure M365 Tenant Selection, Microsoft 365 License Selection, Microsoft 365 Roles Selection, and OneDrive provisioning Microsoft 365 roles management for hybrid environment users Managing Microsoft 365 contacts Managing Hybrid AD groups Managing Microsoft 365 Groups Managing cloud-only distribution groups Managing cloud-only dynamic distribution 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 cloud-only shared mailboxes
Modern Authentication 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 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

Create or modify an Access Rule

You can create a new Access Rule in the Configuration > Access Rules container, or modify an existing Access Rule in that container.

To create a new Access Rule

  1. Right-click the Access Rules container, and select New > Access Rule.

  2. On the General page, type a name and description for the new Access Rule.

  3. Click Next to proceed to the Conditions page.

  4. Configure a conditional expression, then click Finish.

To modify an existing Access Rule

  1. Right-click the Access Rule you want to modify, then click Properties.

  2. On the General page, view or change the name and description of the Access Rule.

  3. On the Conditions page, view or change the conditional expression.

Configure a conditional expression for an Access Rule

The Conditions page provides an editor for configuring a conditional expression. When you configure an expression, you need to add at least one condition. Initially, you add a condition to the default condition group. You can create additional condition groups to group a set of conditions and nest the grouped conditions within other condition groups.

A condition group contains one or more conditions connected by the same logical operator. By grouping conditions, you specify that those conditions should be evaluated as a single unit. The effect is the same as if you put parentheses around an expression in a mathematical equation or logic statement.

To add a condition to a condition group

  • Click the name of the condition group and then click Insert condition.

    OR

  • Click the plus sign (+) next to the name of the condition group.

You can remove a condition, if needed, by clicking the Delete condition button labeled X on the right side of the list item representing the condition in the condition builder.

To add a condition group into another condition group

  • Click the name of the condition group, point to Insert condition group, and then click an option to specify the logical operator:

    • AND group: The condition group evaluates to TRUE if all conditions in the group are TRUE.

    • OR group: The condition group evaluates to TRUE if any condition in the group is TRUE.

By default, AND is the logical operator between the conditions in a condition group. It is possible to change the logical operator by converting the condition group to a different group type: Click the name of the group, point to Convert condition group to, and then click the option appropriate to the desired logical operator.

You can remove an entire condition group, if needed, by clicking the name of the group and then clicking Delete condition group.

Once you have added a condition to a condition group, you can use the following steps to configure the condition.

To configure a condition

  1. Click Configure condition to evaluate, and then choose from the following options to specify what you want the condition to evaluate:

    • Click Device claim to evaluate a computer claim, or groups the computer account is a member of. Then, in the claim type list, select the desired claim type, or click Group if you want the condition to evaluate the group membership of the computer account.

    • Click Target object property to evaluate a certain property of the object to which the authorizing user requests access. Then, in the property list, select the desired property.

    • Click User claim to evaluate a user claim, or groups the user account is a member of. Then, in the claim type list, select the desired claim type, or click Group if you want the condition to evaluate the group membership of the user account.

  2. Click in the middle field of the condition line to choose the comparison operator you want.

  3. Click Define value to compare to, and then choose from the following options to specify the desired comparison value:

    • Click Device claim to perform comparison with a computer claim. Then, in the claim type list, select the desired claim type.

    • Click Target object property to perform comparison with the value of a certain property of the object to which the authorizing user requests access. Then, in the property list, select the desired property.

    • Click User claim to perform comparison with a user claim. Then, in the claim type list, select the desired claim type.

    • Click Value to perform comparison with a particular text string, integer, Boolean value, or a list of groups. Then, supply the desired value. The value you can supply depends upon the type of data the condition is intended to evaluate. For example, when configuring a condition to evaluate group memberships, you have to supply a list of groups as a comparison value. If the claim type you have selected to evaluate provides a list of suggested values, then you can only select a comparison value from that list.

When you configure a condition, consider the following:

  • Only single-value claim types and object properties are supported. The multi-value claim types and object properties are filtered out from the lists provided by the condition builder.

  • To perform comparison, a valid condition requires that values on either side of the comparison operator be of the same or compatible data type. Therefore, when you supply a comparison value, the condition builder restricts you to the options that match the data type of the claim or property you choose to evaluate. If you choose to evaluate a string-value, integer-value, or Boolean claim type or object property, then the comparison value must be a string, integer, or Boolean value, respectively.

  • If you choose to evaluate the group membership of a user or device, the comparison value must be a list of groups. Other options are unavailable in this case.

Apply an Access Rule to Access Template links

Access Rules are intended to be applied to Access Template links. A single Access Rule or no Access Rule can be applied to a given link. By default, no Access Rule is applied, which configures an unconditional link. By applying an Access Rule, you create a conditional link that has an effect only if the Access Rule’s conditional expression evaluates to True during the permission check.

To apply an Access Rule

  1. In a list of Access Template links, double-click the Access Template link to which you want to apply the Access Rule.

    You can select Access Template links from various lists in the Active Roles Console. Thus, you can use the Delegate Control command on a container object to display a list of all Access Template links that determine the permission settings for that container. The Links command on an Access Template displays all links of that Access Template. The Active Roles Security tab in the advanced details pane lists the Access Template links that determine the security settings for the object selected in the Active Roles Console.

  2. In Properties, click Access Rule.

  3. Click Change, then select the Access Rule you want to apply.

From the Access Rule tab, you can also perform the following tasks:

  • Choose a different Access Rule for the selected Access Template link. Click the Change button and choose the Access Rule you want.

  • View or change the Access Rule applied to the selected Access Template link. Click the Properties button and then go to the Conditions page to review or modify the conditional expression of the Access Rule.

  • Remove the Access Rule from the selected Access Template link. Click Clear to remove the Access Rule.

Deploying an Access Rule

This section demonstrates how to implement a security scenario where each delegated administrator is restricted to managing users from a single department. The scenario is implemented by using an Access Rule that enables a delegated administrator to access only those objects whose Department property is identical to the Department claim of that delegated administrator.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating