Installing Exchange Agent 2023.03.27

Upgrading Exchange Agent for Microsoft Online Deprecation

Microsoft is retiring several PowerShell modules that can impact the RapidIdentity Exchange Agent, requiring customers to upgrade their RapidIdentity Exchange Agent to the new 2023.03.27 version in advance of Microsoft's change.

Click here for more information regarding Microsoft's PowerShell deprecations.

Upgrade Instructions

Prerequisites

• RapidIdentity On-Premise customers must upgrade to 2023.0.0-hotfix1
• RapidIdentity Cloud customers must be running 2023.01.0-hotfix2

Process

1. Log into Azure AD and find your existing App Registration for the Exchange Agent.
2. Click API Permissions:
   
3. Click Add a Permission:
   
4. Click Microsoft Graph:
   
5. Click Application Permissions:
   
6. Add the following permissions:
   
7. Click Grant Admin Consent for < domain >:
   
8. Navigate back to Azure Active Directory:
   
9. Click Roles and Administrators:
   
10. Search for Password Administrator:
    
11. Double click on the row that is returned:
    
12. Click Add Assignments:
    
13. Search for your App Registration name, select the result, and click Add:
    
14. Now, navigate to your Windows server where the Exchange Agent is installed and uninstall it.
15. Install Microsoft Graph Powershell module:

Install-Module Microsoft.Graph -Scope AllUsers

16. Install the new Exchange Agent. Download by clicking below:

idautoExchangeAdminWSInstaller-2023.3.27.msi

17. Open the Internet Information Service (IIS) Manager to configure the Agent, navigate to Application Pools and select Advanced Settings on ** idautoExchangeAdminWS and update the application pool for Exchange Agent with the Administrator User and Password.

18. Use the IIS Manager to Recycle the idautoExchangeAdminWS Application Pool.

19. You are ready to test! Use this URL to test: http://localhost/idautoExchangeAdminWS/test
    

20. You will notice that there is a new field: Tenant ID. This corresponds to the Azure Tenant ID, and can be found in the Azure AD Portal in the App Registration details.