Manual configuration of Application Workspace for Microsoft Teams

Register the Application Workspace application in Microsoft Entra ID (Azure AD)

This article provides information about how to register Application Workspace in the Azure Portal, where you can find the Microsoft Teams app manifest files, how to download them and all the settings you need to configure to integrate Application Workspace in Microsoft Teams.

Prerequisites

Have an active Microsoft Entra ID app registration that is used to authenticate to Application Workspace.
Write down the URL where Application Workspace is accessible as you will need it during the configuration process. This value is indicated as <RECASTSOFTWARE-URL> in this document.

Configure API permissions on the Application Workspace Entra ID app registration

To allow the Teams application to authenticate users, the exchange token should be configured for Application Workspace. Read How to set up your exchange token for more information. Copy the scope from your app registration. This value is indicated as <RECASTSOFTWARE-Scope> in this document.

Register a new application in the Azure Portal

For the Teams app to authenticate to Application Workspace, you'll need to set up a new app registration in Microsoft Entra ID.

To set up a new app registration:

1. Log into the Azure Portal.
2. Navigate to Microsoft Entra ID.

3. In the left pane, navigate to Manage > App registrations.

4. Click on + New registration on the top toolbar.
5. In the Register an application window that opens, configure the following:
   • Give your app a descriptive name. In our example, we use Application Workspace Teams App.            
   • In the Supported account types section, select 'Accounts in this organizational directory only (tenant only - Single tenant)'. For more information about the supported account types, see Microsoft documentation .

6. Click Register on the bottom left, to complete the initial app registration.
7. After registering the new application, make a note of the Application (client) ID from the overview menu option. It will be necessary later, for the Microsoft Entra app manifest generator. We will use < RECASTSOFTWARE-MST-App-ID> to reference this value.

Download the Microsoft Teams app manifest files

To download the Teams app manifest files:

1. Navigate to the Application Workspace Download page.
2. Fill in the fields:

3. When you finish, click Generate.
4. It will generate a zip archive containing 2 .JSON files. After the download is finished, extract the zip file into a directory. You will need these Microsoft Teams app manifest files for the next step.

Add the Application Workspace app manifest to Entra ID

1. In the Azure Portal, open the Recast Teams App, you previously registered.
2. Navigate to Manage > Manifest, and upload the appreg_1.json and for appreg_2.json files.

Publish the application to Microsoft Teams

To publish the application to Teams:

1. Open the Microsoft Teams administrator centre and go to Teams apps > Manage apps.
2. Click on the Actions dropdown menu > Upload new app.
3. Select the package.zip in the extracted bundle directory. See Download the Microsoft Teams app manifest files section, step 4.

NOTE: It can take some time before the app shows up in Microsoft Teams.

Set up CORS and CSP in Application Workspace

For the Microsoft Teams app to communicate with Application Workspace, you must configure CORS.

1. In Application Workspace, navigate to Manage > Portal > Security Settings > Content Security Policy.
2. Add the following link to the list of allowed websites:

https://workspace-apps.recastsoftware.com