Миграция PDA на client.key

Dev_Docs/API/02_Authentication_API.md

@@ -11,7 +11,7 @@
 
 Логика раздела такая:
 
-- сначала клиент либо начинает создание новой сессии через `deviceKey`;
+- сначала клиент либо начинает создание новой сессии через `clientKey`;
 - либо начинает вход в уже созданную сессию через `sessionKey`;
 - сервер на первом шаге выдаёт challenge/nonce;
 - на втором шаге клиент присылает подписанный ответ;
@@ -55,7 +55,7 @@
 2. Вход в существующую сессию:
    `SessionChallenge` -> `SessionLogin`
 
-`deviceKey` используется для создания новой сессии.
+`clientKey` используется для создания новой сессии.
 
 `sessionKey` используется для входа в уже созданную сессию.
 
@@ -119,7 +119,7 @@ ed25519/BASE64_PUBLIC_KEY
     "storagePwd": "BASE64_OR_APP_SPECIFIC_SECRET",
     "timeMs": 1774600000123,
     "authNonce": "nonce",
-    "deviceKey": "BASE64_DEVICE_PUBLIC_KEY",
+    "clientKey": "BASE64_DEVICE_PUBLIC_KEY",
     "signatureB64": "BASE64_SIGNATURE",
     "sessionType": 1,
     "clientPlatform": "Web",
@@ -138,15 +138,15 @@ AUTH_CREATE_SESSION:{login}:{sessionKey}:{storagePwd}:{timeMs}:{authNonce}
 
 Перед проверкой подписи сервер должен:
 
-1. взять актуальный `solana_users.device_key`;
-2. сравнить его с `payload.deviceKey`;
+1. взять актуальный `solana_users.client_key`;
+2. сравнить его с `payload.clientKey`;
 3. только потом проверять подпись.
 
-Если ключ не совпадает, сервер возвращает ошибку `DEVICE_KEY_NOT_ACTUAL`.
+Если `clientKey` не совпадает, сервер возвращает ошибку `DEVICE_KEY_NOT_ACTUAL`.
 
 На будущее:
 
-- для ротации `device_key` желательно добавить перепроверку через Solana.
+- для ротации `client_key` желательно добавить перепроверку через Solana.
 
 ### Успешный ответ
 
@@ -172,15 +172,15 @@ AUTH_CREATE_SESSION:{login}:{sessionKey}:{storagePwd}:{timeMs}:{authNonce}
 - `501 / NO_LOGIN` — у пользователя на сервере не заполнен `login`.
 - `400 / EMPTY_STORAGE_PWD` — пустой `storagePwd`.
 - `400 / EMPTY_SESSION_KEY` — пустой `sessionKey`.
-- `422 / UNSUPPORTED_KEY_ALGORITHM` — префикс алгоритма в `sessionKey` или `deviceKey` не поддерживается текущим сервером.
-- `400 / BAD_BASE64` — неверный Base64 в `sessionKey`, `deviceKey` или `signatureB64`.
+- `422 / UNSUPPORTED_KEY_ALGORITHM` — префикс алгоритма в `sessionKey` или `clientKey` не поддерживается текущим сервером.
+- `400 / BAD_BASE64` — неверный Base64 в `sessionKey`, `clientKey` или `signatureB64`.
 - `400 / EMPTY_SIGNATURE` — пустая подпись.
 - `400 / TIME_SKEW` — время клиента отличается от серверного больше допустимого окна.
-- `400 / NO_DEVICE_KEY` — у пользователя в БД отсутствует `deviceKey`.
+- `400 / NO_DEVICE_KEY` — у пользователя в БД отсутствует `clientKey`.
 - `400 / EMPTY_AUTH_NONCE` — пустой `authNonce`.
 - `400 / AUTH_NONCE_MISMATCH` — `authNonce` не соответствует значению из `AuthChallenge`.
-- `400 / EMPTY_DEVICE_KEY` — в запросе не передан `deviceKey`.
-- `422 / DEVICE_KEY_NOT_ACTUAL` — `deviceKey` не совпадает с актуальной версией на сервере.
+- `400 / EMPTY_DEVICE_KEY` — в запросе не передан `clientKey`.
+- `422 / DEVICE_KEY_NOT_ACTUAL` — `clientKey` не совпадает с актуальной версией на сервере.
 - `422 / BAD_SIGNATURE` — подпись не прошла проверку.
 - `460 / SESSION_TYPE_MISMATCH` — `sessionType` не совпадает с типом сессии, уже опубликованным для этого `sessionKey` в Solana PDA.
 - `501 / SESSION_TYPE_PDA_CHECK_FAILED` — сервер не смог проверить `sessionType` по Solana PDA.
@@ -314,7 +314,7 @@ SESSION_LOGIN:{sessionId}:{timeMs}:{nonce}
 
 В этом потоке:
 
-- новое устройство не владеет `deviceKey` и не проходит обычный `CreateAuthSession`;
+- новое устройство не владеет `clientKey` и не проходит обычный `CreateAuthSession`;
 - пароль проверяется сервером только как фильтр;
 - решение об одобрении принимает уже авторизованная доверенная сессия пользователя;
 - сервер не расшифровывает `encryptedPayload` и не становится источником приватных ключей.