Citrix Workspace app for HTML5 2001 - Tech Preview

What’s new

Support for USB device redirection

This release supports generic USB device redirection on Chrome (Version 61 and later) browser running on Chrome and Mac operating systems. This feature is supported on sessions launched over secure connections. For more information, see USB device redirection.

USB device redirection

Generic USB device redirection is supported on Chrome browsers (Version 61 and later) running on Chrome and Mac operating systems. This feature is supported on sessions launched over secure connections.

  1. Redirecting a USB device As a prerequisite, enable the USB redirection policy on the server. For more information, see Enabling USB redirection on the server.

  2. Connect the USB device to the machine.

  3. Click on the USB Devices icon available on the in-session toolbar.

    Toolbar

  4. In the USB Devices dialog box, click on Add.

    Add USB

    This action opens a Chrome dialog box that displays a list of devices. Note that you cannot redirect all the devices.

  5. Select devices to be redirected and then click on Connect. After successful redirection, you are returned to the USB Devices dialog box, and the device appears as Connected.

    Although there are multiple USB devices, only the devices that the Citrix HTML5 client can redirect appear in the Citrix USB Devices dialog box. Those devices can be used inside a remote session.

    Connect

  6. Click Release to release a device from the remote session.

    Release

The USB device redirection feature is applicable only to USB devices for which the client operating systems (such as Mac and Chrome) does not load the device drivers by default. For example, the feature is applicable to Brother QL-580N Label Printer.

Enabling USB redirection on the server

Perform the following step to enable the USB device redirection on the server:

  • Enable the policy for USB device redirection on the Domain Controller.

    Enabling USB

Configuring USB redirection for Citrix HTML5 client

By default, the USB device redirection feature is enabled on the client if the USB device redirection policy is enabled on the server.

To disable it, edit the configuration.js file and set the value of usb under toolbar to false. The configuration.js file is located in C:\program Files\Citrixactual path\HTML5Client.

    'ui' : {
        'toolbar' : {
                'usb' : false
        },
    }
Behavior of Chrome browser
  • When you click on the padlock icon, the browser tab shows the Secure Connection dialog box. You can see the USB devices for which the browser tab has received user permission. Although there are multiple USB devices, only the devices that the Citrix HTML5 client can redirect appear in the Citrix USB Devices dialog box. Those devices can be used inside a remote session.

    Connection Secure

  • If you want to revoke access permissions granted to the browser tab, click on the x icon next to the USB device. As a result, the Reload button appears. If you click on Reload, the session closes. Relaunch the session for the changes to take effect.

    Reload

Limitations:

  • The USB device redirection feature is not applicable to some USB devices for which the client operating system such as Windows loads the device drivers by default.

  • Only USB Type A devices can be redirected to the session. But, you can connect Type A devices through a Type C connector.

  • Releasing a USB hub device might not result in releasing connected USB Type A devices.

  • Scanners, HID devices, and Web camera redirection might not work.

  • This feature has been tested and is supported on VDAs running on Windows 10.

  • This feature supports only the user interface translations in the English language.

Fixed issues

This release addresses a number of issues that help to improve overall performance and stability.

Known issues

No new issues have been observed in this release.

Citrix Workspace app for HTML5 2001 - Tech Preview