Microsoft Teams Integration
Overview
Audience: administrators
Purpose: to enable Teams App integration
Note:
- presented actions, functionality and wizard are available only if a license of M42TeamsApp is enabled
- the New Look setting enabled is mandatory for the user that is using “M42 Enterprise” teams app.
Files:
- EnterpriseApp_1.0.1.zip - teams app manifest
Enterprise Service Management Platform enrollment
Initially, the Enterprise Service Management Platform needs to be enrolled to make it available for users within Microsoft Entra ID Organization.
In the Administration application, open Settings → Configure Teams Integration action.
This action will open the following wizard:
Hit the Register button. This will open the following authentication pop-up, and the user will be asked to login into Microsoft EntraID organization (the same with Teams subscription) then to consent for the M42 Enterprise app with presented permissions (only basic permissions like: email, offline_access, openid, profile, User.Read).
Important note
The user’s organization (tenant) must allow users to consent to apps.
This is controlled by user consent settings:
in Entra ID portal → Enterprise Applications → Consent and Permissions → User consent settings
Section - User consent for applications:
- select "Allow user consent for apps"
must be enabled to allow regular users to consent to delegated permissions.
Once the dialog is successfully consented to, we will get registration updates back on the wizard screen:
Enterprise Service Management Platform enrollment is completed, and the wizard can be closed with the Close button.
Now the Enterprise Service Management Platform URL should be available in the proposed list presented in the next step.
Installation of “M42 Enterprise” teams app
Install for individual user
Prepare and have available the “EnterpriseApp_1.0.1.zip ” teams app (manifest) file.
Login into Teams App (web or desktop application) and navigate to Apps – Manage your apps area.
Make sure in EntraID organization, in App setup policies section, "Upload custom apps" and "User pinning" settings are enabled - https://admin.teams.microsoft.com/policies/app-setup
Click on the Upload an app button.
Then click on the Upload a custom app button.
And select EnterpriseApp.zip manifest file prepared earlier.
Continue by pressing confirming consent screens and [Add] button.
At the end click on the [Open] button.
If the step 1 “Enterprise Application enrollment” was never performed the users will see this informational screen.
Where users can refresh for available Enterprise Application by pressing [Refresh] button.
If there is only one Enterprise Application enrolled into the organization, the user will be redirected to this one.
If there are multiple Enterprise Applications available, the user will be prompted to choose one in the presented list:
Next time, when the user comes back on M42 Enterprise Teams App, the last selected Enterprise Application will be remembered and opened.
Switching between multiple Enterprise Applications.
If the user wants to switch to another Enterprise Application environment (eg. Staging, demo), he can press the [Switch Host] action, available in the user profile menu.
This action will lead the user back to the selection of one of the available Enterprise Applications.
Install for multiple users
In order to make the application available to everyone in the organization an admin user can upload it to admin.teams.microsoft.com by going to Teams Apps → Manage Apps, selecting Upload new app from the Actions menu and uploading the zip file.
After the upload the policies need to be defined to include the app by going to Teams Apps → Setup policies and either modify an existing policy or create a new one.
Here the Enterprise app can be added in the Installed apps section.
Last step is to go to Users → Manage Users and apply the previous policy for the users. These changes might take some time to take effect.
Test installation
Click and navigate in M42 Enterprise Teams App, navigation and operation as in the original web application.
Switching to another Teams tab (eg. Chat), and then activate back the M42 Enterprise Teams App, should open the last selected “Enterprise Application” (host).
Users can always pin the M42 Enterprise Application to the side an make it more accessible.
Unregister Enterprise Service Management Platform
If the administrator wants to remove one of the Enterprise Application from the list, he can [Unregister] the application from the same [Configure Teams Integration] action/wizard.
The user might be prompted to re-authenticate and confirm, then the wizard will end with confirmation message:
We can now close this wizard by pressing [Close] button.
The list with available Enterprise Application should not contain the unregistered one.
