RapidIdentity Product Guide: New UI

Exchange Agent Install Guide for Exchange 2010/2013
System Requirements

System Hosting Exchange

  • Exchange 2013+

  • Windows PowerShell and winRM 3.0 or higher

Note

The Agent may be deployed on the same server hosting Exchange (if it meets the OS requirements) or a different server in the same domain.

System Hosting Agent

  • Windows Server 2012 or newer

    Note

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

  • Windows PowerShell and WinRM 3.0 or higher

  • Internet Information Services (IIS) 7 or higher

  • .NET Framework 4.x

  • Must have access to:

    • Package Provider: NuGet

    • Up-to-date modules:

      • PowerShellGet

      • MSOnline

Note

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

Installing/Configuring the Prerequisites

Both Systems

System Hosting Exchange

  • In Internet Information Services (IIS) Manager:

  • Make sure Powershell virtual directory is configured to allow Windows Authentication.

System Hosting Agent

  • In Server Manager:

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

  • 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

Installing the Agent
  • If your environment is running RapidIdentity Connect 4.0 or later with Exchange 2013 or higher, download the most current version of the agent which will be listed at the top of the directory with a name format ending in yyyy.m.d.msi. In this example, the most current agent is idautoExchangeAdminWSInstaller-2018.3.1.msi.

  • Run idautoExchangeAdminWSInstaller.msi

  • When prompted, select the IIS Site.

Verifying Your Installation in Exchange 2013 or Newer

You can verify that the RapidIdentity 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 2013 or newer, and enter the Exchange server name, and username/password for the administrative user, and press Test.