Skip to main content
Skip table of contents

iEmail Cloud App Registration - Entra Console with Screenshots

This guide will walk you through adding an app registration to your Microsoft Entra tenant for iEmail Cloud.

This page contains screenshots to assist with the installation steps. If you are familiar with Microsoft Entra app registrations / enterprise applications, consider using the condensed guide without screenshots instead.

You must be a Microsoft Entra administrator or global administrator to complete these steps.

1. Create the App Registration

Click here to go to the Microsoft Entra console.

In the left navigation, under Identity, select Applications > App registrations.

msedge_BJoR2v8Yov-20250409-160745.png

Select + New registration.

msedge_eSSzMKu9C3-20250409-160928.png

Complete the following:

msedge_ryBccZFEQp-20250409-161058.png
  1. Name: iEmail Cloud

  2. Supported account types:Accounts in this organizational directory only

  3. Click Register.

Configure Platforms and Redirect URIs

In the new application, in the left navigation, select Authentication.

msedge_s89Bg887jk-20250409-161244.png

Under Platform configurations, press + Add a platform.

msedge_5SujHEfNHz-20250409-162249.png

In the right-hand menu that appears, select Single-page application.

msedge_G7cNb8n97I-20250409-162255.png

Enter the following URL in the Redirect URIs field:

brk-multihub://iemail.cloud.csiinc.com

Leave the rest of the settings as they are. Press the Configure button.

tt8NTFEVHU-20250409-162347.png

Again, we will press the + Add a platform button.

LCnHTSP3OV-20250409-162358.png

In the popup, this time select Web.

msedge_DhBsn5yk7K-20250409-162405.png

Enter the following value into the Redirect URIs field:

https://iemail.cloud.csiinc.com

Then press Configure.

UWRohJem3y-20250409-162414.png

We need to add 3 more URLs each to the “Web” and “Single-page application” platforms.

On the main screen, there are small links that say “Add URI” in each platform.

msedge_8lRHOLLP10-20250409-162430.png

Add each of the following URIs into their respective platforms, one at a time.

Single-page application

  • brk-multihub://iemail-us.cloud.csiinc.com

  • brk-multihub://iemail-ca.cloud.csiinc.com

  • brk-multihub://iemail-ap.cloud.csiinc.com

Web

  • https://iemail-us.cloud.csiinc.com

  • https://iemail-ca.cloud.csiinc.com

  • https://iemail-ap.cloud.csiinc.com

When finished, press Save.

It is important to configure all of the URI endpoints. Even if you only operate iEmail Cloud out of a specific region, it may still connect through another endpoint for users who are traveling. Adding these URIs does not mean that iEmail Cloud establishes a connection through these regions, it only means that it is possible to. If your users never leave your preferred region (geographically speaking), then only that endpoint will be used.

Configure API Permissions

In the left navigation, under Manage, select API permissions.

msedge_5ryknqq277-20250409-162529.png

Click + Add a permission

msedge_CoKEUWUnha-20250409-162536.png

Select Microsoft Graph (the large tile at the top).

msedge_hPfKKaWi9e-20250409-162544.png

Select Delegated permissions.

msedge_vu8qBPozXh-20250409-162551.png

In the search box, enter: mail.read

Find the Mail.Read permission, select the checkbox next to it, then press Add permissions.

msedge_XSJOvZte4B-20250409-162612.png

On the permissions screen, verify that the screen contains User.Read and Mail.Read.

Press the Grant admin consent for <My Organization Name> button.

msedge_M8U07u7fqX-20250409-162637.png

In the popup that appears, continue through the prompts to grant consent for your organization.

This step is important – if not completed, every user of iEmail Cloud will receive a popup asking if they want to proceed. This can lead to user confusion and frustration. Completing the Admin Consent flow on this page prevents that popup from occurring for end users.

Obtain the Application (client) ID

Select the Overview option in the left nav.

msedge_tJHNyRl1jc-20250409-162652.png

Copy the Application (client) ID value.

msedge_VTYVKUutb9-20250409-162705.png

Configuring iEmail Cloud

Open iEmail Cloud (in either Read or Compose mode). In the menu, select “Setup”.

Paste the Application ID into the configuration box and press Save.

You may need to close and reopen iEmail Cloud for the changes to take effect.

(tick) Success!

Attachments should now be functional in iEmail Cloud.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.