Deploy the VFC Recording Controls Application

Prepare the VFC Recording Controls Application Bundle

Please refer to, where you will find the partially completed manifest.json file to modify, save, recompress and upload to Teams environment.

This bundle vmr-shell<build-number>.zip file, contains manifest.json file and two icon files.   Edit the manifest.json file of this bundle as following:

Step 1 - Replace {{teams-app-id}} with the App ID of the Teams app created above.

Step 2-  Replace all instances of {{verba-base-url}} with the Verba server’s base URL


App ID example
  "$schema": "",
  "version": "1.0.0",
  "manifestVersion": "1.14",
  "id": "150a0b12-9475-4b4f-8928-aef33d7d401e",
  "packageName": "",
  "name": {
"staticTabs": [
            "entityId": "index",
            "name": "Recording Tab",
            "scopes": [

Step 3Replace {{verba-server-domain}} with the Verba server’s domain name


Domain Name Example
"validDomains": [

Step 4 - Replace all instances of {{azure-app-id}} with "Application (client) ID" of the Microsoft Entra (formerly Azure AD) Application created above.


Azure App ID Example
"webApplicationInfo": {

         "id": "3ebcfff6-0b0b-4d8b-91d4-9b2a292c529e",
         "resource": "api://"

Upload the VFC Recording Controls Application Bundle

Step 1 - Login to MS Teams Admin Portal

Step 2 - Go to Teams / Manage app and choose “Upload new app”, and upload the app bundle prepared above.

Validate the VFC Recording Controls Application Bundle

Navigate to Microsoft Teams - App Validator and upload the application bundle. Ensure that:

  • All files are at the root of the .zip file and not within a subdirectory.
  • All domain names are the same, they cannot be mixed.
  • The color icon is 192 x 192 pixels in size
  • The outline icon is 32 x 32 pixels in size.

For the latest requirements, please see Package your app - Teams.

Configure the Verba Server for the VFC Recording Controls Application 

Step 1 - The app only works over HTTPS protocol (with a public CA certificate), so make sure that is enabled in the Tomcat configuration. Instructions for this can be found here: Installing an SSL certificate for HTTPS access

Step 2 - The app application must use the following cookie settings: SameSite: none.

To achieve that open this file


Change the "CookieProcessor" tag "sameSiteCookies"  attribute value from "lax" to "none".

<CookieProcessor sameSiteCookies="none" />

Step 3 - Restart the web application service.

Link Users on the Verba Server

Step 1 - Import users with "Microsoft Entra ID (formerly Azure AD) sync" Active Directory synchronization

Step 2 - Setup an "Identity Provider" with the same Microsoft Entra application as it was created above Identity providers

Step 3Associate the newly created "Identity Provider" with Verba users. The quickest way is to associate the "Identity Provider" with “Standard User” role in Verba