Manually Bridging USB Devices

If you need to support more than 20 USB devices, or if you expect your users to control which devices can be bridged, they can be manually added by opening the client’s USB Devices menu and enabling them.

Required Entitlement

As of version 23.01, the macOS PCoIP Soft Client SDK USB solution leverages the IOUSBHost framework under the hood to claim and release USB devices. However, for the macOS PCoIP Soft Client SDK to capture or release USB devices, either of the following conditions must be met:

• The macOS PCoIP Soft Client SDK is running as root user
• The macOS PCoIP Soft Client SDK is granted the [com.apple.vm.device-access](https://developer.apple.com/documentation/bundleresources/entitlements/com_apple_vm_device-access?language=objc) entitlement

Obtaining the com.apple.vm.device-access Entitlement

The com.apple.vm.device-access entitlement can be requested directly from the Apple Support Team by submitting a Technical Support Incident.

To set up provisioning profile:

1. Ensure that the com.apple.vm.device-access entitlement has been granted.
2. In your Apple Developer account, create an app identifier for this app. For example, "com.myorganization.usbsessionexample".
3. Create a Development provisioning profile, and enable the com.apple.vm.device-access capability. This capability is associated to the app identifier you created in step 2. An example name of the provisioning profile is "com.myorganization.usb-session-example".