Configure Ukey devices-Alibaba Cloud Workspace Terminal(Alibaba Cloud Workspace Terminal)-阿里云帮助中心

Obtain peripheral information

For USB peripherals, you need the VID (Vendor ID) and PID (Product ID), which are required when you configure peripheral policies. Both VID and PID are hexadecimal values, such as 0xa12c, where the 0x prefix is typically optional. You can look up the VID and PID of a connected USB peripheral in several ways.

Important

The availability of peripheral devices on a cloud computer depends on multiple factors, including the type and version of the Alibaba Cloud Workspace terminal, the cloud computer image type and version, the type and version of the local device running the Alibaba Cloud Workspace client, and the brand and model of the peripheral device. You can visit the peripheral compatibility page to check whether a specific peripheral is compatible with a cloud computer. The data on this page was obtained under laboratory conditions and may differ from actual results.

From the Alibaba Cloud Workspace terminal

Open and log on to the Alibaba Cloud Workspace client.
In the upper-right corner of the client, click the icon, and then select Settings.
In the left-side navigation pane of the Settings window, click Peripherals, and then view the VID and PID of the USB peripheral on the Local USB Peripherals panel.

From the computer's device manager

You can find the VID and PID of a peripheral in the device management information on your computer.

Windows

In the Start menu, search for and open Device Manager.
In the Device Manager window, navigate to , and then double-click the USB device you want to look up.
On the Details tab of the properties dialog box, select Hardware Ids from the Property drop-down list. The VID and PID are displayed in the text box below.

macOS

In the system menu bar, choose , and then click More Info in the dialog box.
At the bottom of the About This Mac panel, click System Report.
In the left-side navigation pane of the new window, choose Hardware > USB, select the USB device you want to look up in the right-side panel, and then view the VID and PID below.

From the floating menu

Click the floating menu and select Peripherals & Printers.
On the Advanced Management tab, view the VID and PID of the USB peripheral in the device list.

Use a third-party tool

You can use the USB Device Tree Viewer tool to view peripheral information. This tool supports only Windows.

Download the tool: https://www.uwe-sieber.de/usbtreeview_e.html#download.
Extract the downloaded package, and then double-click UsbTreeView.exe to open it.
In the left-side directory of the tool, select the USB device you want to look up, and then view the VID and PID in the Device ID section of the right-side panel.

Alibaba Cloud Workspace hardware terminal

When you use a cloud computer through an Alibaba Cloud Workspace hardware terminal such as Alibaba Cloud Workspace Terminal, Alibaba Cloud Workspace Terminal Pro, or 23.8-inch Alibaba Cloud Workspace All-In-One Terminal, the administrator and end users must complete the following steps to configure peripheral access.

Administrator: Configure peripheral policies

Peripheral management policies are part of the cloud computer policy, and must be created and maintained by an administrator in the console.

Note

The following examples use the EDS Enterprise Edition console. For the Business Edition procedure, see Manage policies.

General procedure for creating or modifying peripheral policies

Create a custom policy and associate it with a cloud computer

By default, a newly created cloud computer is associated with the system-generated default policy. Because the default policy cannot be modified, the administrator must create a custom cloud computer policy in the console and associate it with the cloud computer.

Log on to the EDS enterprise console.
In the left-side navigation pane, choose O&M > Policies.
On the Policies page, click Create Policy.
On the Create Policy page, enter a Policy Name as prompted, modify the policy settings as needed, and then click OK.

After the policy is created, you can view it in the list on the Policies page.
In the left-side navigation pane, choose Resource Management > EDS Enterprise.
On the EDS Enterprise page, perform one of the following operations as needed:
- Single operation: Find the target cloud computer, click More in the Actions column, and then select Change Policy.
- Batch operation: Select one or more cloud computers, and then choose More > Change Policy at the bottom of the page.
On the Required Policy tab of the Change Policy panel, click Change Policy, select the custom policy you created, and then click OK.

Note
If the resource group to which the cloud computer belongs already has an associated policy, you cannot directly change the policy for the cloud computer here. You can either change the policy associated with the resource group, or first remove the cloud computer from the resource group and then change its policy.
At the bottom of the Change Policy panel, click OK, and then click Confirm Policy Change.

Modify a custom policy already associated with a cloud computer

If the cloud computer is already associated with a custom policy, the administrator can directly modify the policy in the console without re-associating it.

Log on to the EDS enterprise console.
In the left-side navigation pane, choose O&M > Policies.
On the Policies page, find the custom policy you want to modify, and then click Modify Policy in the Actions column.
On the Modify Policy page, modify the policy settings as needed, and then click OK.

