Applies to version: 2021.1.x and above; author: Piotr Piechowicz
To be able to use Graph Microsoft Toolkit components, you must first register the appropriate application in Azure Active Directory (App registrations) and create an authentication provider based on it (the msal2 version is recommended). The creation of authentication providers is described under the addresses:
To enable users to log into Microsoft Graph, a login component should be used. Below is the minimum set of privileges that must be granted to the application used by the authentication provider for the correct operation of the login component. Note - administrator's consent for the privileges (scope) is required.
After creating the provider and granting the necessary privileges, you can start implementing the Microsoft Graph Toolkit components in the WEBCON BPS Portal.
Microsoft Graph Toolkit components can be used in:
Microsoft Graph Toolkit in the form field
Using Graph Toolkit components in the HTML form field in the form requires a HTML form field, its setting requires, as follows:
In case of msal2 provider, the provider code should be the following:
<mgt-msal2-provider client-id="<KLIENT ID>"
The description of the respective form fields is available at:
In WEBCON BPS Portal the Redirect Uri address should be
and the suggested Login Type is ‘popup’.
The login component is necessary for the user to log in (it is also necessary to grant the appropriate privileges for the registered application)
Detailed description of the component configuration at Login component in the Microsoft Graph Toolkit | Microsoft Docs
The login component should be:
The list of components is available at Getting started with the Microsoft Graph Toolkit - Microsoft Graph | Microsoft Docs.
When adding a component, the application should be equipped with privileges required by the component (they are listed next to the component description on the page above). In the case of privileges that require the consent of the administrator, the consent must be obtained.
Creating the HTML form field
Exemplary HTML form field code
Using the form rule for loading the library
When saved, the user can use the GraphToolkit components on the form.
After selecting the login button, the user should be displayed a popup window in order to log in and then the user can use the remining components of the Graph Toolkit library.
Microsoft Graph Toolkit in the dashboard
The use of Graph Toolkit components in the HTML element code in the dashboard is analogical to their use in the HTML form field. However, you should take care of loading the library in the HTML code. The Graph Toolkit library in the dashboard can be used, as follows:
Exemplary code of the HTML element:
Adding the element of HTML code:
Adding the HTML code:
Login component view