Follow these steps to set up Application Workspace for Microsoft Teams with Entra ID. You'll configure the wizard, deploy the app bundle, and pin it for your users.
For a video walkthrough of the workflow, see How to set up the Microsoft Teams integration in Application Workspace on the Recast YouTube channel.
Prerequisites
- Microsoft Entra ID set up as an identity source
- Token exchange enabled on your identity source - to have Application Workspace for Microsoft Teams authenticate your users
Initiate the configuration wizard
To initiate the configuration wizard:
1. Open the Entra ID identity source and navigate to the Microsoft Teams tab.
2. Click Set up the Microsoft Teams app.
3. Sign into the Azure Portal (if you are not already signed in). The account you use to sign in should be able to provide administrative consent on Azure App registrations. If the account you are currently signed in with does not have these privileges, choose Sign in with another account.
4. In the Deploy the Application Workspace for Microsoft Team app window that opens, enter and choose the necessary details:
Identity Source type
- Name – Enter a display name for Application Workspace.
- Supported account types – Select an account type that corresponds with your Application Workspace app registration. This allows you to control the type of accounts that are allowed to log into the Teams app. If you need to provide access to external accounts, you might need to change these settings.
- App availability – Besides integrating with Microsoft Teams, the app can also be integrated within the Office 365 portal and with Microsoft Outlook. To ensure users are able to log in via these channels, additional permissions need to be granted for these channels.
If no popup opens, a popup blocker might be preventing the window from opening.
Deploy the app
1. On the Success screen that appears after clicking Deploy, select Click here to generate your bundle to generate the Microsoft Teams app bundle as a .zip file.
3. In the upper right corner, click Actions > Upload new app.
4. Click Upload and add the zip file you downloaded previously.
After the upload finishes, you'll see a New app added message. This step enables the application for both the Microsoft 365 portal and the Outlook app, if configured in the previous step. The application should now be available within the Microsoft Teams store.
Set Up Entra ID for Application Workspace
To set up Entra ID for Application Workspace:
1. In the Entra ID app registration used for the identity source and SSO to Application Workspace, expose an API for token exchange.
2. Add the Application ID URI for the Entra ID app registration to the Application Workspace identity source.
3. If you use CSP or CORSm, allow the following domain: https://workspace-apps.recastsoftware.com.
For instructions, see How to set up your exchange token.
Security Settings
Content Security Policy (CSP) and/or Cross-Origin Resource Sharing are enabled by default.
To allow Application Workspace communicate with Microsoft Teams, add https://workspace-apps.recastsoftware.com to both configuration options.
Pin the app for your users (optional)
To pin the app in Teams:
1. Navigate to https://admin.teams.microsoft.com/policies/app-setup/, which displays all the policies that apply to Microsoft Teams apps within your tenant.
2. Select the policy to use to pin the app.