Peripheral policy settings

Enable local disk mapping (conditional)

For Ukey devices that include CD-ROM storage, you must also enable local disk mapping if you use Method 1 (global USB redirection). This step is not required if you use Method 2 (allowlist-based USB redirection).

Configuration path: Peripheral Control > Local Disk Mapping > Local Disk Mapping.
Configuration requirements: Set Local Disk Mapping to Read/Write or Read-only.

Enable USB redirection

Method 1: Globally enable USB redirection
- Configuration path: Peripheral Control > Peripheral Redirection > USB Redirection.
- Configuration requirements: Turn on the USB Redirection switch.
Method 2: Enable USB redirection for specific USB devices by using a peripheral whitelist
After you globally enable USB redirection, all USB devices can connect to the cloud computers associated with the policy. If you do not want all USB devices to connect to the cloud computers associated with the policy, you can turn off the USB Redirection switch and enable USB redirection for specific USB devices by adding a peripheral whitelist.
- Configuration path: Peripheral Control > Peripheral Blacklist/Whitelist > Add Rule.
- Configuration requirements: Enter the device name, VID, PID, and set Blacklist/Whitelist to Whitelist.

Configure a custom peripheral rule (optional)

To prevent end users from configuring incorrectly on the client, administrators can create custom peripheral rules in the cloud computer policy. These rules have higher priority than the custom configurations specified by end users on the client. For information about the priority of peripheral policies in different dimensions, see Policy priority.

Location: Peripheral Control > Peripheral Management Rule > Add Custom Peripheral Rule.
Requirement: Set Device Type to Ukey, enter the device name, VID, and PID, and then set Redirect Mode to USB Redirection.

End user: Configure and use the peripheral

Connect the peripheral

You must connect peripherals to the on-premises computer running the Alibaba Cloud Workspace client before you can connect the peripherals to a cloud computer.

When you connect a cloud computer to a peripheral for the first time, a connection configuration dialog box appears in the lower-right corner of the cloud computer desktop. In the dialog box, you can select the device type, specify whether to turn on auto-connect, and specify whether to remember the current configurations.

Install drivers

After a peripheral is connected successfully, it generally cannot be used directly. You must first install the driver. There are several driver installation methods to choose from.

Automatic scan and install

The first time you connect a peripheral, the system automatically scans for a matching driver. If one is found in the driver library, a Download and Install Driver dialog box appears. Click Install Now.

This feature requires the following conditions:

Cloud computer image: Windows operating system, image version V2.5.0 or later.
Alibaba Cloud Workspace terminal:
- Alibaba Cloud Workspace Terminal: version V7.5 or later.
- Alibaba Cloud Workspace Terminal Pro: version V7.5 or later.
- Alibaba Cloud Workspace Notebook: version V7.5 or later.
- Alibaba Cloud Workspace Notebook Pro: version V7.5 or later.

Install through Cloud Computer Manager

Cloud Computer Manager is a built-in utility on your cloud computer for system and peripheral management.

Open Cloud Computer Manager in one of the following ways:
- Double-click the Cloud Computer Manager shortcut icon on the cloud computer desktop.
- Click the floating ball on the cloud computer desktop and then click Cloud Computer Manager.
On the Cloud Computer Manager home page, click Peripherals & Printers.
On the Peripherals & Printers page, find the peripheral whose status is Driver Missing and click Repair.
- If a driver is found in the driver library, click Download and Install Driver in the dialog box. After installation, click Close.
- If no driver is available in the driver library but the driver is detected on your local device, click Upload and Install Local Driver in the dialog box. After installation, click Close.
- If no driver is available in the driver library or on your local device, visit the peripheral manufacturer's website from your cloud computer and download the driver.
When the peripheral status changes to Connected, the driver installation is successful and the peripheral is ready for use.

Install through WUYING Application Center

WUYING Application Center is a tool for administrators to distribute and manage applications centrally. You can also use it to install peripheral drivers.

Connect to the cloud computer. On the desktop of the cloud computer, double-click the icon to open Wuying App Center.
In the left-side navigation pane of Application Center, click Driver Center.

Note
This feature is supported only in WUYING Application Center on Windows cloud computers with image version V2.10.0 or later.
On the WUYING Driver Library or Enterprise Driver Library tab, search by device type or brand, and then click Download and Install on the card of the target peripheral.

Manual installation

If none of the preceding methods work, visit the peripheral manufacturer's website from your cloud computer and download the official driver.

Windows client

When you use a cloud computer through the Windows client, the administrator and end users must complete the following steps to configure peripheral access.