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

Configuring an M365 and Azure Tenant Selection policy

You can configure an O365 and Azure Tenant Selection policy in the Active Roles Console (also known as the MMC Interface) to:

  • Validate the selected Azure tenants for Azure users, guest users, O365 groups, Azure security groups, and contacts.
  • Select O365 Licenses for Azure users and guest users.
  • Select O365 Roles for Azure users and guest users.
  • Preprovision OneDrive for Azure users.
Prerequisites

Consider the following before configuring an O365 and Azure Tenant Selection policy:

  • The OneDrive settings of this policy are applicable to hybrid Azure users only, and will work only if you have already enabled OneDrive for your Azure tenant in the (Undefined variable: ActiveRoles_Azure_Admin.Azure short) Configuration > Modify (Tenant details) window of the Active Roles Configuration Center. For more information on enabling OneDrive for Azure users in an Azure tenant, see Enabling OneDrive in an Azure tenant.

  • To configure an O365 and Azure Tenant Selection policy, your Organizational Unit (OU) must already have the Azure - Default Rules to Generate Properties built-in policy configured. For more information on configuring the policy, see Configuring the Azure - Default Rules to Generate Properties policy.

To configure an O365 and Azure Tenant Selection policy

  1. Navigate to Configuration > Policies > Administration.

  2. 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.

  3. On the Name and Description page, provide a unique Name for the new Policy Object. Optionally, also provide a Description. To continue, click Next.

  4. On the Policy to Configure page, select O365 and Azure Tenant Selection, and click Next.

  5. On the Object Type Selection page, to specify the type of object you want the policy to provision, click Select, then click OK.

    TIP: If you do not see the object type you need, expand the list by selecting Show all possible object types.

    NOTE: If you want to assign and validate Office 365 licenses and roles, or provision OneDrive storage as part of the configured policy, select the User (user) object type in this step. Office 365 license and role validation, and OneDrive provisioning are not applicable to Azure Groups and Azure Contacts.

  6. On the Policy Conditions page, select your Azure tenant for which you want to set up the policy. To continue, click Next.

  7. (Optional) On the next Policy Conditions page, select the licenses to validate and assign to new Azure users in the Azure tenant. To continue, click Next.

    NOTE: If OneDrive storage is planned to be provisioned in the selected Azure tenant for Azure users, make sure that you select the SharePoint Online license in this step. Otherwise, the configured OneDrive storage cannot be provisioned for Azure users created later. For more information, see Creating a new cloud-only Azure user.

  8. (Optional) On the next Policy Conditions page, select the Office 365 roles to validate and assign to new Azure users in the Azure tenant. To continue, click Next.

  9. (Optional) To configure OneDrive storage for the Azure users of the Azure tenant, configure the following attributes on the OneDrive Folder Management page:

    • SharePoint Admin URL: Specify the URL of the SharePoint administration site of your Azure tenant. The URL has the following syntax: <azure-tenant-name>-admin.sharepoint.com

    • Size (in GB): Specify the default OneDrive storage size allocated for each Azure user in the Azure tenant.

    If you do not need to provision OneDrive storage for users in the Azure tenant, leave the settings empty and click Next.

    NOTE: If the wizard displays an error when clicking Next after configuring the OneDrive settings:

    • Check that the specified SharePoint Admin URL is correct.

    • Make sure that the specified OneDrive storage size is correct (that is, it is within the range of the individual cloud storage allowed for users in your organization).

  10. On the Enforce Policy page, select the Organizational Unit (OU) for which the policy will be applied. To do so, click Add to open the Select Objects window, then select the OU from the list. To continue, click OK then Next.

  11. To complete the wizard, click Finish.

Applying a new M365 and Azure Tenant Selection policy

