To use modern authentication in Active Roles cmdlet execution, use the Exchange Online (EXO) PowerShell V2 module. Exchange Online PowerShell V2 module allows you to connect Exchange Online PowerShell with Modern Authentication. The EXO V2 cmdlets are REST API-based cmdlets that are much faster and reliable.
Installing EXO V2 PowerShell module
-
Start Windows PowerShell with administrator privileges.
-
Install PowerShellGet Module. To install the ExchangeOnlineManagement module, you need PowerShellGet 2.0 or later version. To install PowerShellGet Module, run the following cmdlet:
Install-Module PowerShellGet -Force
-
After installing PowerShellGet Module, close the Console and reopen it with administrator privilege.
-
Run the following cmdlet 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, see about_PSModulePath.
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")
Even if Modern Authentication has been previously disabled in Active Roles 7.4.3 by setting ModernAuthentication to false in the Office365ConnectorConfig.xml configuration file, upgrading to the latest version of Active Roles will result in Modern Authentication being enabled by default.
Before enabling or disabling Modern Authentication in Active Roles , enable Modern Authentication for the Azure tenant on the Exchange Online Management module. For more information on connecting to the EXO PowerShell module, see Enable or disable modern authentication for Outlook in Exchange Online and Disable Basic authentication in Exchange Online in the Microsoft Documentation.
Even if Modern Authentication has been previously disabled in Active Roles 7.4.3 by setting ModernAuthentication to false in the Office365ConnectorConfig.xml configuration file, upgrading to the latest version of Active Roles will result in Modern Authentication being enabled by default.
NOTE: Exchange Online Management module version 2.0.4 enforces Modern Authentication, causing the Office 365 connector connections to fail, if Modern Authentication is not enabled for the Azure tenant. Perform one of the following actions to prevent the issue:
-
In the Office365ConnectorConfig.xml configuration file, disable Modern Authentication and add /organizations. Example:
<Tenants>
<Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="false"/>
/organizations
</Tenants>
-
Roll back to Exchange Online Management module version 2.0.3.
To enable or disable Modern Authentication in the Office 365 Connector configuration file
-
Navigate to the folder where Active Directory is installed.
- Locate the Office365ConnectorConfig.xml configuration file.
-
To enable or disable Modern Authentication, set the value in the ModernAuthentication tag.
-
To enable Modern Authentication, set the value to true.
<Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="true"/>
-
To disable Modern Authentication, set the value to false.
<Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="false"/>
Example of enabling Modern Authentication
<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 tenants, each tenant should have a 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>
Example of disabling Modern Authentication
<ModernAuthenticationConfig>
<Tenants>
<!-- Example : <Tenant Name="mytenant.OnMicrosoft.com" ModernAuthentication="false"/>-->
</Tenants>
</ModernAuthenticationConfig>
To create a connection to Microsoft Azure Active Directory, use the Microsoft Azure AD Connector of the Active Roles .
The Microsoft Azure AD Connector supports the following features:
Table 98: Microsoft Azure AD Connector – Supported features
|
Bidirectional synchronization
Specifies whether you can both read and write data in the connected data system. |
Yes |
|
Delta processing mode
Specifies whether the connection can process only the data that has changed in the connected data system since the last synchronization operation. This reduces the overall synchronization duration. |
No |
|
Password synchronization
Specifies whether you can synchronize user passwords from an Active Directory (AD) domain to the connected data system. |
Yes |
|
Secure Sockets Layer (SSL) data encryption
Specifies whether the connector can use SSL to encrypt data transmitted between Active Roles and the connected data system. |
Yes |
