WebHidAllowDevicesWithHidUsagesForUrls

Article
2025-05-09

Automatically grant permission to these sites to connect to HID devices containing top-level collections with the given HID usage

Supported versions

On Windows and macOS since 109 or later

Description

This setting allows you to list the URLs that specify which sites are automatically granted permission to access a HID device containing a top-level collection with the given HID usage.

Each item in the list requires both usages and urls fields for the policy to be valid.

Each item in the usages field must have a usage_page and may have a usage field.
Omitting the usage field will create a policy matching any device containing a top-level collection with a usage from the specified usage page.
An item which has a usage field without a usage_page field is invalid and is ignored.

If you don't set this policy, that means DefaultWebHidGuardSetting applies, if it's set. If not, the user's personal setting applies.

For detailed information about valid url patterns, see https://go.microsoft.com/fwlink/?linkid=2095322. * is not an accepted value for this policy.

URLs in this policy shouldn't conflict with those configured through WebHidBlockedForUrls. If they do, this policy takes precedence over WebHidBlockedForUrls.

Supported features

Can be mandatory: Yes
Can be recommended: No
Dynamic Policy Refresh: Yes
Per Profile: No
Applies to a profile that is signed in with a Microsoft account: Yes

Data type

Dictionary

Windows information and settings

Group Policy (ADMX) info

GP unique name: WebHidAllowDevicesWithHidUsagesForUrls
GP name: Automatically grant permission to these sites to connect to HID devices containing top-level collections with the given HID usage
GP path (Mandatory): Administrative Templates/Microsoft Edge/Content settings
GP path (Recommended): N/A
GP ADMX file name: MSEdge.admx

Example value

[{"urls": ["https://microsoft.com", "https://chromium.org"], "usages": [{"usage": 5678, "usage_page": 1234}]}]

Registry settings

Path (Mandatory): SOFTWARE\Policies\Microsoft\Edge
Path (Recommended): N/A
Value name: WebHidAllowDevicesWithHidUsagesForUrls
Value type: REG_SZ

Example registry value

[{"urls": ["https://microsoft.com", "https://chromium.org"], "usages": [{"usage": 5678, "usage_page": 1234}]}]

Expanded example registry value

[
  {
    "urls": [
      "https://microsoft.com",
      "https://chromium.org"
    ],
    "usages": [
      {
        "usage": 5678,
        "usage_page": 1234
      }
    ]
  }
]

Mac information and settings

Preference Key name: WebHidAllowDevicesWithHidUsagesForUrls
Example value:

<key>WebHidAllowDevicesWithHidUsagesForUrls</key>
<array>
  <dict>
    <key>urls</key>
    <array>
      <string>https://microsoft.com</string>
      <string>https://chromium.org</string>
    </array>
    <key>usages</key>
    <array>
      <dict>
        <key>usage</key>
        <integer>5678</integer>
        <key>usage_page</key>
        <integer>1234</integer>
      </dict>
    </array>
  </dict>
</array>

Share via