Skip to main content
Skip table of contents

IGEL Advanced Device Redirection USB

The IGEL Advanced Device Redirection apps support the integration of endpoint devices with on premises or cloud-hosted desktops in virtual workplace setups. You can use the app in configurations with:

  • IGEL AVD (Azure Virtual Desktop)

  • IGEL Windows 365 (Cloud PC)

  • Citrix Workspace App

  • Omnissa Horizon Client


Requirements

To use the IGEL Advanced Device Redirection USB app, the following app must be installed and configured as well:

  • IGEL Advanced Device Redirection Plugins

License Required

To use the IGEL Advanced Device Redirection apps, you need to have an IGEL Advanced Device Redirection License applied to the OS 12 device. For details, see IGEL Advanced Device Redirection Add-On License.

When IGEL Advanced Device Redirection apps are installed without the license, a license warning message is shown on the device.

Server Component Required

To use the IGEL Advanced Device Redirection apps, you need to have a server component in place. You can install the component both on Linux and Windows:

Possible Conflicts

The IGEL Advanced Device Redirection USB application conflicts with the FabulaTech USB for Remote Desktop application. You cannot use both applications at the same time.

How to Disable or Enable the USB Redirection

  1. In the profile configurator, go to Apps > IGEL Advanced Device Redirection USB > Settings

  2. Change the settings as required.

image-20241121-153605.png

 

IGEL Advanced Device Redirection USB

  • IGEL Advanced Device Redirection USB is enabled for the sessions that are enabled in the IGEL Advanced Device Redirection Plugins app. (Default)
  •  IGEL Advanced Device Redirection USB redirection is disabled.

 

Default rule

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

  • Deny: Devices are only redirected if they have Allow rules configured under Class Rules or Device Rules. (Default)

  • Allow: Devices are always redirected unless they have Deny rules configured under Class Rules or Device Rules

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-20240612-120607.png to create a new entry.

  • Click image-20240612-120536.png to remove the selected entry.

  • Click image-20240612-120523.png to edit the selected entry.

  • Click image-20240612-120446.png to copy the selected entry.

Clicking brings up the Class Rules dialog, where you can define the options described under Class Rules.

Device Rules

A device rule applies to a specific device that is identified by its serial number.

To manage rules, proceed as follows:

  • Click image-20240612-120607.png to create a new entry.

  • Click image-20240612-120536.png to remove the selected entry.

  • Click image-20240612-120523.png to edit the selected entry.

  • Click image-20240612-120446.png to copy the selected entry.

Clicking brings up the Device Rules dialog, where you can define the options described under Device Rules.

Network KeepAlive timeout

Interval in seconds between keep-alive messages sent to the server port to prevent the client-server link from being broken.

 

Set log level

Defines the degree of detail written into the log file.

Possible options:

  • Debug

  • Info

  • Warning (Default)

  • Error

  • None

Class Rules

image-20241121-154112.png

Rule

  • Allow: Devices that have the properties defined here are redirected by the IGEL Advanced Device Redirection USB. (Default)

  • Deny: Devices that have the properties defined here are not redirected.

 

Class ID

Determines the device class

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.

System Information example:

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

Example for lsusb:

 

Subclass ID

Subclass of the device class

 

Name

Free text entry

 

Override serial

Serial number that will appear in the session

 

Override name

Device name that will appear in the session

 

Postpone

  • The USB device is only removed from the system (endpoint device) when the session starts.
  •  The USB device is no longer shown immediately after the system is booted. (Default)

 

This setting is only effective if the Takeaway parameter is enabled.

 

Takeaway

  • The USB device may be removed from the system (endpoint device).
  • The USB device may not be removed. (Default)

 

No Reset

  • The device will not be automatically reset after the connection with the session has been terminated.
  • The device will be reset after the connection with the session has been terminated. (Default)

Device Rules

image-20241121-154451.png

Rule

  • Allow: Devices that have the properties defined here are redirected by the IGEL Advanced Device Redirection USB. (Default)

  • Deny: Devices that have the properties defined here are not redirected.

 

Vendor ID

Hexadecimal manufacturer 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.

System Information example:

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

Example for lsusb:

 

Product ID

Hexadecimal device number

 

Name

Free text entry

 

Override serial

Serial number that will appear in the session

 

Override name

Device name that will appear in the session

 

Postpone

  • The USB device is only removed from the system (endpoint device) when the session starts. (Default)
  • The USB device is no longer shown immediately after the system is booted.

 

This setting is only effective if the Takeaway parameter is enabled.

 

Takeaway

  • The USB device may be removed from the system (endpoint device). (Default)
  • The USB device may not be removed.

 

No Reset

  • The device will not be automatically reset after the connection with the session has been terminated. (Default)
  • The device will be reset after the connection with the session has been terminated.
JavaScript errors detected

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

If this problem persists, please contact our support.