Microsoft Sign in usage

Microsoft Sign-In Status: COMING SOON (Not Yet Available in Stable GUI)

IMPORTANT: Microsoft Sign-In integration is scheduled for inclusion in an upcoming stable GUI release. This feature is NOT currently available in the stable VoIPmonitor GUI.

If you do not see the "Enable Microsoft Sign in" option in your GUI under Settings > System configuration > Advanced, your current version does not support this feature.

If you need Microsoft Sign-In immediately, please contact VoIPmonitor support to request a development branch GUI package that includes this functionality.

Note: The configuration guide below applies to development builds and future stable releases. Do not attempt these steps unless you have a GUI version that supports Microsoft Sign-In.

Part 1: How to Register an Application in Microsoft Entra

This guide will walk you through the necessary steps to register a new application in your Microsoft Entra ID (formerly Azure Active Directory) and correctly configure it for integration with the VoIPmonitor GUI.

1. Sign in to the Microsoft Entra admin center

Open a web browser and navigate to https://entra.microsoft.com.

Sign in using an account with administrative privileges.

2. Navigate to App registrations

In the left-hand menu, go to App registrations.

3. New registration

At the top of the page, click the + New registration button.

4. Basic Application Information

Name

Enter a meaningful name for your application (e.g., "VoIPmonitor SSO").

Supported account types

Choose who can use the application. For internal use, the most common option is Accounts in this organizational directory only.

In the Redirect URI section, you need to select the platform type and URI.

Platform selection

Choose Single page application.

Redirect URIs

Enter the URL where your VoIPmonitor GUI is installed.

IMPORTANT:

• Do not include admin.php or index.php at the end.
• Do not include a trailing slash (/) at the end.

Correct format example:

https://voipmonitor.yourdomain.com

Click the Register button at the top of the page.

Part 2: How to Assign Users to the Application

After registering the application, you must assign the users who will be allowed to sign in.

1. Navigate to Users

In the left-hand menu, go to Users.

2. Assign Users

Click the + Add user.

The wizard will guide you through adding a user.

Part 3: VoIPmonitor GUI Configuration

This section requires a GUI version that supports Microsoft Sign-In (development branch or future stable release).

1. Enable Microsoft Sign-In

Navigate to Settings > System configuration.

Scroll down to the Advanced section.

Enable the option Enable Microsoft Sign in.

Fill in the Microsoft client ID and Microsoft tenant ID fields. Use the Application (client) ID and Directory (tenant) ID values from the Overview page of your app registration in Microsoft Entra.

Leave the Redirect URI for Microsoft Sign in field empty. The system will automatically detect it during the sign-in process. This field is available as a fallback in case automatic detection fails.

2. Configure Users

Navigate to Users & Audit > Users.

For each user who should use Microsoft Sign-In, edit their profile and go to the secure users tab. Fill in the Microsoft Sign In emails field with their corresponding Microsoft account email.

If you want to define a default user for Microsoft Sign-In (for users who are not explicitly mapped), edit that user's profile, go to the basic data tab, and check the Default Microsoft Sign In account option.