Learn 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. Navigate to Manage > App registrations.
4. Click New registration.
5. In the Register an application window that opens:
- Give your app a descriptive name. In our example, we use Application Workspace Teams App.
- As the Supported account type, select 'Accounts in this organizational directory only (tenant only - Single tenant)'.
6. Click Register to complete the initial app registration.
7. Make a note of the Application (client) ID, as you'll need it later, for the Microsoft Entra app manifest generator.
Download the Microsoft Teams App Manifest Files
To download the Teams app manifest files:
1. Navigate to the Application Workspace Download page.
2. Enter the necessary details:
- Workspace URL -
<RECASTSOFTWARE-URL> - App registration identifier - The Application (client) ID you noted down earlier
- User impersonation scope -
<RECASTSOFTWARE-Scope>
3. Click Generate. Application Workspace will generate a zip archive containing 2 .JSON files.
4. After the download finishes, 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
To add the 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 Application Workspace 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
