Skip to main content
Skip table of contents

Native USB Redirection for Citrix Sessions in IGEL OS

USB devices can be permitted or prohibited during a Citrix session on the basis of rules. Sub-rules for specific devices or device classes are also possible. The use of rules is described under USB Access ControlSee also How to Configure Citrix Native USB Redirection

An overview and best-practice recommendations for the use of webcams can be found under Webcam Redirection and Optimization in IGEL OS.


Menu path: Sessions > Citrix > Citrix Global > Native USB Redirection

Native USB redirection

  • Native USB redirection is enabled globally.
  • Native USB redirection is disabled. (Default)  

Enable either native USB redirection or Fabulatech USB redirection, but not both together.

Disable USB redirection if you use DriveLock. Further information can be found under Using DriveLock with IGEL Devices.

Default rule

This rule will apply if no special rule was configured for a class or a device.

  • Deny (Default)

  • Allow

Tip

To secure your endpoint, it is generally recommended to set Default rule to Deny and to configure Allow rules only for the required USB devices and USB device classes. 

Class Rules

Class rules apply to USB device classes and sub-classes.

To manage rules, proceed as follows:

→ Click image-20240609-210830.png to create a new entry.

→ Click image-20240609-210852.png to remove the selected entry.

→ Click image-20240609-210911.png to edit the selected entry.

→ Click image-20240609-210938.png to copy the selected entry.

Add class rule:

Rule:

  • Deny: No automatic redirect of a device

  • Allow: Automatic redirect of a device only after a session starts

  • Connect: Automatic redirect of a device when a session starts

In the case of Connect or Allow, the device is automatically redirected when it is unplugged and plugged in during a session, see https://docs.citrix.com/en-us/citrix-workspace-app-for-linux/configure-xenapp.html#usb .

Class ID: Selection list

Sub-class ID: Selection list

Name: Free text entry

Device Rules

Device rules apply to specific USB devices.

Add device rule:

Rule:

  • Deny: No automatic redirect of a device

  • Allow: Automatic redirect of a device only after a session starts

  • Connect: Automatic redirect of a device when a session starts

In the case of Connect or Allow, the device is automatically redirected when it is unplugged and plugged in during a session, see https://docs.citrix.com/en-us/citrix-workspace-app-for-linux/configure-xenapp.html#usb .

If you have problems with device redirection after the update to Citrix Workspace App 22.07 or higher, try to change the rule to Connect.

Composite USB Redirection

In IGEL OS 11.08.200 and higher, you can configure composite USB redirection which is needed for multifunctional devices that use different interfaces. Examples of such composite USB devices are dictation microphones or Bloomberg keyboards which comprise a keyboard, fingerprint reader, an audio device, USB hub, etc. 

To redirect the entire composite device to the session, only Vendor ID (vid) and Product ID (pid) must be added. 

If you need to split the composite device and redirect only the child interfaces that use a generic USB channel, you must also add filter parameters split and intf under Extra Config. For more information on composite USB redirection and sample device rules, see https://docs.citrix.com/en-us/citrix-workspace-app-for-linux/configure-xenapp.html#usb

Vendor ID: Hexadecimal manufacturer number

Product ID: Hexadecimal device number

Getting USB Device Information

To find out the Class IDSubclass IDVendor ID and Product ID of the connected USB device, you can use the System Information tool. For further information, see Using System Information Function.

System Information example:

Alternatively, you can use the command lsusb (or lsusb | grep -i [search term]) in the terminal.

Example for lsusb:

Extra Config: Allows to add split and intf parameters to split the composite USB device.
Example:
CONNECT: vid=047F pid=C039 split=1 intf=03 # Allow HID device and connect automatically.

Name: Free text entry


JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.