Ліцензія вже є у прошивці

Чимало людей мають ліцензію на Fisher-Price OS (Windows), жодного разу не бачивши її ключа продукту. Вона прийшла разом із машиною, а ключ живе у прошивці цієї машини, у невеликій ACPI-таблиці під назвою MSDM.

Потім машина перестає бути місцем, де робиться робота. Або власник хоче перенести цю ліцензію у ВМ, яку тепер орендує в тебе, або саму машину стирають, перетворюють на хост Proxmox, і копію ОС, з якою вона постачалася, хочуть повернути як ВМ поверх неї.

Механічно це один параметр QEMU. У цьому й проблема. QEMU передає гостьовій системі будь-яку таблицю без перевірки, гостьова система активується тим ключем, який знайде, і ніщо в усьому стеку не питає, чи дозволяє це ліцензія. Цей допис пояснює, що це за таблиця, як завести її у ВМ, не передавши пошкодженої, що кажуть умови Microsoft про її перенесення і чому корпоративна ліцензія ніколи до неї не наближається.

Що це за таблиця

Починаючи з OEM Activation 3.0, виробник ПК більше не друкує ключ на наліпці знизу корпусу, звідки його може скопіювати будь-хто з камерою в телефоні, а записує ключ у прошивку машини. Заводський інструментарій Microsoft «injects the product keys into the firmware», а крок валідації перевіряє, «that the MSDM table exists» і що її заголовок та записи «comply with the correct formats»1. Машина, налаштована так, «activated by using the OA3 DPK in the firmware»2. MSDM є звичайною ACPI-таблицею, і в Linux вона читається просто з прошивки:

sudo cat /sys/firmware/acpi/tables/MSDM > msdm.bin

Ноутбук, на якому написано цей текст, має таку. 85 байтів.

Опублікована специфікація Microsoft визначає стандартний 36-байтовий ACPI-заголовок із сигнатурою MSDM, і на цьому все. Усе після заголовка є «Proprietary data structure that contains all the licensing data necessary to enable Windows activation»3.

БайтиМістятьЗвідки відомо
0 до 35стандартний ACPI-заголовок: сигнатура MSDM, довжина, контрольна сума, OEM IDспецифікація Microsoft
36 до 5520 байтів полів: версія, тип даних, довжина данихреальні таблиці, не опублікована специфікація
56 до 8429-символьний ключ продукту, п’ять груп по п’ятьреальні таблиці, не опублікована специфікація

QEMU передасть усе, що ти йому даси

Параметр QEMU -acpitable file= бере «whole ACPI table from the specified files, including all ACPI headers (possible overridden by other options)»4, і гостьова система бачить таблицю MSDM точно так, як її показала б прошивка ноутбука. Це перевірено з навмисно фальшивим ключем. Байти вийшли з іншого боку ідентичними, від сигнатури до останнього символу.

QEMU нічого не відкидає. Ось що hw/acpi/core.c робить зі зламаним файлом5:

Що не так із файломЩо робить QEMUЩо бачить гостьова система
Довжина в заголовку не збігається з файломпопереджає, а потім перезаписує довжину справжнім розміромкоректний заголовок
Контрольна сума не дає нуляперераховує її, для кожної таблиці, щоразукоректну контрольну суму
Ключ обрізаний або спотворенийнічого, дані після заголовка його не стосуютьсятаблицю, що виглядає коректно, навколо зламаного ключа

Гостьова система ніяк не може побачити різницю, і ти теж, доки хтось не відкриє заявку в підтримку. Перше, що про це хтось почує, буде клієнт, у якого не пройшла активація.

Тож якщо клієнти завантажують такі файли, перевіряй їх до того, як їх побачить QEMU:

#!/usr/bin/env python3
"""Refuse anything that is not a well-formed MSDM table before QEMU sees it."""
import re, struct, sys

t = open(sys.argv[1], 'rb').read()
fail = lambda why: sys.exit(f"{sys.argv[1]}: {why}")

