4.1.3.2.1. Register Application in Entra ID (Azure AD)

Registering an application in Microsoft Entra ID allows you to manage user access, configure authentication, and assign permissions. This process integrates the app with your organization's identity system, ensuring secure access and control over who can use the application.

Note: Stellar Migrator for Exchange can automatically perform the registration. You only need to provide the credentials of a user with Global Administrator rights in the server connection wizard. To learn more, click here.

Step to Register a new application in Entra ID

To register a new application in Entra ID, follow these steps:

1. Navigate to the Sign-in page of the Microsoft Entra admin center.

2. Enter your email ID and click Next.

3. Enter your password and click the Sign in button.

4. Navigate to Identity > Applications > App registrations. 

5. Click New registration. This opens the Register an application page.

6. In the Name field, enter a name for the application (e.g., App1) and leave the default settings for the other options, and click the Register button.

7. Clicking the Register button redirects you to the Application Overview page.

8. On the application page, under the Manage section, click API permissions. The API permissions page will open. 

9. On the API permissions page, click the Add a permission button.

10. Request API permissions pane opens. click APIs my organization uses.

11. Search Office 365 Exchange Online in the search box and select Office 365 Exchange Online.

12. In the Request API permissions pane, click Delegated permissions and scroll down to view the available permissions.

13. Expand User, and then select User.Read.All.

14. Click Application permissions, expand Other permissions, select full_access_as_app and then click Add permissions. 

15. Back on the API permissions page, click the Grant admin consent for< your organization name> button (once it becomes available) and then click Yes to confirm.

16. The screen will display the message "Grant consent successful," as shown below:

 

Assigning secrets in Entra ID

Add a client secret (app password) to the newly registered application in Entra ID (Azure AD) to ensure your application can authenticate successfully using the OAuth protocol.

Follow these steps to configure the authentication method:

1. Navigate to Identity > Applications > App Registrations, then select the newly added application.

2. In the navigation menu, click Certificates & secrets. Now, you need to assign either a certificate or client secret to the application.

3. To add a client secret, click Client secrets > New client secret.  Add a client secret pane opens.

4. In the Add a client secret pane, enter a short description (e.g. Migration app), select the expiration time (whichever suits your needs) from the drop-down menu, and click Add.

Note: Remember to copy the client secret value to your clipboard or use it in your application right away, as it won't be accessible after refreshing the page. If you miss it, a new client secret will need to be created.

5. Update application credentials message appears on the screen as shown below:

Locate Client ID and Tenant ID 

1.  To view the application details, click Identity > Application > App registration.

2. On the App registration page, click Owned applications and then click View all applications in the directory button. 

3. Under the All applications button, a list of applications will display. Click on the application you registered.

4. All the necessary information for the Application details step of the server connection wizard is available in Entra ID, either on the application overview page (including Application (client) ID and Directory (tenant) ID) or on the Certificates & secrets page (within the Client secrets tab).

Note: You can also view both the Application (client) ID and Directory (tenant) ID by directly navigating to the Overview tab on the application page.

5. Provide the registration details in the source and target server connection wizard in Stellar Migrator for Exchange software.