Настройка HWID¶

HWID (Hardware ID) — уникальный идентификатор агента Staffcop. Он нужен, чтобы:

зарегистрировать устройство на сервере мониторинга;
отличить один ПК от другого;
избежать наложения данных с разных машин.

Windows-агенту присвоить HWID можно несколькими способами:

Метод	Количество агентов	Версия агента и сервера
Ручная настройка через реестр Windows	Один агент	5.8.2450+, все версии Staffcop
Автоматическая генерация через BAT‑скрипт	Один агент	5.8.2478+, все версии Staffcop
Генерация через msiexec или имя MSI‑файла	Массовая установка, один агент	5.8.2583+, Staffcop 5.5+

См.также

Чтобы изменить HWID на Linux-системах, используйте команды генерации HWID.

В случае возникновения вопросов обратитесь в техническую поддержку.

Присвоение HWID на клонированных системах ¶

При установке на клонированные системы HWID дублируется, и сервер видит несколько ПК как одно устройство.

Проблема уникальности решается в зависимости от способа присвоения:

реестр и BAT-скрипт — ручным добавлением ключа в ветку реестра HKEY_LOCAL_MACHINE\SYSTEM\SCHWID;
msiexec или имя MSI‑файла — с помощью добавления параметров при установке через Утилиту удаленной установки и Локальную установку.

См.также

Метод присвоения HWID через msiexec или имя MSI‑файла автоматически обеспечивает уникальность идентификаторов. Кроме этого, он позволяет массово присваивать HWID агентам. Описан в отдельной статье — Автоматическая настройка HWID для разных инфраструктур.

Присвоение HWID через реестр и BAT-скрипт описаны ниже.

Ручная настройка HWID ¶

С версии 5.8.2450 агент позволяет задать HWID вручную через реестр Windows. Для этого создайте значение REG_SZ:

[HKEY_LOCAL_MACHINE\SYSTEM\SCHWID]
"hwid"="1111-2223"

Ошибка Wrong CN! в логах¶

Ошибка Wrong CN! в логах агента означает, что сервер отклонил соединение от агента из-за несовпадения ожидаемого и фактического HWID (Common Name).

Решения:

Убедитесь, что значение HWID не содержит пробелов.
Создайте .reg-файл со следующим содержимым:

Windows Registry Editor Version 5.00

[HKEY_LOCAL_MACHINE\SYSTEM\SCHWID]
"hwid"="XXXX-YYYY"
Замените XXXX-YYYY на ваш актуальный идентификатор.

Автоматическая генерация HWID¶

Начиная с версии агента 5.8.2478, генерация уникального идентификатора HWID может быть выполнена автоматически с помощью BAT-скрипта. Скрипт создает или заменяет значение HWID в системном реестре.

Для этого:

Скопируйте код в файл, например в hwid.bat.

@echo off
reg query "HKLM\SYSTEM\SCHWID" /v "hwid" > null
set I=22
set N=16
set CHAR=0 1 2 3 4 5 6 7 8 9 A B C D E F
set Hex=0
:LOOP
set /a R=1+%N%*%random%/32768
for /f "tokens=%R%" %%q in ("%CHAR%") do (set Hex=%%q%Hex%)
Set /a I-=1
If %I% GTR 0 goto LOOP
echo %Hex%
reg add HKLM\SYSTEM\SCHWID /f /v hwid /t REG_SZ /d %Hex%
:end

Предупреждение

Каждый запуск скрипта создает новый случайный HWID. Существующее значение будет перезаписано.

Запустите скрипт в CMD или Powershell:

cmd.exe /c hwid.cmd

После этого уникальный идентификатор будет записан в реестр системы. Уникальный идентификатор закрепится за системой и не будет изменяться автоматически.

Уникальный HWID¶

На виртуальных машинах и шаблонных образах могут совпадать HWID, из-за чего агенты отображаются некорректно.

Пример: VDI или доменные ПК с одним образом и разными профилями. У них одинаковые серийные номера дисков, MAC-адреса или другие системные параметры, поэтому агент формирует один и тот же HWID для всех.

Начиная с версии 5.8.2539, можно формировать HWID на основе полного доменного имени (FQDN), чтобы гарантировать уникальность на таких системах.

Для создания уникального HWID добавьте в ветку реестра HKEY_LOCAL_MACHINE\SYSTEM\SCHWID ключ формата DWORD (32) с названием use_fqdn со следующими значениями:

Значение	Описание
0 или отсутствие	Стандартная логика генерации HWID: по серийному номеру диска, MAC-адресу или номеру тома.
1	Вместо ID диска используется полное доменное имя (FQDN) компьютера в нижнем регистре. Значение сохраняется в реестре и используется как HWID.
2	Используется полное доменное имя (FQDN), но не сохраняется в реестре (параметр hwid не используется). В случае смены имени компьютера меняется HWID.

См.также

Подробнее типы HWID и ключи описаны в статье Автоматическая настройка HWID для разных инфраструктур.

Внимание

Если в реестре уже сформирован HWID, новое поведение не применится. Удалите значение HWID, чтобы применить use_fqdn.

Чтобы удалить значение, запустите в CMD или Powershell:

reg delete "HKLM\SYSTEM\SCHWID\HWID" /f

Внимание

В предыдущих версиях агента обновление операционной системы Windows могло приводить к изменению HWID и появлению дубликатов устройств в веб-интерфейсе. С версии агента 5.8.2607 эта проблема была устранена. Дублирование устройств после обновления Windows более не происходит.

Последнее обновление: 02.04.26