if len(t) < 56:                       fail(f"{len(t)} bytes, too short for an MSDM table")
sig, length = t[:4], struct.unpack_from('<I', t, 4)[0]
if sig != b'MSDM':                    fail(f"signature is {sig!r}, not MSDM")
if length != len(t):                  fail(f"header says {length} bytes, file is {len(t)}")
if sum(t) & 0xff:                     fail("checksum does not sum to zero")
ver, _, dtype, _, dlen = struct.unpack_from('<5I', t, 36)
if (ver, dtype) != (1, 1):            fail(f"version {ver}, data type {dtype}: expected 1 and 1")
if dlen != 29 or 56 + dlen != length: fail(f"data length {dlen}: expected 29")
key = t[56:].decode('ascii', 'replace')
if not re.fullmatch(r'([0-9A-Z]{5}-){4}[0-9A-Z]{5}', key): fail("data is not a 5x5 product key")
print(f"OK  OEM {t[10:16].decode(errors='replace').strip()!r}  key *****-*****-*****-*****-{key[-5:]}")
ПеревіряєЗвіряє файл ізЗбій означає
Сигнатуру, довжину, контрольну сумузадокументованим заголовком Microsoftфайл зламаний
Версію, тип даних, довжину даних, форму ключаформою, яку мають реальні таблиціподивися на цей файл вручну, а не «це підробка»

Він ніколи не виводить ключ, лише останню групу. Ключ продукту в лог-файлі є ключем продукту, яким може скористатися хтось інший.

Запуск на справній таблиці і трьох її зламаних копіях:

OK  OEM 'EXMPLE'  key *****-*****-*****-*****-EEEEE
bad-sum.bin: checksum does not sum to zero
bad-trunc.bin: header says 85 bytes, file is 70
bad-sig.bin: signature is b'SLIC', not MSDM

Де вона лежить і хто може її туди покласти

Від завантаження клієнта до ключа, яким активується гостьова системаТаблиця клієнтаmsdm.bin, 85 байтівз його власної машиниВалідаторсигнатура, довжина,контрольна сума, форма ключаЗберігається/etc/pve/priv/лише root, кожен вузолargs ВМ-acpitable file=задає лише rootQEMUперезаписує довжину,перераховує контрольну суму,нічого не відкидаєГостьова системаMSDM в ACPI,активація читає ключ
Валідатор стоїть перед QEMU, бо QEMU підлатає зламаний заголовок, а не відкине його. Таблиця лежить у приватній частині кластерної файлової системи, тож іде за ВМ на будь-який вузол, і прочитати її може лише root.

Ключ продукту є секретом. Йому не місце там, де його може прочитати www-data, і pmxcfs дає тобі рівно одне місце в /etc/pve, де він цього не може6:

Де могла б лежати таблицяХто може її прочитатиНа кожному вузлі, куди може мігрувати ВМ
/etc/pve/privлише rootтак
будь-де ще в /etc/pveчитається групою, включно з www-data вебінтерфейсутак
каталог на одному вузліщо налаштуєшні

З її 85 байтами вона дуже далека від ліміту файлу pmxcfs в 1 MiB7:

mkdir -p /etc/pve/priv/msdm
check-msdm.py upload.bin && cp upload.bin /etc/pve/priv/msdm/9000.bin
qm set 9000 --args "-acpitable file=/etc/pve/priv/msdm/9000.bin"

qm set --args замінює весь рядок. Якщо ВМ уже має параметри SMBIOS або прошивки в args, пропиши їх усі разом. І оскільки args доступний лише root, це робота для твоєї системи провізіювання, а не щось, що клієнт може зробити з вебінтерфейсу. Так і має бути. Клієнт дає файл, твій інструментарій його перевіряє і підключає.

Таблиця переносить ключ, а не право

Тут ця функція вимагає тверезої голови. Перенесення таблиці MSDM у ВМ переносить ключ. Не ліцензію.

Так кажуть власні умови Microsoft, і рядки, які мають значення, вміщаються в таблицю:

ВипадокЩо каже MicrosoftДжерело
OEM-ліцензія, перенесенняпередається іншому користувачеві «only with the licensed device»ліцензійні умови OEM8
OEM-ліцензія, скільки встановлень«only one instance of the software for use on one device, whether that device is physical or virtual»ліцензійні умови OEM8
OEM-ліцензія, простими словами«locked» до початкового ПК «and cannot be transferred to any other PC»блог Microsoft для малого бізнесу9
Винятокположення про передачу «do not apply», якщо програмне забезпечення придбано в Німеччині або в низці інших країнліцензійні умови OEM8
Хостинг для клієнтівServices Provider License Agreement призначена для «hosted applications to end customers»SPLA10
Настільні редакції як хостингові ВМ«VMs must be hosted by a Qualified Multitenant Hoster (QMTH)»Microsoft Learn11

