How to Configure Microsoft Teams on IGEL OS

This article describes the installation of Microsoft Teams on IGEL OS 12. You can install MS Teams on IGEL OS as a standalone PWA (progressive web app). If you require SSO, it is currently necessary to install MS Teams as a generic PWA.

How to Configure a Standalone Microsoft Teams Progressive Web App

A standalone MS Teams PWA runs in a standalone Chromium window and has its own Chromium Browser profile. Therefore, it can be launched separately.

Limitations

• Each standalone PWA has its own Chromium Browser profile and therefore, the user has to log in to each PWA.

• Single sign-on (SSO) is not supported for a standalone MS Teams PWA.

• MS Teams is not supported by devices with limited support, see Limited Device Support for Legacy Devices and Special Use Cases with IGEL OS 12.

Requirements

• The app “Microsoft Teams Progressive Web App” is imported to your UMS. For details on app import, see How to Import IGEL OS Apps from the IGEL App Portal.
  

  

  
  

• A valid Microsoft 365 account with access to MS Teams

Dependencies

• If Chromium Browser has not been installed beforehand, it will automatically be installed during the app installation.

Installation and Configuration

1. In the IGEL UMS, create a profile configuring Microsoft Teams Progressive Web App. For details on profile creation, see How to Create and Assign Profiles in the IGEL UMS Web App.
   

2. In the Profile Configurator, go to Apps > MS Teams PWA > MS Teams PWA Session and configure the starting methods for the app. The starting methods parameters are described under Starting Methods for Apps.
   

   

   
   

3. Under Apps > MS Teams PWA > MS Teams PWA Global, configure the following:
   

   

   
   
   Clear data

   Removes all persistent data such as login credentials and Cookies each time the app is closed or the user logs out from the device.
   

4. Save the profile and assign it to the required devices / device directories. For details on profile assignment, see How to Create and Assign Profiles in the IGEL UMS Web App.
   

5. On the IGEL OS device, you may need to accept EULA for the app(s) to be downloaded.
   

   

   
   

6. After the app(s) download is complete, reboot the device.

   

   
   After the installation is complete, you can open the app and sign in.

   

   
   

   

   
   

How to Configure Microsoft Teams as a Generic Progressive Web App

This is how you can install MS Teams as a generic Progressive Web App (PWA) on IGEL OS 12.

Limitations

• If you have already apps installed as generic PWA, they will be shortly unavailable during the installation of a new generic PWA.

Requirements

• The app “Progressive Web App” is imported to your UMS. For details on app import, see How to Import IGEL OS Apps from the IGEL App Portal.
  

  

  
  

• You know the manifest_id of your Progressive Web App. You can retrieve it by installing the PWA on any device, no matter which OS, by entering chrome://web-app-internals in the browser and scrolling to the entry manifest_id of the app in question. For this purpose, you can use Chrome, Chromium, Edge, or any other Chrome-based web browser; you may have to replace chrome with the actual browser name, e.g.edge://web-app-internals. Please note that Progressive Web Apps on IGEL OS always use Chromium.
  

  

  
  

• A valid Microsoft 365 account with access to MS Teams

Dependencies

• If Chromium Browser has not been installed beforehand, it will automatically be installed during the app installation.

Installation and Configuration

1. In the IGEL UMS, create a profile configuring Progressive Web App. For details on profile creation, see How to Create and Assign Profiles in the IGEL UMS Web App.
   

2. In the Profile Configurator, go to Apps > Progressive Web App > Sessions and click + to add a new session.
   

   

   
   

3. Enter a Session name, for instance, “MS Teams”.

   
   

   

   
   

4. Go to Settings and enter the Progressive Web App Url. This is the manifest_id you discovered via chrome://web-app-internals. For MS Teams, the correct value is https://teams.cloud.microsoft/?clientType=pwa

   
   

   

   
   

5. Optional: If you want to use an alternative icon, enter the path to the image file under Progressive Web App Icon (optional). This will override any auto-detected icons coming from the PWA itself.
   For how to add files, see Upload and Assign Files in the IGEL UMS Web App.
   

6. Optional: If PWA should run in a more restricted window, activate Enable App Mode. If activated, you can configure the registry key app.pwa.sessions.pwa%.force_app_mode to restrict shortcuts and force the user to one single window.
   

7. Optional: Go to Apps > Progressive Web App > Global and enable Clear data.
   

   

   
   
   Clear data
   Removes all profile-related data of Progressive Web App (e.g. login credentials, cookies) each time the app is closed or the user logs out from the device or restarts it. This will influence all apps installed as a generic PWA.
   

8. Save the profile and assign it to the required devices / device directories. For details on profile assignment, see How to Create and Assign Profiles in the IGEL UMS Web App.

   
   

9. After the app download is complete, reboot the device.
   

   

   
   

10. On the device, a message window informs the user that Progressive Web App is being installed. Note that the user has to be logged in to the device for this step.
    

    

11. After the installation is complete, you can open the app and sign in.
    

    

Troubleshooting: Reinstalling the App If Something Went Wrong

If the Progressive Web App does not work as expected, e.g. the starter icon does not appear, it is recommended to reinstall it.

To reinstall a PWA:

1. Start the PWA (or any other PWA).
   

2. While the PWA window is open, remove the session.
   

   

   
   

3. Wait for about 1 minute.
   

4. Install the PWA again as described above.