How to remove a configured service account in Exchange Reporter Plus

Note: This article applies to existing customers updating to build 5800 and above from build 5726 and below.

Objective

This article explains how to remove a previously configured service account in Exchange Reporter Plus for customers upgrading to build 5800 and above to improve security and simplify permission management.

With this change, you can now choose to replace your configured service account from Exchange Reporter Plus with an Entra application registration. You have to update your Entra app permissions accordingly so that all tasks previously handled by the service account can function seamlessly.

Note: To minimize the impact on your services, we suggest updating your Entra app registration first, then removing your service account from Exchange Reporter Plus.

Prerequisites

• A Exchange Reporter Plus technician account with the Super Admin role
• A Microsoft Entra ID account with the permissions to modify Entra app permissions

Steps to follow

Step 1: Update your Entra app permissions

You can update the Entra app permissions configured for your tenant in Exchange Reporter Plus with just a few clicks. The process is automatic and applies all the required permissions for the full functionality of the product.

1. Log in to Exchange Reporter Plus as a technician with the Super Admin role.
2. Navigate to Org/Tenant Settings > Exchange Online.
3. In the REST API Access column, click Update Permissions next to the Microsoft 365 tenant from which you are removing the service account.



4. You will be redirected to the Microsoft 365 login portal. Sign in with the appropriate credentials (preferably Global Administrator credentials if you wish to assign all permissions). Since this process does not take place within Exchange Reporter Plus, the credentials entered will not be stored in the product database.
5. Click Accept. You will be redirected to the Exchange Reporter Plus console, where you can see the Update Permissions text has changed to Enabled.

If you wish to configure the Entra application with only the permissions necessary for your preferred actions, you can manually modify the REST API permissions assigned to your application, using the minimum scope page as a reference.

Step 2: Remove your configured service account

Once your Entra app permissions are updated, you can remove the configured service account without impacting Exchange Reporter Plus' availability and functionality. You can remove it by following the steps mentioned below:

1. Navigate to Org/Tenant Settings.
2. Click the edit icon next to the Microsoft 365 tenant for which you are removing the service account.
3. Click Remove service account and select Yes.

Verification

1. To confirm the service account is no longer listed, click the edit icon next to the Microsoft 365 tenant you are removing the service account for and verify if the service account has been removed.
2. Test any actions that depend on the configured permissions for the Entra application. If they do not work as expected, review and reconfigure the required app permissions.