Microsoft 365 user license management

  1. From the Web Interface, assign, or modify the Microsoft 365 license for an Azure AD User.

    The Policy is triggered for any Azure AD user in the Organization Unit for which the M365 and Azure Tenant selection policy is applied.

    If the policy conditions are not satisfied while assigning or modifying Azure AD User licenses, the following policy violation error is displayed:

    Provisioning policy failure. The 'O365 and Azure Tenant Selection' policy encountered an error. Exception in Azure Tenant Management Policy violation: The Azure user License(s) O365_BUSINESS_ESSENTIALS-PROJECTWORKMANAGEMENT, cannot be assigned. The policy prescribes that this Azure User requires only the specified license in the policy object to be assigned.

  2. To check whether there are any policy violations, right-click and select Check Policy

    For a container object, this displays the Check Policy dialog.

  3. Review the options in the Check Policy dialog and click OK.

    The Policy Check Results window is displayed.

    IMPORTANT: Office 365 user license management now allows Administrator to select a subset of the licenses selected in policy during user creation or modification.

Microsoft 365 user roles management through provisioning policy

From the Web Interface, assign or modify the Microsoft 365 roles for an Azure AD User.

If the policy conditions are not satisfied while assigning Azure AD User roles while creating an Azure AD user from the Active Roles Web Interface, the following policy violation error is displayed:

Provisioning policy failure. The 'O365 and Azure Tenant Selection' policy encountered an error. Exception in Azure Tenant Management Policy violation: The Azure user Role(s) cannot be assigned. The policy prescribes that this Azure User requires only the specified role in the policy object to be assigned.

Figure 199: OneDrive folder management wizard

Provisioning OneDrive for Azure AD users

  1. From the Web Interface, create an Azure AD User, and assign a valid SharePoint Online license.

  2. After the user is created, the OneDrive provisioning process is performed in the background and after some time the process is completed.

    NOTE: Consider the following when provisioning OneDrive for Azure AD users

    • If the SharePoint Admin URL is incorrect then the OneDrive provisioning is not successful.

    • For an existing Azure AD user, during modification of user properties:

      • If OneDrive is not provisioned, then OneDrive provisioning is triggered.

      • If OneDrive is provisioned, and any changes are made to the OneDrive provisioning policy, then the policy changes are applied on the user.

  3. To check the provisioning result, open the Azure Properties window for the user from the Web Interface, navigate to OneDrive tab.

    On successful provisioning of the user, the OneDrive URL, the used storage size, and the total storage size are displayed.

    NOTE: The storage size indicated in the policy gets synchronized to the Azure AD user's OneDrive.

Microsoft 365 roles management for hybrid environment users

Active Roles allows you to perform the following Microsoft 365 roles management tasks for hybrid users:

  • Assign Microsoft 365 roles to existing hybrid users

  • Modify or remove Microsoft 365 roles assigned to hybrid users

  • Microsoft 365 user roles management

IMPORTANT: The Active Roles Web Interface only displays Azure roles that have been enabled. To list the Microsoft 365 Roles on the Web Interface, run the following commands.

  • To get the guest inviter directory role template, run $roleTemplate = Get-AzureADDirectoryRoleTemplate | ? { $_.DisplayName -eq "Guest Inviter" }.

  • To enable an instance of the DirectoryRole template, run Enable-AzureADDirectoryRole -RoleTemplateId $roleTemplate.ObjectId.

Assigning Microsoft 365 roles to existing hybrid users

To assign Microsoft 365 roles to existing hybrid users

  1. On the Active Roles Web Interface navigation bar, click Directory Management.

  2. On the Views tab in the Browse pane, click Active Directory.

    The list of Active Directory domains is displayed.

  3. Click the specific domain, Container or the Organizational Unit, and then select the specific user for which you want to view or update the properties.

  4. In the Command pane, click Azure properties.

    The Azure Properties of the user are displayed.

  5. Click O365 Roles tab.

    The O365 Roles wizard displays the Microsoft 365 roles, for example, the Helpdesk Administrator, Directory Readers, and more.

  6. Select the Microsoft 365 roles that you want to assign to the user, and click Finish.

To check the Microsoft 365 roles assigned to the user, select the user, then navigate to Azure Properties > O365 wizard.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating