Chat now with support
Chat with Support

Active Roles 8.0 LTS - 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 Microsoft 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 Appendix A: Using regular expressions Appendix B: Administrative Template Appendix C: Communication ports Appendix D: Active Roles and supported Azure environments Appendix E: Active Roles integration with other One Identity and Quest products Appendix F: Active Roles integration with Duo Appendix G: Active Roles integration with Okta Active Roles Language Pack

Deleting or changing the remote mailbox of an on-premises user

You can remove the remote mailbox (that is, the assigned Exchange Online mailbox) of an on-premises user with the Active Roles Web Interface and the Active Roles Console.

Deleting the remote mailbox of a user is typically required in case of an organizational or infrastructural change, but is also a mandatory prerequisite if you want to change the current remote mailbox of the user.

To delete the remote mailbox of an on-premises user

  1. In the Active Roles Web Interface, under Directory Management > Tree > Active Directory, navigate to the OU of the on-premises user whose remote mailbox you want to delete.

    Figure 156: Active Roles Web Interface – Navigating to the OU of the user

  2. Select the user and click Delete E-mail Addresses.

  3. To confirm the deletion of the email address, click OK.

    After clicking OK, Active Roles deletes the remote mailbox of the on-premises user. However, this change does not reset the value of the edsvaMsExchEnableRemoteMailRoutingAddress property of the user. While this does not cause any operational issues, One Identity recommends updating this value manually for consistency as described in the next step.

  4. (Optional) Open the Advanced Properties of the on-premises user. In the Active Roles Console, in the Active Directory (AD) tree, navigate to the Organizational Unit (OU) where the user is located, double-click the user, then in the Properties window, click Object > Advanced Properties.

    Figure 157: Active Roles Console – Opening the Advanced Properties of a user

  5. Search for the edsvaMsExchEnableRemoteMailRoutingAddress property.

    TIP: To find the property faster, enter its name (or part of its name) in the Look for property field. If you cannot find the property, select Show all possible attributes and Include attributes with empty values, too.

    After you found the property, open its settings by double-clicking it.

  6. In the Edit Attribute dialog, in Value, delete the configured remote mailbox.

  7. To apply your changes, click OK in each open window.

To change the remote mailbox of an on-premises user

  1. In the Active Roles Web Interface, delete the current remote mailbox of the on-premises user as described in the To delete the remote mailbox of an on-premises user procedure.

  2. Open the Advanced Properties of the on-premises user. In the Active Roles Console, in the Active Directory (AD) tree, navigate to the Organizational Unit (OU) where the user is located, double-click the user, then in the Properties window, click Object > Advanced Properties.

  3. Search for the edsvaMsExchEnableRemoteMailRoutingAddress property.

    TIP: To find the property faster, enter its name (or part of its name) in the Look for property field. If you cannot find the property, select Show all possible attributes and Include attributes with empty values, too.

    After you found the property, open its settings by double-clicking it.

  4. In the Edit Attribute dialog, in Value, specify the new remote mailbox for the user.

  5. To apply your changes, click OK in each open window.

Azure AD, Office 365, and Exchange Online management

Active Roles is an administrative platform that facilitates the administration and provisioning of Active Directory, Exchange, and Azure Active Directory (Azure AD) resources in on-premises, cloud-only and hybrid environments as well. You can manage all these resources through the Active Roles Web Interface.

  • In an on-premises environment, when you create new Active Directory objects (users, guest users, groups, contacts, and so on), Active Roles creates and stores these new objects in the local infrastructure of your organization.

  • In a cloud-only environment, when you create new Active Directory objects (users, guest users, groups, contacts, and so on), Active Roles creates and stores these new objects in the Azure Cloud.

  • In hybrid environments, when you create new Active Directory objects (users, guest users, contacts, and so on) Active Roles synchronizes the on-premises Active Directory objects and their properties to the Azure AD cloud. This synchronization is performed by the Active Roles Synchronization Service between Active Roles and Microsoft Office 365, whenever you configure an Active Directory object with the Active Roles Web Interface.

NOTE: Consider the following when administering Azure AD, Office 365 or Exchange Online resources:

  • The Active Roles Web Interface supports Azure AD-related operations only on Web Interface sites based on the Administrators template.

  • You can perform some of the procedures described in the following sections also in the Active Roles Management Shell. However, in this document, they are all described using the Active Roles Web Interface.