Таблиця завжди береться з власної ліцензованої машини клієнта, ніколи з твоїх хостів. Випадок, що цілком вкладається у формулювання, найпростіший: машина, з якою було продано ліцензію, тепер працює під Proxmox, а та сама копія Fisher-Price OS (Windows) перенесена в одну ВМ на ній. Це все ще один екземпляр на одному пристрої, і умови OEM дозволяють це «whether that device is physical or virtual»8. Друга ВМ або інша машина, і вже ні.

У цьому єдиному випадку машина клієнта і гіпервізор є однією коробкою, тож нічого не треба завантажувати і нічого копіювати. Ядро Proxmox уже показує таблицю MSDM прошивки в /sys/firmware/acpi/tables/, доступну для читання лише root, а QEMU на Proxmox працює від root, тож може взяти таблицю просто звідти:

qm set 100 --args "-acpitable file=/sys/firmware/acpi/tables/MSDM"

Вказівка на живу таблицю замість копії має два наслідки. Шлях читається на тому вузлі, де стартує ВМ, тож це для окремого хоста, а не для кластера: мігруй ВМ, і вона або отримає таблицю того вузла, іншу ліцензію з іншої машини, або не запуститься взагалі, бо QEMU відмовляється від відсутнього файлу з can't open file … No such file or directory. І це один рядок, а отже, один рядок, який легко вставити в другу ВМ. Ця друга ВМ є саме тим випадком, який умови не покривають, тож одна ВМ це отримує, а інші ні.

Тож будуй цю функцію. Механізм надійний, і є клієнти, які мають право ним користуватися; той, хто купив ліцензію в Німеччині, цілком може бути серед них. Але поклади право туди, де йому місце: у твої умови надання послуг, де клієнт гарантує, що має ліцензію, яка покриває запуск у твоїй ВМ, і робить це до того, як кнопка завантаження щось зробить. Валідатор доводить, що таблиця правильно сформована. Ніщо не доводить, що клієнт має право нею користуватися.

Корпоративні ліцензії ніколи не наближаються до таблиці

Чи може клієнт із корпоративною ліцензією скористатися тим самим шляхом? Ні. Таблиці нічого переносити.

MSDM належить каналу OEM і нічому іншому. Власний посібник Microsoft з планування каже, що OEM-активація «is available only for computers that are purchased through OEM channels and have the Windows operating system preinstalled»12. Корпоративні ліцензії активуються через одну з трьох інших моделей, «Multiple Activation Keys (MAK)», «KMS» і «Active Directory-based activation»12, і в кожній із них ключ установлюється в операційній системі. Ніщо не читає його з прошивки.

МетодДе живе ключЗ чим говорить гостьова системаУ ВМ Proxmox
OEM, OA 3.0таблиця MSDM у прошивцісервери активації Microsoftшлях через -acpitable вище
MAKустановлений у гостьовій системіз Microsoft, один раз, із зарахуванням до активацій ключапрацює з доступом до інтернету або телефоном
KMSзагальний ключ (GVLK) у гостьовій системіKMS-хост клієнта на TCP 1688потребує маршруту до нього, і 25 клієнтів або 5 серверів, перш ніж він щось активує
Active DirectoryGVLK у гостьовій системіконтролери домену клієнта, щонайменше раз на 180 днівпотребує, щоб ВМ була в їхньому домені
AVMAзагальний ключ у гостьовій системівласна ліцензія Datacenter хоста Hyper-Vнедоступна взагалі

Тож для корпоративного клієнта на гіпервізорі нічого будувати не треба. Його ключ іде в його образ, а твоя частина є мережевим шляхом: порт 1688 до його KMS-хоста або VPN до його контролерів домену. Слот MSDM лишається порожнім, і так має бути.

Дві речі підловлюють людей. Загальний ключ на корпоративному носії сам по собі нічого не активує, бо «the GVLK doesn’t work unless a valid KMS host key can be found»12, тож ВМ, зібрана з Enterprise ISO клієнта без маршруту додому, лишається неактивованою. І настільна корпоративна ліцензія сама по собі не є ліцензією. Корпоративні програми «cover upgrades to Windows client operating systems only», і «an existing retail or OEM operating system license is needed for each computer»12. Корпоративна ліцензія лежить поверх базової, дуже часто тієї самої OEM-ліцензії, про яку йшлося в попередньому розділі, і чи можна запускати її у твоїй ВМ, це все одно питання хостингу з тієї таблиці, а не питання активації.

