chromium/components/policy/resources/templates/policy_definitions/ContentSettings/WebUsbAllowDevicesForUrls.yaml

caption: Automatically grant permission to these sites to connect to USB devices with
  the given vendor and product IDs.
desc: |-
  Setting the policy lets you list the URL patterns that specify which sites are automatically granted permission to access a USB device with the given vendor and product IDs. Each item in the list requires both <ph name="DEVICES_FIELD_NAME">devices</ph> and <ph name="URLS_FIELD_NAME">urls</ph> fields for the policy to be valid. Each item in the <ph name="DEVICES_FIELD_NAME">devices</ph> field can have a <ph name="VENDOR_ID_FIELD_NAME">vendor_id</ph> and <ph name="PRODUCT_ID_FIELD_NAME">product_id</ph> field. Omitting the <ph name="VENDOR_ID_FIELD_NAME">vendor_id</ph> field will create a policy matching any device. Omitting the <ph name="PRODUCT_ID_FIELD_NAME">product_id</ph> field will create a policy matching any device with the given vendor ID. A policy which has a <ph name="PRODUCT_ID_FIELD_NAME">product_id</ph> field without a <ph name="VENDOR_ID_FIELD_NAME">vendor_id</ph> field is invalid.

        The USB permission model will grant the specified URL permission to access the USB device as a top-level origin. If embedded frames need to access USB devices, the 'usb' <ph name="FEATURE_POLICY_HEADER_NAME">feature-policy</ph> header should be used to grant access. The URL must be valid, otherwise the policy is ignored.

        Deprecated: The USB permission model used to support specifying both the requesting and embedding URLs. This is deprecated and only supported for backwards compatibility in this manner: if both a requesting and embedding URL is specified, then the embedding URL will be granted the permission as top-level origin and the requesting URL will be ignored entirely.

        This policy overrides <ph name="DEFAULT_WEB_USB_GUARD_SETTING_POLICY_NAME">DefaultWebUsbGuardSetting</ph>, <ph name="WEB_USB_ASK_FOR_URLS_POLICY_NAME">WebUsbAskForUrls</ph>, <ph name="WEB_USB_BLOCKED_FOR_URLS_POLICY_NAME">WebUsbBlockedForUrls</ph> and the user's preferences.

        This policy only affects access to USB devices through the WebUSB API. To grant access to USB devices through the Web Serial API see the <ph name="SERIAL_ALLOW_USB_DEVICES_FOR_URLS_POLICY_NAME">SerialAllowUsbDevicesForUrls</ph> policy.
example_value:
- devices:
  - product_id: 5678
    vendor_id: 1234
  urls:
  - https://google.com
features:
  dynamic_refresh: true
  per_profile: true
future_on:
- fuchsia
owners:
- [email protected]
- [email protected]
schema:
  items:
    properties:
      devices:
        items:
          properties:
            product_id:
              maximum: 65535
              minimum: 0
              type: integer
            vendor_id:
              maximum: 65535
              minimum: 0
              type: integer
          type: object
        type: array
      urls:
        items:
          type: string
        type: array
    required:
    - devices
    - urls
    type: object
  type: array
supported_on:
- android:75-
- chrome_os:74-
- chrome.*:74-
tags:
- website-sharing
type: dict