TIP: You can improve the performance of the Active Roles Web Interface by setting the timespan of an Azure PowerShell memory cache to shorten the waiting time when using any of the Azure and/or Exchange Online query functions under the Azure node.

To set the timespan of the memory cache, modify the value of the following registry key:

HKEY_LOCAL_MACHINE\Software\One Identity\Active Roles\Configuration\Service\AzurePowershellMemoryCacheTimeInSec

The default value is 30 seconds. Setting the value to 0 disables memory caching.

For the changes to take effect, after modifying the registry key, restart the Active Roles Administration Service. If you modify the timespan of the memory cache, the changed duration will only be visible after a timeout.

The Office 365 / Azure AD capabilities of Active Roles support the following administrative tasks:

  • Create an Office 365 user account associated with a given Active Directory user account.
  • Synchronize user properties from Active Directory user accounts to their associated Office 365 user accounts.
  • View or change the properties of the Office 365 user account associated with a given Active Directory user account.
  • Assign Office 365 licenses to the Office 365 user account associated with a given Active Directory user account.
  • Delete the Office 365 user account associated with a given Active Directory user account.
  • Create an Office 365 security group or distribution group associated with a given Active Directory group.
  • Synchronize group properties, including the members list, from Active Directory groups to their associated Office 365 groups.
  • View or change the properties of the Office 365 group associated with a given Active Directory group.
  • Delete the Office 365 group associated with a given Active Directory group.
  • Create an Office 365 external contact associated with a given Active Directory contact.
  • Synchronize contact properties from Active Directory contacts to their associated Office 365 external contacts.
  • View or change the properties of the Office 365 external contact associated with a given Active Directory contact.
  • Delete the Office 365 external contact associated with a given Active Directory contact.
  • View Office 365 domain and license information.
  • Create Office 365 users. When you create an Office 365 user, you can choose whether to license that user for Exchange Online.
  • Create security groups and distribution groups in Office 365. You can choose the type of the Office 365 group that you want to create.
  • Assign licenses to Office 365 users. When creating or administering a user, you can choose the Office 365 licenses that you want to assign to that user.
  • Restrict the licenses for Office 365 users. You can configure a policy to specify what Office 365 licenses can be assigned depending on user location in Active Directory.
  • View or change the Office 365 specific object properties. You can edit Office 365 users, groups and contacts.
  • Examine Office 365 licenses and license usage. For each of your license subscriptions, you can view how many licenses are valid, expired or assigned. This information is displayed on the add-on application page in the Active Roles console.
  • Examine Office 365 domains. For each of your Office 365 domains, you can view the status of the domain and see whether the domain is configured for single sign-on (federated). Azure Domains are listed in Azure Domains in Azure Configuration
  • Associate existing Office 365 users with on-premises Active Directory users. The synchronization workflow uses the GUID and the primary SMTP address to match an existing Office 365 user to the appropriate on-premises Active Directory user.

Configuring Active Roles to manage hybrid AD objects

When a user signs up for a Microsoft cloud service such as Azure Active Directory, details about the user’s organization and the organization’s Internet domain name registration are provided to Microsoft. This information is then used to create a new Azure AD instance for the organization. The same directory is used to authenticate sign in attempts when you subscribe to multiple Microsoft cloud services.

The Azure AD instance of the organization, also called the Azure AD tenant, stores the users, groups, applications, and other information pertaining to an organization and its security. To access the Azure AD tenant, we need an application that is registered with the tenant. Active Roles uses this application, also called the Azure AD application, to communicate to Azure AD tenant after providing the required consent.

The Active Roles Web Interface and Management Shell can be used to perform the Azure AD configuration tasks. The new feature in Active Roles enables you to add or modify existing tenants to the management scope through the web interface and Management Shell.

The latest release of Active Roles supports Multiple tenants model.

NOTE: Administrative users or users with sufficient privileges only can view Azure configuration.

The following section guides you through the Active Roles web interface and Management Shell to configure Azure AD tenants and applications and synchronize existing AD objects to Azure AD.

Configuring Active Roles to manage Azure AD using the GUI

Use the Active Roles Web Interface and the Active Roles Configuration Center to perform the following actions and configure Azure AD deployments:

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating