If you use portal integration and the portal does not support certain Application Workspace features, we recommend you contact the support department of the portal.
Configure Entra ID for Your Portal Integration
To take full advantage of the integration between the portal of your choice and Application Workspace, you need to permit the portal to impersonate a user for Application Workspace. This will ensure the Application Workspace widget will be available within the portal.
Prerequisites
Application Workspace needs to use an Entra ID identity source that must have the Token Exchange authentication method enabled.
If the user_impersonation permission is not available
If the user impersonation permission is unavailable, it is likely caused by an app registration created while using the preview version of the Azure Portal.
To make the user impersonation permission available in the app registration:
1. Log into https://portal.azure.com.
2. Navigate to Microsoft Entra ID.
3. On the App registrations page, under Manage, click App registrations and select the app registration of the portal you want to give access to Application Workspace.
4. On the App registrations page, under Manage, click Expose an API.
NOTE: Record the Application ID URI, as you will need it later in Application Workspace.
5. Click Add a scope.
6. In the Add a scope window that opens, fill in the following information:
- Scope name - user_impersonation
- Who can consent - Admins and users
- Admin consent display name - Access Application Workspace
- Admin consent description - Allow the application to access on behalf of the signed-in user
- User consent display name - Access Application Workspace
- User consent description - Allow the application to access Application Workspace on your behalf
- State - Enabled
7. Click Add scope.
Grant the User Impersonation Permission in Entra ID
To allow Azure AD to issue an exchange token, which is needed for user impersonation, you need to add or confirm a Delegated permission to the app registration.
To add the user impersonation permission:
1. Log into https://portal.azure.com.
2. Navigate to Microsoft Entra ID.
3. Navigate to Manage > App registrations and select the app registration of the portal you want to give access to Application Workspace.
4. On the App registrations page, under Manage, click API Permissions.
5. Select Add a permission and open the APIs my organization uses tab.
6. Add the following Delegated permission: user_impersonation

7. Click Grant admin consent for [Tenant Name] and confirm the selection.
NOTE: It can take up to an hour before these settings take effect in Microsoft Entra ID (Azure AD).
For more information about granting API permissions in Azure Portal, see Microsoft documentation.
Add the Application ID URI in Application Workspace
To add the Application ID URI in Application Workspace:
1. In Application Workspace, navigate to Manage > Authentication > Identity Sources.
2. Open the Microsoft Entra ID (Azure AD) identity source you configured for this integration.
3. Navigate to Authentication > Token Exchange and add the Application ID URI you recorded on the App registrations page in the Azure Portal.
Configure Security Settings for the Portal Integration
Content Security Policy (CSP) and/or Cross-Origin Resource Sharing (CORS) are enabled by default.
To let Application Workspace communicate with Microsoft Teams:
1. In Application Workspace, navigate to Manage > Portal > Security Settings.
2. Add https://workspace-apps.recastsoftware.com to the Content Security Policy (CSP) and/or Cross-Origin Resource Sharing (CORS) options.