iControl Boot — Diskless и тест Windows Часть 1: ZIP и DPAPI в Windows. Часть 2: лаборатория на двух ПК, отдельные identity и три загрузки со сбросом. Сборка Windows и нативный тест DPAPI пройдены. PXE, запуск интерфейса и сохранность после трёх сбросов проверяются в лаборатории. ЧАСТЬ 1 · ТЕСТОВЫЙ ПАКЕТ WINDOWS Достаточно тестового ПК или VM с Windows 10/11 x64 и Windows PowerShell 5.1 / PowerShell 7. Python устанавливать не нужно. 1. Скачайте и распакуйте ZIP. Сохраните Agent/ и deployment/ вместе. Дважды щёлкните deployment/START-LAB.cmd, чтобы открыть меню локальных инструментов. 2. Проверьте архив. Откройте PowerShell в корне распакованного пакета и скопируйте команду. Имя файла и SHA256 уже заполнены; измените ArchivePath, если ZIP лежит не в Downloads. Ожидается archive_verified, exit 0. $zip = "$env:USERPROFILE\Downloads\iControl-agent-boot-lab-1.4.88-win-x64-20261101T073451Z-9250b86b.zip" $expected = 'de947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384' if ((Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash -ieq $expected) { powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Verify -ArchivePath $zip -ExpectedSha256 $expected } else { throw 'ZIP SHA256 mismatch' } 3. Проверьте результат. Проверяются hash, manifest, опасные пути и целостность файлов без распаковки или запуска. При blocked / exit 2 проверьте ZIP и выбранный путь. Это пакет Windows-агента. Linux boot-controller и PXE/iSCSI-инфраструктура для части 2 готовятся отдельно. ТЕСТ WINDOWS БЕЗ ЛАБОРАТОРИИ Восемь шагов для обычного ПК или VM с Windows 10/11 x64. В PowerShell 5.1 или 7 последовательно проверьте ZIP, Windows preflight, DPAPI и диагностический отчёт. 1. Скачайте и распакуйте ZIP. Скачайте актуальный пакет кнопкой ZIP выше. Распакуйте в папку iControl-Lab внутри Downloads. Непосредственно в ней должны находиться Agent и deployment. Команды ниже используют это расположение. 2. Проверьте целостность ZIP. Откройте PowerShell и скопируйте готовую команду ниже. Имя файла и SHA256 уже заполнены; измените $zip, если архив не в Downloads. Ожидается archive_verified. При несовпадении hash не продолжайте. hardware_verified:false и ui_launch_verified:false означают, что приёмка оборудования и интерфейса выполняется отдельно. cd "$env:USERPROFILE\Downloads\iControl-Lab" $zip = "$env:USERPROFILE\Downloads\iControl-agent-boot-lab-1.4.88-win-x64-20261101T073451Z-9250b86b.zip" $expected = 'de947c7c48b3ef2d6cfa74fa8aad6dddd0b0f4c4207082a0ff189f50e2791384' if ((Get-FileHash -LiteralPath $zip -Algorithm SHA256).Hash -ieq $expected) { powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Verify -ArchivePath $zip -ExpectedSha256 $expected } else { throw 'ZIP SHA256 mismatch' } 3. Запустите Windows preflight. Дважды щёлкните deployment\START-LAB.cmd и выберите 2 — Windows preflight. Права администратора не требуются. windows, architecture, powershell и dpapi должны иметь passed, общий статус — ready. При blocked прочитайте hint этой проверки. Меню выполняет одно действие; для следующего откройте его заново. 4. Создайте тестовый DPAPI-файл. Через Win + R откройте powershell.exe -NoProfile -ExecutionPolicy Bypass и выполните команду ниже. Bypass действует только для этого процесса PowerShell. Ожидаются dpapi-test.bin и DPAPI test file created. Это несекретные тестовые данные, настоящий AgentKey не затрагивается. Затем закройте окно PowerShell. & { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = [Text.Encoding]::UTF8.GetBytes('icontrol-lab-test') [IO.File]::WriteAllBytes($path, (Protect-IControlAcceptanceData $data)) 'DPAPI test file created' } 5. Проверьте в новом окне PowerShell. Под той же учётной записью Windows через Win + R откройте новое окно powershell.exe -NoProfile -ExecutionPolicy Bypass. Выполните команду ниже; ожидается DPAPI OK. Пока не удаляйте тестовый файл. & { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = Unprotect-IControlAcceptanceData ([IO.File]::ReadAllBytes($path)) if ([Text.Encoding]::UTF8.GetString($data) -ceq 'icontrol-lab-test') { 'DPAPI OK' } else { throw 'DPAPI test failed' } } 6. Повторите после обычного restart Windows. Сохраните работу и перезагрузите компьютер. Войдите в тот же Windows-аккаунт, откройте новое окно PowerShell как выше и повторите команду. Ожидается DPAPI OK. Это обычный локальный restart; diskless-сбросы проверяются отдельно в лаборатории. & { $ErrorActionPreference = 'Stop' cd "$env:USERPROFILE\Downloads\iControl-Lab" . .\deployment\boot-acceptance-tools.ps1 $path = "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" $data = Unprotect-IControlAcceptanceData ([IO.File]::ReadAllBytes($path)) if ([Text.Encoding]::UTF8.GetString($data) -ceq 'icontrol-lab-test') { 'DPAPI OK' } else { throw 'DPAPI test failed' } } 7. Создайте диагностический ZIP. Снова откройте START-LAB.cmd, выберите 4 — Diagnostics ZIP, затем W — Windows. На Desktop появится новый iControl-support-....zip с preflight.json, events.json и README.txt. files_scanned:0 нормально, если агент ещё не запускался на ПК. Отчёт остаётся локальным и автоматически не отправляется. 8. Удалите тестовый файл. После всех проверок выполните эту команду в PowerShell. Удалится только dpapi-test.bin, созданный по инструкции. Пакет, исходный ZIP и диагностический отчёт можно сохранить. Remove-Item -LiteralPath "$env:USERPROFILE\Downloads\iControl-Lab\dpapi-test.bin" Критерии успеха: archive_verified → ready → DPAPI OK в новом окне и после обычного restart → создан диагностический ZIP. PXE и три diskless-сброса проверяются на лабораторном этапе. АВТОМАТИЧЕСКИЙ PREFLIGHT Только чтение: настройки Windows, диски, tasks, markers и identity не меняются. AgentKey и содержимое config не читаются. 1. Проверка Windows. Можно начать без лаборатории. Проверяются x64 OS/process, PowerShell и DPAPI roundtrip в памяти под текущим Windows-аккаунтом. powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Check -Mode Windows 2. Проверка diskless. Когда лаборатория готова, запустите PowerShell elevated под самим kiosk-аккаунтом. Проверяются image policy, OS iSCSI target, private-диск/serial, manifest, UUID firmware binding, аккаунт task и autologin/shell. powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Check -Mode Diskless -InstallDir C:\iControl\Agent -StateRoot P:\iControl 3. Прочитайте статус. ready / exit 0 — проверки режима пройдены. pending / exit 3 — нужен отдельный setup/reboot gate агента. maintenance / exit 3 — обнаружена maintenance-загрузка. blocked / exit 2 — следуйте подсказке в отчёте. Preflight не заменяет startup gate агента и приёмку после трёх сбросов. Если UUID firmware identity недоступен, нужна проверка оператора. ЧАСТЬ 2 · DISKLESS-ЛАБОРАТОРИЯ Подготовьте Linux boot-controller, два тестовых ПК, Windows maintenance image, постоянный kiosk-профиль и отдельный state-диск для каждого ПК. 1. Подготовьте pilot image. Скопируйте Agent/ в C:\Lab\Agent внутри образа. Отключите автозапуск billing/lock iCafe только в pilot image. Заранее настройте оболочку explorer.exe, autologin Windows и kiosk-аккаунт с правами администратора. 2. Разместите агент. Скрипты deployment должны лежать вместе; запустите команду от администратора. Замените LAB\Kiosk и YOUR-PILOT-API.example на свой тестовый аккаунт и pilot API. IQN prefix должен совпадать с контроллером. .\deployment\prepare-icontrol-boot-image.ps1 ` -AgentBuildDir C:\Lab\Agent ` -KioskUser 'LAB\Kiosk' ` -IqnPrefix 'iqn.2026-10.uz.i-control.lab' ` -StateRoot P:\iControl ` -ServerUrl 'https://YOUR-PILOT-API.example' ` -ICafeDisabledOnPilotImage 3. Сохраните общий образ чистым. Не копируйте в него AgentKey, club enroll token, config другого ПК или файлы DPAPI. Полные требования — в deployment/ICONTROL-BOOT.md внутри ZIP. IDENTITY КАЖДОГО ПК При обычной загрузке controller экспортирует OS через LUN 0, private state-диск этого ПК — через LUN 1. Maintenance-загрузка не подключает state-диск. 1. Получите manifest контроллера. Командой station-identity pc01 создайте pc01.boot-station.json. Для pc02 нужен отдельный manifest. Передайте каждый файл на соответствующий ПК доверенным административным способом. 2. Проверьте state-диск. Вручную подготовьте только пустой private-диск с ожидаемым serial и назначьте P:. Не выбирайте boot/system-диск. Скрипт ниже не форматирует диски. 3. Установите manifest. Остановите агент и выполните команду из отдельного аккаунта администратора Windows. На pc02 используйте его собственный manifest. .\deployment\initialize-icontrol-boot-state.ps1 -ManifestPath C:\Setup\pc01.boot-station.json -StateRoot P:\iControl 4. Запустите агент. Первая загрузка под kiosk-аккаунтом создаёт binding и требует reboot. После прохождения gate на следующей отдельной загрузке выполните per-PC provisioning. Проверьте отдельные identity в dashboard. DPAPI · ТРИ СБРОСА Используйте тот же kiosk-аккаунт, что и агент. Private-диск, профиль Windows и учётная запись должны оставаться прежними. 1. Начните тест один раз. Выполните Begin из папки распакованного пакета. .\deployment\test-icontrol-boot-state.ps1 -Mode Begin -StateRoot P:\iControl 2. Выполните три настоящих сброса. После каждой reset-загрузки через controller запускайте Verify. Повторный вызов во время одной загрузки Windows не считается новым сбросом. .\deployment\test-icontrol-boot-state.ps1 -Mode Verify -StateRoot P:\iControl 3. Проверьте результат. Exit 3 / pending_reboots — нужна ещё одна отдельная reset-загрузка. Exit 0 / verified — тест трёх сбросов пройден. Exit 2 / blocked — проверьте диск, manifest, аккаунт или DPAPI. При ошибке сохраните историю и markers. Не удаляйте их для обхода gate. ДИАГНОСТИЧЕСКИЙ ZIP Выберите пункт 4 в START-LAB или создайте новый отчёт командой. 1. Создайте отчёт. Пример для diskless. Для обычной Windows-проверки используйте -Mode Windows. Существующие отчёты не перезаписываются; выберите другое имя. Меню автоматически создаёт новое имя на Desktop. powershell.exe -NoLogo -NoProfile -ExecutionPolicy Bypass -File .\deployment\lab-tools.ps1 -Action Report -Mode Diskless -InstallDir C:\iControl\Agent -StateRoot P:\iControl -OutputPath "$env:USERPROFILE\Desktop\iControl-support.zip" 2. Что внутри. preflight.json — разрешённые статусы. events.json — счётчики категорий из последних четырёх agent-логов, не более 256 KiB из каждого. README.txt — границы отчёта. Нет raw logs, токенов, AgentKey, config-контента, имён пользователей, SID, serial или DPAPI-файлов. 3. Просмотрите и отправьте сами. Отчёт остаётся локальным и автоматически никуда не загружается. При необходимости передайте support. files_scanned=0 означает, что читаемые agent-логи не найдены; preflight всё равно может описать заблокированный ПК. ИТОГОВАЯ ПРОВЕРКА Зафиксируйте результаты для обоих тестовых ПК. 1. Identity и подключение. pc01 и pc02 отображаются отдельно; после трёх сбросов оба подключаются без повторного запроса AgentKey. 2. Maintenance и блокировка. Maintenance boot завершает агент до запуска сеанса/kiosk. Отсутствующий state-диск или manifest другого ПК блокирует запуск. 3. Тестовый сеанс. Проверьте отдельный тестовый сеанс, lock/unlock и бронирование в pilot-клубе. 4. Сообщение об ошибке. Запишите этап, JSON status/exit code, версию Windows и имя тестового ПК. Не отправляйте AgentKey, токены и DPAPI-файлы.