> For the complete documentation index, see [llms.txt](https://incy.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://incy.gitbook.io/docs/dokumentaciya-dlya-razrabotchikov/hwid-hardware-id.md).

# HWID (Hardware ID)

### Формат

HWID — hex-строка SHA-256 хеша, производная от аппаратных характеристик устройства с солью `incy_hwid_`.

### Генерация по платформам

#### Android

**Компоненты** (объединяются через `|`):

| Компонент     | Источник                     |
| ------------- | ---------------------------- |
| Android ID    | `Settings.Secure.ANDROID_ID` |
| Производитель | `Build.MANUFACTURER`         |
| Модель        | `Build.MODEL`                |
| Бренд         | `Build.BRAND`                |
| Устройство    | `Build.DEVICE`               |
| Продукт       | `Build.PRODUCT`              |
| Плата         | `Build.BOARD`                |
| Оборудование  | `Build.HARDWARE`             |

**Алгоритм:**

```
deviceId = SHA256("androidId|manufacturer|model|brand|device|product|board|hardware")
hwid = SHA256("incy_hwid_" + deviceId)
```

**Результат:** 64 символа (hex) **Хранение:** EncryptedSharedPreferences (сохраняется при переустановке)

#### Desktop (Linux)

**Компоненты** (объединяются через `|`):

| Компонент    | Источник                              |
| ------------ | ------------------------------------- |
| Machine ID   | `/etc/machine-id`                     |
| Hostname     | `InetAddress.getLocalHost().hostName` |
| OS           | `System.getProperty("os.name")`       |
| Архитектура  | `System.getProperty("os.arch")`       |
| Пользователь | `System.getProperty("user.name")`     |

#### Desktop (Windows)

**Компоненты** (объединяются через `|`):

| Компонент    | Источник                                           |
| ------------ | -------------------------------------------------- |
| Machine GUID | `HKLM\SOFTWARE\Microsoft\Cryptography\MachineGuid` |
| Hostname     | `InetAddress.getLocalHost().hostName`              |
| OS           | `System.getProperty("os.name")`                    |
| Архитектура  | `System.getProperty("os.arch")`                    |
| Пользователь | `System.getProperty("user.name")`                  |

**Алгоритм (Linux/Windows):**

```
deviceId = SHA256("machineId|hostname|os|arch|user")
hwid = SHA256("incy_hwid_" + deviceId)
```

**Результат:** 64 символа (hex) **Хранение:** файл `{configDir}/device_id`

#### iOS

**Компоненты:**

| Компонент      | Источник                               |
| -------------- | -------------------------------------- |
| Vendor ID      | `UIDevice.current.identifierForVendor` |
| Имя устройства | Модель устройства                      |

**Алгоритм:**

```
raw = "{vendorID}-{deviceName}"
deviceId = первые 16 символов hex-представления
```

**Результат:** 16 символов (hex) **Хранение:** Keychain (сохраняется даже при удалении приложения)

> iOS использует укороченный формат (16 символов) в отличие от Android/Desktop (64 символа).

### Использование

#### HTTP-заголовки запроса

При включённой отправке HWID приложение добавляет заголовки к запросам подписки:

```http
x-hwid: <hwid>
x-device-os: <platform>
x-ver-os: <os_version>
x-device-model: <model>
```

#### Premium API — проверка лимита устройств

При запросе конфигурации провайдера клиент передаёт хеш HWID:

```http
GET /api/subscription/config?h=<domainHash>&hwid=<sha256(hwid)>
```

Сервер использует `hwidHash` для проверки, зарегистрировано ли устройство у данного провайдера, и принятия решения о выдаче premium-статуса в рамках лимита устройств.

#### Поле `hwidHash` в регистрации

При регистрации устройства в Firestore помимо сырого `hwid` записывается поле `hwidHash = SHA256(hwid)`. Это позволяет серверу находить устройство по хешу без знания исходного идентификатора.

#### Принудительная отправка

Провайдер может включить принудительную отправку HWID через Premium API:

```json
{
    "settings": {
        "alwaysHwidEnable": true
    }
}
```

При этом пользователь не может отключить отправку HWID для данной подписки.

### Short HWID

Для отображения в UI используются первые 8 символов HWID.