如何在 DriverKit 中将我的 dex 与 USB 设备匹配？

Question

我正在编写一个驱动程序包扩展，其目标是阻止 USB 设备，例如闪存驱动器。作为起点，我选择了 https://developer.apple 的示例项目。 com/documentation/driverkit/communicating_ Between_a_driverkit_extension_and_a_client_app?language=objc

为了不禁用键盘或者鼠标，首先我尝试将我的 dext 与单个具体 USB 驱动器相匹配，我在注册表中找到了其供应商 ID（注意十六进制到十进制的转换）。问题是，当插入闪存驱动器时，系统与我的 dext 不匹配，并继续使用系统 1。

怎么了？为此需要配置配置文件吗？是否可以通过这种方式匹配任何设备？

驱动程序的权利文件：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.app-sandbox</key>
    <true/>
    <key>com.apple.developer.driverkit</key>
    <true/>
    <key>com.apple.developer.driverkit.transport.usb</key>
    <array>
        <dict>
            <key>idVendor</key>
            <integer>9128</integer>
        </dict>
    </array>
</dict>
</plist>

Info.plist：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>CFBundleDevelopmentRegion</key>
    <string>$(DEVELOPMENT_LANGUAGE)</string>
    <key>CFBundleExecutable</key>
    <string>$(EXECUTABLE_NAME)</string>
    <key>CFBundleIdentifier</key>
    <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
    <key>CFBundleInfoDictionaryVersion</key>
    <string>6.0</string>
    <key>CFBundleName</key>
    <string>$(PRODUCT_NAME)</string>
    <key>CFBundlePackageType</key>
    <string>$(PRODUCT_BUNDLE_PACKAGE_TYPE)</string>
    <key>CFBundleShortVersionString</key>
    <string>1.0</string>
    <key>CFBundleVersion</key>
    <string>1</string>
    <key>IOKitPersonalities</key>
    <dict>
        <key>DeviceControlDriver</key>
        <dict>
            <key>idVendor</key>
            <integer>9128</integer>
            <key>CFBundleIdentifier</key>
            <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
            <key>CFBundleIdentifierKernel</key>
            <string>com.apple.kpi.iokit</string>
            <key>IOClass</key>
            <string>IOUserService</string>
            <key>IOProviderClass</key>
            <string>IOUSBHostDevice</string>
            <key>IOUserClass</key>
            <string>DeviceControlDriver</string>
            <key>IOUserServerName</key>
            <string>$(PRODUCT_BUNDLE_IDENTIFIER)</string>
            <key>UserClientProperties</key>
            <dict>
                <key>IOClass</key>
                <string>IOUserUserClient</string>
                <key>IOUserClass</key>
                <string>DeviceControlDriver</string>
            </dict>
        </dict>
    </dict>
    <key>OSBundleUsageDescription</key>
    <string></string>
</dict>
</plist>

Answer 1

这里有几个子问题，我将尝试单独解决它们：

为了不禁用键盘或鼠标，首先我尝试将我的 dext 与单个具体 USB 驱动器相匹配，我在注册表中找到了其供应商 ID（注意十六进制到十进制的转换）。问题是，当插入闪存驱动器时，系统与我的 dext 不匹配，并继续使用系统 1。

[…]

 idVendor;
            <整数>9128
……
            IOProviderClass
            <字符串>IOUSBHostDevice

macOS 上的 USB 设备匹配遵循非常特定的规则。如果您不遵循 Apple 的此文档中概述的匹配模式之一，匹配通常会失败。

您正在尝试单独匹配 idVendor；这不起作用，您需要匹配 idVendor + idProduct 或列出的其他模式之一。

怎么了？为此需要配置配置文件吗？
是否可以通过这种方式匹配任何设备？

如果您希望分发您的驱动程序，或者甚至在启用 SIP 的情况下在本地运行它，您将需要一个配置文件。请注意，Apple 通常仅针对特定请求的供应商 ID 颁发权利；如果您的需求超出此范围，您需要直接与 Apple 联系。

对于没有有效代码签名的本地测试，可以禁用SIP；您仍然需要在签名中包含有效的嵌入权利，但您可以使用与权利不匹配的配置文件。

我正在编写一个驱动程序包扩展，其目标是阻止 USB 设备，例如闪存驱动器。

请注意，这效果有限，因为在早期系统启动期间不会考虑匹配第 3 方 kext 和 DriverKit 扩展 。这意味着任何可由 Apple 驱动程序声明且在 macOS 启动时已连接的设备将始终与 Apple 自己的驱动程序匹配，而不是您的驱动程序。

对于 USB，您可以通过使用 强制重新枚举来在一定程度上解决此问题USBDeviceReEnumerate 函数。请注意，这模拟了硬拔出，因此对于已安装的存储设备，您应该首先彻底卸载。