AVMA заслуговує окремого рядка, бо саме вона виглядає як відповідь. Це спосіб Microsoft, у який хост активує власні серверні гостьові системи, прив’язуючи «the VM activation to the licensed virtualization host», і вона потребує «a Windows Server Datacenter edition with the Hyper-V server host role installed»13. Щодо решти Microsoft висловлюються прямо: «AVMA doesn’t work with other server virtualization technologies»13. На Proxmox серверні гостьові системи активуються через твої ключі SPLA або через власний KMS клієнта.

Ніщо в стеку не перевіряє папери

Кожен рівень тут робить свою роботу і нічого більше. Прошивка зберігає ключ. QEMU копіює байти й прибирає в заголовку. Гостьова система читає ключ і активується ним. Жоден із них не може сказати, чи машина під ним та сама, з якою продано ліцензію, і жоден ніколи не мав цього робити.

Тож перевірка лягає на того, хто керує гіпервізором. Ліцензія є угодою між тим, хто її купив, і Microsoft, і твоя платформа не є її стороною, але саме вона переносить ключ, і через це питання стає твоїм, хотів ти цього чи ні.

Запиши відповідь до того, як кнопка завантаження щось зробить. Одна машина, одна ВМ, власна ліцензія клієнта і його слово, що вона це покриває. Це нічого не коштує, і захищає тебе не менше, ніж його. Програмне забезпечення перенесе будь-який ключ, який йому дадуть. Чи мало воно це робити, на це питання може відповісти лише людина, тож подбай, щоб вона була.


  1. Microsoft Learn, OA 3.0 on the factory floor — «injects the product keys into the firmware»; /Validate перевіряє «that the MSDM table exists». ↩︎

  2. Microsoft Learn, Validate an OEM Activation key — «is activated by using the OA3 DPK in the firmware». ↩︎

  3. Microsoft, Microsoft Software Licensing Tables (SLIC and MSDM) — таблиця 2, зсув 36: «Proprietary data structure that contains all the licensing data necessary to enable Windows activation.» ↩︎

  4. QEMU, System Emulation, Invocation — поля -smbios для кожного типу; -acpitable «For file=, take whole ACPI table from the specified files, including all ACPI headers»; -boot «Currently Seabios for X86 system support it.» ↩︎

  5. QEMU v11.0.3, hw/acpi/core.c — «ACPI table has wrong length» є warn_report, після чого довжина перезаписується, а контрольна сума перераховується. ↩︎

  6. pve-cluster, src/pmxcfs/pmxcfs.c — шляхи під priv маскуються до 0777700, усе інше до 0777750. ↩︎

  7. pve-cluster, src/pmxcfs/memdb.h — #define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB. ↩︎

  8. Microsoft, Windows 11 OEM licence terms — «you may transfer the license to use the software directly to another user, only with the licensed device»; положення про передачу «do not apply if you acquired the software in Germany» або в перелічених країнах. Архівна копія; жива сторінка відмовляє автоматизованим запитам. ↩︎ ↩︎ ↩︎ ↩︎

  9. Microsoft, small business blog archive — «the OEM Windows license is ’locked’ to the original PC it comes with and cannot be transferred to any other PC.» ↩︎

  10. Microsoft, Services Provider License Agreement — «for service providers and software development companies licensing eligible Microsoft products to provide software services and hosted applications to end customers.» ↩︎

  11. Microsoft Learn, Windows subscription activation for VDA — «VMs must be hosted by a Qualified Multitenant Hoster (QMTH).» ↩︎

  12. Microsoft Learn, Plan for volume activation — три моделі корпоративної активації; пороги KMS «at least five computers» для серверів і «at least 25 computers» для клієнтів, на TCP-порту 1688; активація через Active Directory потребує домену «at least once every 180 days»; «the GVLK doesn’t work unless a valid KMS host key can be found»; корпоративні ліцензії «cover upgrades to Windows client operating systems only». ↩︎ ↩︎ ↩︎ ↩︎

  13. Microsoft Learn, Automatic Virtual Machine Activation in Windows Server — «AVMA requires a Windows Server Datacenter edition with the Hyper-V server host role installed»; «AVMA doesn’t work with other server virtualization technologies.» ↩︎ ↩︎