Change of the authentication provider from Windows Active Directory to Microsoft Entra ID

Applies to version: 2025 R1 and above; authors: Pawe Fijał, Krystyna Gawryał

Related documentation

A detailed description of the functionalities mentioned herein and their configuration can be found in the following sections of the WEBCON BPS Help:

• Authentication providers | WEBCON BPS

Introduction

WEBCON BPS allows for selecting an Authentication provider and sometimes there may be a situation in which it will be necessary to change the already established provider from Windows Active Directory (hereinafter referred to as AD) to Microsoft Entra ID. You can change the provider for both Designer Studio and Portal, but in the case of Designer Studio it is recommended to leave AD. WEBCON BPS enables to use several authentication providers at the same time. However, this article describes the change from AD to Microsoft Entra ID, leaving AD authentication for Designer Studio according to the recommendations.

Before making any changes to the configuration, you need to create a dedicated authentication application in the Azure Portal. This procedure is described in the article: Integration of WEBCON BPS with Microsoft Entra ID.

Change of the authentication provider in Designer Studio

In the system configuration, expand the Authentication providers node where various providers are visible. Click on Windows Active Directory ① and uncheck Active in BPS Portal ②.
 

After clicking Save ③ a message will appear asking you to restart WEBCON BPS Portal. Confirm with OK.
 

Then, go to Microsoft Entra ID provider ① and check the box Active in BPS Portal ② and, if necessary, Active in Designer Studio ③. Fill in the details of the application created in Azure and click Save ④.
 

Again a message will appear that WEBCON BPS Portal must be restarted.

To apply the changes, open the IIS Manager (Control Panel → System and Security → Administrative Tools → Internet Information Service (IIS) Manager), then in Application Pools ① select WEBCONBPS ② and click Recycle ③.

Change of the authentication provider via WEBCON BPS Installer 

Changing the authentication provider using the installer is a fallback option in case you accidentally deactivate providers in WEBCON BPS Designer Studio. The installer does not distinguish authentication for Designer Studio and Portal, so changes made in the installer will apply to both.

After running the WEBCON BPS installer and accepting the license agreement, select Tools for application management.
 

From the menu on the left, select Authentication providers, then clear the Windows Active Directory checkbox ① and check that next to Microsoft Entra ID ②, then click Save ③.
 

After saving the changes, restart the application pool (IIS Manager → Application Pools → WEBCONBPS → Recycle).