RapidIdentity Product Guide: New UI

Office 365 Agent Install Guide
Microsoft Awareness

Microsoft periodically updates its requirements, links, and nomenclature without prior notice.

Thus, some downloads and installations may not exactly correspond to a particular environment, or the Microsoft links may break due to a Microsoft content reorganization. If any of these events occur please contact Support to initiate the troubleshooting and updating processes.

System Requirements
  • Windows 2012R2 Server (or higher)

    Note

    The server on which the agent is running must have Windows Management Framework (WMF) 5.1.

  • Windows PowerShell and WinRM 3.0 or newer

  • Internet Information Services (IIS) 7 or newer

  • .NET Framework 4.x or higher

  • Microsoft Online Services Sign-In Assistant

  • MSOnline PowerShell for Azure Active Directory

  • SharePoint Online Management Shell (Only required for SharePoint Online support)

  • Must have access to:

    • Package Provider: NuGet

    • Up-to-date modules:

      • PowerShellGet

      • MSOnline

Note

The RapidIdentity Connect Exchange Administrative Web Service Agent exposes the Powershell based Exchange ManagementAPI as a web service for consumption by the Exchange and Office 365 adapters.

MSOnline PowerShell for Azure Active Directory Requirement

MSOnline PowerShell for Azure Active Directory currently requires the PowerShellGet module and should be installed prior to starting the process linked to MSOnline PowerShell for Azure Active Directory.

Installing/Configuring the Prerequisites
  • If running a version of Windows Server 2008R2:

  • Download and install both Microsoft Online Services Sign-In Assistant and MSOnline PowerShell for Azure Active Directory.

  • If Sharepoint Online support is desired, download and install Sharepoint Online Management Shell.

  • In Server Manager (2008R2):

    • Under Roles, make sure Web Server (IIS) Role is installed, and ASP.NET have been added to it.

    • Under Role Services, make sure IIS 6 Management Compatibility has been added

  • In Server Manager (2012):

    • Under Roles, select Web Server (IIS)

    • Under Features, make sure the all the .NET Framework 4.5 features are installed.

    • Under Role Services, make sure IIS 6 Management Compatibility has been added

  • In Internet Information Services (IIS) Manager:

    • Configure the IIS site that will host the service (can use the default website). It is strongly recommended that the site is configured to support or even require HTTPS connections.

    • Ensure ASP.NET is registered with IIS by running ”%WINDIR%\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis -i”

  • In the Office 365 admin panel, validate that the account being used by the agent holds the Global Administrator role (required to retrieve/submit information through remote power shell calls)

Installing the Agent

Exchange 2007 / 2010 is known to have incompatibilities with PowerShell 3 and .NET4, and a given .NET executable cannot be built to support both PowerShell 3 and .NET4

  • Run idautoExchangeAdminWSInstaller.msi.

  • When prompted, select the IIS Site you configured above.

Verifying Your Installation in Office 365

You can verify that the RapidIdentity Connect Exchange Administrative Web Service Agent is working correctly by accessing the agent through a web browser using a URL of the form:

http[s]://<hostname>[:<port>]/idautoExchangeAdminWS/test

where <hostname>[:<port>] is the hostname and port of the IIS site hosting the Agent

In the resulting page, select Exchange 2010 or higher, and enter the Exchange server name, and username/password for the administrative user, and press Test.