Citrix Workspace app for Windows

Citrix Workspace app for Windows

Citrix Product Documentation |

May 2, 2023

Citrix Workspace app for Windows

Contents

About this release

3

System requirements and compatibility

80

Install and Uninstall

84

Deploy

97

Update

104

Get started

117

Configure

124

Configuring Single signon to Workspace app

234

Client App Management

237

Authenticate

250

Domain passthrough access matrix

269

Domain passthrough to Citrix Workspace using onpremises Citrix Gateway as the iden

tity provider

276

Domain passthrough to Citrix Workspace using Azure Active Directory as the identity

provider

291

Domain passthrough to Citrix Workspace using Okta as identity provider

295

Secure communications

297

Storebrowse

312

Storebrowse for Workspace

321

Citrix Workspace app Desktop Lock

323

Software Development Kit (SDK) and API

328

ICA Settings Reference

330

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

2

Citrix Workspace app for Windows

About this release

May 2, 2023

What's new in 2303

Client App Management for WebEx plugin [Technical Preview] Download, install, and autoupdate of the WebEx plugin is supported and handled the same way as Zoom plugins. For more information on how to enable this feature, see Client App Management for WebEx plugin.

Note: Technical previews are available for customers to test in their nonproduction or limited produc tion environments, and to give customers an opportunity to share feedback. Citrix does not ac cept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren't deployed in production environments. You can provide feedback on this feature via the Podio form.

Configure path for Browser Content Redirection overlay Browser temp data storage Starting with Citrix Workspace app 2303 version, you are requested to configure temp data storage path for Chromium Embedded Framework (CEF) based browser. For more information, see Configure path for Browser Content Redirection overlay Browser temp data storage.

Support for modern authentication methods for StoreFront stores Citrix Workspace app 2303 for Windows support modern authentication methods for StoreFront stores. You can authenticate to Citrix StoreFront stores using any of the following ways:

? Using Windows Hello and FIDO2 security keys. For more information, see Other ways to authen ticate.

? Single signon to Citrix StoreFront stores from Azure Active Directory (AAD) joined machines with AAD as the identity provider. For more information, see Other ways to authenticate.

? Workspace administrators can configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix StoreFront stores. For more information, see Support for Conditional access with Azure AD.

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

3

Citrix Workspace app for Windows

To enable this feature, you must use Microsoft Edge WebView2 as the underlying browser for direct StoreFront and gateway authentication.

Note: Ensure that the Microsoft Edge WebView2 Runtime version is 102 or later.

You can enable modern authentication methods for StoreFront stores using the GPO template. For more information, see Support for modern authentication methods for StoreFront stores section.

Improved experience for optimized Microsoft Teams video conference calls

Starting with this release, by default simulcast support is enabled for optimized Microsoft Teams video conference calls. With this support, the quality and experience of video conference calls across differ ent endpoints are improved by adapting to the proper resolution for the best call experience for all callers. With this improved experience, each user might deliver multiple video streams in different resolutions (for example, 720p, 360p, and so on) depending on several factors including endpoint capability, net work conditions, and so on The receiving endpoint then requests the maximum quality resolution that it can handle thereby giving all users the optimum video experience.

Note: This feature is available only after the rollout of an update from Microsoft Teams. For informa tion on ETA, go to and search for Microsoft 365 roadmap. When the update is rolledout by Mi crosoft, you can check CTX253754 for the documentation update and the announcement.

Enhancement to App Protection: AntiDLL Injection

As part of App Protection, we now have a security enhancement that helps to protect the Citrix Workspace app from certain unauthorized dynamiclink libraries (DLL) or untrusted modules. If such untrusted modules are injected, the Citrix Workspace app detects these interventions and stops the modules from loading. The antiDLL injection can be enabled for the following components:

? Citrix Auth Manager ? Citrix Workspace app UI ? Citrix Virtual Apps and Desktops For more information, see the App Protection documentation. Disclaimer: This capability works by filtering access to required functions of the underlying operating system

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

4

Citrix Workspace app for Windows

(specific API calls required to load DLLs). Doing so means that it can provide protection even against certain custom and purposebuilt hacker tools. However, as operating systems evolve, new ways of loading DLLs can emerge. While we continue to identify and address them, we can not guarantee full protection in specific configurations and deployments.

Citrix Enterprise Browser

This release includes Citrix Enterprise Browser version 109.1.1.29, based on Chromium version 109. For more information about the Citrix Enterprise Browser, see the Citrix Enterprise Browser documen tation.

Secure Private Access support for StoreFront

As an administrator, you can now configure Web and SaaS apps in StoreFront using a Secure Private Access solution. After the administrator configures the app, end users can open the Web and SaaS apps using Citrix Enterprise Browser with enhanced security.

For more information, see Secure Private Access for onpremises in the Citrix Secure Private Access documentation.

Fixed issues in 2303

? The published URLs open through the Citrix Enterprise Browser instead of the device's default browser. [CTXBR4718]

? You might experience delay in enumerating apps and starting apps or desktops when using SSON in an environment that has no active access to external sites. This issue occurs from the Citrix Workspace app version 2210.5 onwards and from the Citrix Workspace app version 2203 CU2 onwards. [CVADHELP21786]

? The wfica32.exe process might stop unexpectedly and get an error when you open an app from the Citrix Workspace. This issue occurs only when you have the adaptive audio feature enabled. [CVADHELP20999]

