Chat now with support
Chat with Support

Active Roles 7.4.3 - Synchronization Service Administration Guide

Synchronization Service Overview Deploying Synchronization Service Getting started Connections to external data systems
External data systems supported out of the box
Working with Active Directory Working with an AD LDS (ADAM) instance Working with Skype for Business Server Working with Oracle Working with Exchange Server Working with Active Roles Working with One Identity Manager Working with a delimited text file Working with Microsoft SQL Server Working with Micro Focus NetIQ Directory Working with Salesforce Working with ServiceNow Working with Oracle Unified Directory Working with an LDAP directory service Working with IBM DB2 Working with IBM AS/400 Working with an OpenLDAP directory service Working with IBM RACF connector Working with MySQL database Working with an OLE DB-compliant relational database Working with SharePoint Working with Microsoft Office 365 Working with Microsoft Azure Active Directory
Using connectors installed remotely Creating a connection Renaming a connection Deleting a connection Modifying synchronization scope for a connection Using connection handlers Specifying password synchronization settings for a connection
Synchronizing identity data Mapping objects Automated password synchronization Synchronization history Scenarios of use Appendix A: Developing PowerShell scripts for attribute synchronization rules Appendix B: Using a PowerShell script to transform passwords

Installing EXO PowerShell module

To use modern authentication in Active Roles command-let execution, use the Exchange Online (EXO) PowerShell V2 module. Exchange Online PowerShell V2 module allows you to connect Exchange Online PowerShell with Modern AuthenticationThe EXO V2 commad-lets are REST API-based command-lets that are much faster and reliable. Currently, this is optional and provided as a preview feature.

NOTE: You can install the EXO PowerShell x64 module only. The EXO PowerShell v2 module is currently a preview feature. For more information, see https://docs.microsoft.com/en-us/powershell/exchange/exchange-online/exchange-online-powershell-v2/exchange-online-powershell-v2?view=exchange-ps#install-the-exo-v2-module.

Installing EXO V2 PowerShell module

  1. Start Windows PowerShell with administrator privileges.

  2. Install PowerShellGet Module. To install the ExchangeOnlineManagement module, you need PowerShellGet 2.0 or later version.

    Install-Module PowerShellGet -Force

  3. After installing PowerShellGet module, close the console and reopen it with administrator privilege.

  4. Run the following command-let to install Exchange Online PowerShell V2 Module:

    Install-Module –Name ExchangeOnlineManagement

    By default, the module is installed in C:\Program Files\WindowsPowerShell\Modules.

    The module can also be installed in a custom location and add module path to value of the PSModulePath environment variable value. For more information, https://docs.microsoft.com/en-us/powershell/scripting/developer/module/modifying-the-psmodulepath-installation-path.

For example:

Find-Module -Name 'ExchangeOnlineManagement' -Repository 'PSGallery' | Save-Module -Path <custompath>

$envarname = "PSModulePath"

$envar = (get-item env:$envarname).Value

[Environment]::SetEnvironmentVariable($envarname, $envar + ";<customPath>", "Machine")

Working with Modern Authentication

Before enabling or disabling Modern authentication in Active Roles Synchronization Service, enable Modern Authentication for the tenant on Exchange Online. For more information on connecting to EXO PowerShell module, see https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/enable-or-disable-modern-authentication-in-exchange-online and https://docs.microsoft.com/en-us/exchange/clients-and-mobile-in-exchange-online/disable-basic-authentication-in-exchange-online.

Enabling or disabling from Office 365 Connector configuration file

  1. Navigate to the location where Synchronization service is installed.

  2. Search Office365ConnectorConfig.xml configuration file.
  3. To enable Modern Authentication, set the value to True in the <Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="true"/> tag. Set the value to False, to disable Modern Authentication.

For example:

<ModernAuthenticationConfig>

<Tenants>

<!-- Example : <Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="true"/>-->

</Tenants>

</ModernAuthenticationConfig>

NOTE: For multiple tenants, use mytenant1.OnMicrosoft.com, mytenant2.OnMicrosoft.com, and so on. For multiple tenant, each tenant should have separate tenant child node under the Tenants node.

<ModernAuthenticationConfig>

<Tenants>

<Tenant Name="mytenant1.OnMicrosoft.com" ModernAuthentication="true"/>

<Tenant Name="mytenant2.OnMicrosoft.com" ModernAuthentication="true"/>

.

.

</Tenants>

</ModernAuthenticationConfig>

Working with Microsoft Azure Active Directory

To create a connection to Microsoft Azure Active Directory, you need to use Synchronization Service in conjunction with a special connector called Microsoft Azure AD Connector. This connector is included in the Synchronization Service package.

The Microsoft Azure AD Connector supports the following features:

 

Table 111: Supported features

Feature

Supported

Bidirectional synchronization

Allows you to read and write data in the connected data system.

Yes

Delta processing mode

Allows you to process only the data that has changed in the connected data system since the last synchronization operation, thereby reducing the overall synchronization operation time.

No

Password synchronization

Allows you to synchronize user passwords from an Active Directory domain to the connected data system.

Yes

Secure Sockets Layer (SSL) data encryption

Uses SSL to encrypt data that is transmitted between Synchronization Service and connected data system.

Yes

In this section:

Creating a Microsoft Azure Active Directory connection

To create a connection, complete the following steps:

Related Documents