Ліцензія вже є у прошивці
Чимало людей мають ліцензію на 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 до 55 | 20 байтів полів: версія, тип даних, довжина даних | реальні таблиці, не опублікована специфікація |
| 56 до 84 | 29-символьний ключ продукту, п’ять груп по п’ять | реальні таблиці, не опублікована специфікація |
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
Де вона лежить і хто може її туди покласти
Ключ продукту є секретом.
Йому не місце там, де його може прочитати 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 Directory | GVLK у гостьовій системі | контролери домену клієнта, щонайменше раз на 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, і твоя платформа не є її стороною, але саме вона переносить ключ, і через це питання стає твоїм, хотів ти цього чи ні.
Запиши відповідь до того, як кнопка завантаження щось зробить. Одна машина, одна ВМ, власна ліцензія клієнта і його слово, що вона це покриває. Це нічого не коштує, і захищає тебе не менше, ніж його. Програмне забезпечення перенесе будь-який ключ, який йому дадуть. Чи мало воно це робити, на це питання може відповісти лише людина, тож подбай, щоб вона була.
Microsoft Learn, OA 3.0 on the factory floor — «injects the product keys into the firmware»;
/Validateперевіряє «that the MSDM table exists». ↩︎Microsoft Learn, Validate an OEM Activation key — «is activated by using the OA3 DPK in the firmware». ↩︎
Microsoft, Microsoft Software Licensing Tables (SLIC and MSDM) — таблиця 2, зсув 36: «Proprietary data structure that contains all the licensing data necessary to enable Windows activation.» ↩︎
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.» ↩︎QEMU v11.0.3,
hw/acpi/core.c— «ACPI table has wrong length» єwarn_report, після чого довжина перезаписується, а контрольна сума перераховується. ↩︎pve-cluster,
src/pmxcfs/pmxcfs.c— шляхи підprivмаскуються до0777700, усе інше до0777750. ↩︎pve-cluster,
src/pmxcfs/memdb.h—#define MEMDB_MAX_FILE_SIZE (1024 * 1024) // 1 MiB. ↩︎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» або в перелічених країнах. Архівна копія; жива сторінка відмовляє автоматизованим запитам. ↩︎ ↩︎ ↩︎ ↩︎
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.» ↩︎
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.» ↩︎
Microsoft Learn, Windows subscription activation for VDA — «VMs must be hosted by a Qualified Multitenant Hoster (QMTH).» ↩︎
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». ↩︎ ↩︎ ↩︎ ↩︎
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.» ↩︎ ↩︎