? When you install Citrix Workspace app 2212 on remote machines using a PowerShell script, the Citrix Workspace app installer might stop. This issue occurs before the installation begins on the remote machine. [CVADHELP22278]

? When you attempt to configure multiple stores through a Group Policy Object (GPO) or com mand line, one of the stores might not be fully configured. [CVADHELP22034]

? The screen might display the authentication popup window on the upper left corner instead of displaying on the center. [CVADHELP21835]

? After a store is added with the store authentication token set to true, Citrix Workspace might become unresponsive at the white screen and the store authentication token is set to false. [ CVADHELP21582]

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

5

Citrix Workspace app for Windows

? Attempts to access Citrix Workspace app for Windows might fail when the VPN disconnects or reconnects. [CVADHELP21662]

? When you share a screen using Microsoft Teams from the HP EliteBook G6 endpoints, you might see a red window instead of a red border. [CVADHELP20763]

? You might not be able to use the Bloomberg Terminal application with the Bloomberg Keyboard 5 or Bloomberg Keyboard 2013. This issue occurs when Citrix Workspace app version 2302 is installed on your system with the App Protection feature enabled. [CVADHELP22221]

? The position of the window and size might not be persistent when you reconnect the desktop. This issue occurs when the desktop is in a window mode and using a nonprimary monitor. [HDX 44997]

? Desktop Viewer toolbar might cover the screen when the desktop is in normal resolution and DPI. [HDX45206]

? In a multisession scenario, when you open a second session, the session might be hidden be hind the first session. Also, the Citrix Workspace app icon for the second session might not be present on the taskbar. [RFWIN29773]

Known issues in 2303

? The Citrix Workspace app might stop responding if you have any mouse interaction (mouse action or movements) on the Restore session dialog box. This issue occurs when you start a session after upgrading from the Citrix Workspace app version 2302 to 2303 and if there are disconnected sessions previously. [RFWIN29663]

Note: For a complete list of issues in the earlier releases, see Known issues.

Earlier releases

This section provides information about the new features and fixed issues in the previous releases that we support as per the Lifecycle Milestones for Citrix Workspace app.

2302

What's new

Improved virtual apps and desktops reconnection experience This release provides an enhanced user experience while reconnecting to virtual apps and desktops from which you got disconnected. When Citrix Workspace app attempts to refresh the disconnected Citrix Workspace app or start new virtual apps or desktops as a part of the Workspace Control feature, the following prompt appears:

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

6

Citrix Workspace app for Windows

This prompt appears only when the show reconnection prompt to reconnect sessions is set to true in the Global App Configuration service. Click Restore to reconnect to open new and disconnected virtual apps and desktops. If you want to start only newly selected apps and desktops, click Cancel. You can also select Remember my preference to apply the selected preference for the next login. The preceding new Restore session? prompt appears only if:

? the user tries to start an app belonging to a workspace store, ? admin policies or app config settings are not configured for the Workspace Control feature, ? Workspace Control Reconnect options are set to default on the client. Note: Reconnect settings in the Reconnect Options takes precedence over the preferences set in the dialog box. For more information, see Configure reconnect options using Advanced Preferences dialog.

Client App Management for Zoom plugin You can now manage the Zoom plugin using Client App Management capability.

Note: This feature is applicable to Workspace (cloud) sessions only.

For more information, see Client App Management for Zoom plugin.

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

7

Citrix Workspace app for Windows

Support for modern authentication methods for StoreFront stores [Technical Preview] Starting with this release, Citrix Workspace app for Windows support modern authentication methods for StoreFront stores. You can authenticate to Citrix StoreFront stores using any of the following ways:

? Using Windows Hello and FIDO2 security keys. For more information, see Other ways to authen ticate.

? Single signon to Citrix StoreFront stores from Azure Active Directory (AAD) joined machines with AAD as the identity provider. For more information, see Other ways to authenticate.

? Workspace administrators can configure and enforce Azure Active Directory conditional access policies for users authenticating to Citrix StoreFront stores. For more information, see Support for Conditional access with Azure AD.

To enable this feature, you must use Microsoft Edge WebView2 as the underlying browser for direct StoreFront and gateway authentication.

Note: Ensure that the Microsoft Edge WebView2 Runtime version is 102 or later.

You can enable modern authentication methods for StoreFront stores using the GPO template. For more information, see Support for modern authentication methods for StoreFront stores section.

Note: Technical previews are available for customers to test in their nonproduction or limited produc tion environments, and to give customers an opportunity to share feedback. Citrix does not ac cept support cases for feature previews but welcomes feedback for improving them. Citrix might or might not act on feedback based on its severity, criticality, and importance. It is advised that Beta builds aren't deployed in production environments.

You can provide feedback on this feature via the Podio form.

Updated audio device selection behavior for optimized Microsoft Teams Starting with this release, when you change the default audio devices in the sound settings on the endpoint, the optimized Microsoft Teams in the Citrix VDI changes the current audio devices selection to match the endpoint defaults. However, if you make an explicit device selection in Microsoft Teams, your selection takes precedence and does not follow the endpoint defaults. Your selection is persistent until you clear the Microsoft Teams cache.

App Protection enhancement

? 1999?2023 Cloud Software Group, Inc. All rights reserved.

8

 ................
................

In order to avoid copyright disputes, this page is only a partial summary.

Google Online Preview   Download