Розробка веб-гаманця: де ламається безпека
Веб-гаманець працює в найворожішому середовищі з можливих: приватний ключ сусідить із браузером, сторонніми розширеннями та відкритим інтернетом.
Проблеми безпеки веб-гаманця майже завжди зводяться до трьох точок відмови — зберігання ключів у пам'яті сервісу, підпис транзакцій на боці клієнта та відсутність ізоляції підписувального вузла. Кожної з них достатньо окремо, щоб втратити кошти користувачів і довіру до продукту.
Найдорожчий сценарій — кастодіальне зберігання: ключ або мнемонічна фраза BIP-39 лежать у базі сервісу й осідають у дампах пам'яті, логах, бекапах і на тестових стендах. Витік приватних ключів незворотний — адреси не перевипустити, транзакції не відкликати.
Тому архітектура зберігання ключів проєктується так, щоб у відкритому вигляді секрет не існував ніде: шифротекст під паролем користувача, розділення секрету між вузлами, підпис усередині модуля, який ключ назовні не віддає.
Друга точка — підпис транзакцій на боці клієнта. Шкідливе розширення або впроваджений скрипт підміняє адресу отримувача між відображенням і підписом, і користувач затверджує те, чого не бачив на екрані.
Закривається це звіркою параметрів у довіреному шарі, перевіркою адреси за білим списком і явною забороною сліпого підпису.
Третя точка — відсутність ізоляції підписувального вузла. Коли підпис і прикладний шар живуть в одному процесі зі спільними правами, компроміс веб-частини одразу відкриває доступ до ключів.
Підпис виносять в окремий сервіс або апаратний модуль без прямого виходу в мережу, а рішення ухвалюється за політикою: кому дозволено, скільки операцій за добу, що потребує ручного підтвердження.
Нижче розбираємо, як ці точки закриваються схемою, правами доступу та експлуатаційними правилами.
Ефект впровадження: швидкість релізів і зняті ризики
Поки мережа одна, архітектура майже не впливає на темп. Щойно мереж стає три-чотири, кожна нова інтеграція тягне за собою правки в ядрі, окрему збірку та повний регрес — реліз з'їжджає до кінця циклу, а шанс зачепити чужий код зростає з кожною зміною.
Після переробки опис мережі винесено в декларативну конфігурацію: ядро залишається незмінним, а підключення нової мережі зводиться до набору параметрів і перевірок.
Це змінює одразу дві метрики. Термін виведення нової мережі скорочується з тижнів до кількох днів, а частка ручних операцій під час підключення падає: інженер більше не править код, а заповнює опис і проганяє автотести за типовим сценарієм приймання.
Зниження ризику компрометації тримається не на обіцянках, а на межі довіри. Ключі не покидають захищений контур, підпис транзакції виконується в ізольованому процесі, а клієнтська частина взагалі не має доступу до секретів.
Цілий клас відмов — витік ключа через інтерфейс або журнали — перестає існувати конструктивно, а не за рахунок фільтрів поверх попередньої схеми.
Час відновлення після збою стає передбачуваним. Стан і конфігурації версіонуються, відкат до попередньої робочої версії йде без міграції даних, тому сервіс повертається в стрій за хвилини, а не за години.
Окремо падає навантаження на підтримку: типові звернення — зависла транзакція, не та мережа, невідображений баланс — закриваються автоматичною діагностикою ще до того, як до них дійде черговий інженер.
Моделі зберігання ключів: порівняння та обмеження
Модель зберігання ключів визначає, хто керує коштами і що станеться при компрометації однієї зі сторін. Для веб-гаманця це не вибір «безпечно чи ні», а набір компромісів між зручністю входу, вартістю підпису та обсягом відповідальності сервісу.
| Варіант | Коли підходить | Обмеження |
|---|---|---|
| Кастодіальна модель зберігання | Сервіс підписує транзакції та відновлює доступ, користувачу потрібен лише вхід | Компрометація або збій сервісу обнуляє баланси всіх клієнтів одразу |
| Нестодіальний гаманець | Ключ зберігається в користувача, сервіс не торкається коштів | Втрата ключа незворотна, фішинг і шкідливі розширення б'ють по власнику напряму |
| Мультипідпис | Коштами керують кілька сторін за правилом m-з-n | Підпис дорожчий, склад учасників і ротацію ключів потрібно узгодити заздалегідь |
| Розділення ключа між сторонами | Потрібно прибрати єдину точку довіри: частини лежать у різних власників | Складання частин під час підпису — окремий ризик, потрібен регламент відновлення |
| Апаратний модуль підпису | Ключ не покидає модуль, підпис виконується всередині периметра | Залізо та його супровід, межа за масовими операціями, складніші оновлення |
На практиці схеми комбінують: нестодіальний гаманець з апаратним модулем підпису класу FIPS 140 закриває і зберігання, і підпис, а мультипідпис поверх розділення ключа знімає залежність від одного власника.
Ми фіксуємо обрану модель в архітектурі до першого рядка коду — інакше зміна схеми пізніше переписує весь шар підпису.
Розробка веб-гаманця: етапи інженерної роботи
Етапи йдуть по порядку: схема підпису визначає, які середовища та ключі ізолювати, а від них залежить набір сценарних перевірок. Нижче — типовий маршрут для веб-гаманця, де приватні ключі не покидають пристрій користувача або виділений модуль зберігання.
- Аудит інфраструктури гаманця. Розбираємо поточний контур: де живуть ключі, хто до них має доступ, як видаються ролі, що потрапляє до журналу. Результат — карта довіри та перелік місць, де підпис можна перехопити або підмінити транзакцію.
- Проєктування схеми підпису та ролей. Обираємо модель: ключ на пристрої користувача, порогова схема з кількома зберігачами або виділений модуль підпису на боці сервісу. Фіксуємо, де потрібне друге підтвердження, а де операція йде автоматично.
- Налаштування середовищ. Розділяємо розробку, тестову мережу та робочий контур так, щоб тестові ключі не потрапляли в робоче середовище. Конфігурація, доступи та секрети лежать в одному місці й версіонуються.
- Сценарні та навантажувальні перевірки. Проганяємо відновлення доступу, зміну пристрою, відхилену транзакцію, одночасні підписи з кількох вкладок. Окремо — поведінка при відмові вузла мережі та затримці відповіді.
- Плавний випуск. Відкриваємо доступ частці користувачів і стежимо за часткою успішних підписів і відмовами на боці мережі. Ліміти на суму операції та частоту підписання увімкнені з першого дня.
- Передача та навчання команди. Розгортаємо збірку та випуск на вашому боці, передаємо документацію щодо схеми підпису та ролей плюс регламент реагування на інциденти. Розбираємо з інженерами ротацію ключів.
Комплект передачі: конфігурації, схеми, регламенти
Передача гаманця — це не архів вихідного коду, а робочий контур, який команда замовника піднімає та супроводжує без нас. Комплект збираємо так, щоб розгортання нового середовища вимірювалося годинами, а перша відповідь на інцидент не потребувала дзвінка авторові.
- Конфігурації середовищ — параметри мережі, ліміти комісій, список активів і адреси вузлів для тестового, передпродуктивного та робочого контуру. Копія стенда піднімається заміною значень, без правок коду.
- Схеми потоків підпису — де формується ключ, де зберігається закрита частина, як підписується транзакція і які перевірки стоять на вході та виході. За схемою видно, що ключовий матеріал не покидає захищений контур.
- Політики доступу та ролі — хто дивиться баланси, хто ініціює виведення, хто підтверджує операцію. Права видаються за мінімумом, потрібним для ролі, а не «про всяк випадок» — новий співробітник не отримує зайвих можливостей.
- Регламент реагування на інциденти — кроки при підозрі на компрометацію ключа, сплеску нетипових операцій або відмові зовнішнього сервісу: хто зупиняє операції, як фіксується рішення і чим підтверджується повернення до штатного режиму.
- Інструкції для підтримки — розбір типових звернень, що дивитися в журналах подій, які помилки користувач закриває сам і коли звернення йде черговому інженеру.
- Порядок ротації ключів і відновлення з резервних копій — з періодичністю, зонами відповідальності та обов'язковою перевіркою на стенді до бойового застосування.
Кейс: як прибрали клас відмов і прискорили релізи
Роздрібний криптосервіс із некастодіальним гаманцем Aurora Wallet випускав оновлення раз на два тижні: збірка, ручна звірка адрес контрактів, підпис збірок і викладка в продакшн ішли за чек-лістом із 42 пунктів.
При паралельному підписі з кількох пристроїв стан сесії розходився, і частина транзакцій залипала в черзі на підтвердження — розбір такого випадку займав у підтримки до доби.
Метрики до і після
| Метрика | До | Після |
|---|---|---|
| Ручні операції під час випуску | 42 кроки за чек-лістом | 4 перевірювані кроки |
| Час випуску оновлення | близько двох днів | 40 хвилин |
| Шляхи, покриті автотестами | 35% | 88% |
| Залипання при паралельному підписі | 3-5% операцій | 0 за період спостереження |
| Відкат на попередню версію | близько двох годин | хвилини |
Що змінили по суті: підпис винесли в ізольований модуль з однозначною побудовою даних підпису, а операції перевели на журнал із захистом від повторів — повторний запит з тим самим ідентифікатором не створює другої транзакції.
Конфігурацію мережі та адреси контрактів описали декларативно, тому середовище піднімається з репозиторію без ручних правок, а прогін на тестовій мережі став обов'язковим етапом перед продакшном.
Усунений клас відмов — розсинхрон стану при одночасному підписі — більше не відтворюється ні в тестовій мережі, ні в продакшні.
Випуск перестав бути подією з нічним чергуванням: команда викочує зміни в міру готовності та відкочує їх за хвилини, якщо метрики розходяться з очікуваними.
Що робити, якщо гаманець уже запущений і працює?
Працюючий гаманець переводиться на нову схему зберігання без зупинки сервісу: поряд піднімається паралельний контур, а не заміна бойового.
Користувачі продовжують входити, отримувати адреси та підписувати транзакції — на їхньому боці не змінюються ні інтерфейс, ні резервна фраза, ні список адрес. Перенесення йде фоном, партіями, поки старий контур залишається джерелом істини.
Приватні ключі користувачів при цьому не перестворюються — інакше змінилися б адреси та баланси.
Змінюється шар зберігання та підпису: секрети перешифровуються під новим кореневим ключем, і кожен перенесений елемент перевіряється тим, що розшифрований ключ дає попередню публічну адресу.
Не зійшлася перевірка — елемент повертається до старої схеми та розбирається окремо, решта партії йде далі.
Ротація ключів іде поетапно: нові ключі шифрування сховища та сервісного підпису вводяться в роботу, а старі на час вікна перенесення залишаються доступні лише для читання.
Сумісність із поточним гаманцем тримається за рахунок приймання обох форматів — раніше випущені збірки клієнта продовжують підписувати та не потребують оновлення в день перемикання.
Перемикання робимо за групами користувачів, а не разом: новий контур спочатку працює на тіньовому трафіку, де результати підпису в двох режимах порівнюються побайтово, і розходження зупиняє розкатку до розбору.
Відкат — зворотне перемикання на боці сервісу, при якому ключі в попередній схемі залишаються валідними, тому жодна операція користувача не втрачається. Після звірки та періоду спостереження старий контур виводиться з експлуатації.
Технічні питання: безпека, інтеграції, аудит
Сумніви замовника зводяться до чотирьох тем: де живуть ключі, що відбувається при збої мережі, як перевіряється інтеграція і що потрапляє до звіту перед випуском. Нижче — короткі відповіді з кожної.
Де зберігаються приватні ключі і що буде при компрометації пристрою?
Ключ не покидає клієнтську частину: підпис збирається локально, на сервер іде лише підписана транзакція. Для підвищених вимог підключаємо зовнішній модуль підпису або апаратний гаманець — тоді доступу до браузера недостатньо, щоб підписати переказ.
Як перевіряється інтеграція з мережами і що при недоступності вузла?
Кожну мережу обслуговують кілька незалежних вузлів із перемиканням при відмові, статус транзакції звіряємо за кількома джерелами, а не за однією відповіддю. До випуску проганяємо затримки підтвердження та повторне надсилання — це часте джерело «зниклих» балансів.
Що входить до перевірки коду та інфраструктури перед випуском?
Розбір коду сторонніми фахівцями, перевірка залежностей, тести відновлення доступу та сценарії відкату, ревізія прав на сервери та секрети. Окремо переконуємося, що журнали не містять ключів і мнемонічних фраз — типовий витік при неакуратному записі.
Хто має доступ до інфраструктури і як виходять оновлення?
Доступ видаємо за мінімумом необхідного, з двофакторною перевіркою та журналом дій; виведення коштів потребує підтвердження кількох підписантів. Оновлення йдуть на тестову мережу, потім на обмежену групу, потім на всіх — відкат займає хвилини.
Обговоримо задачу і повернемося з оцінкою та планом
Щоб повернутися з оцінкою та планом робіт, а не із загальними формулюваннями, нам потрібен мінімальний технічний контекст щодо гаманця. Чим точніші ввідні, тим менше припущень у кошторисі та в термінах. Нижче — що корисно надіслати одразу і що ми уточнимо на першій розмові.
- Підтримувані мережі та активи: нативні монети, токени, чи потрібні читання балансів і історії операцій за адресами або лише підпис і надсилання.
- Модель ключів: де зберігається закритий ключ — у користувача на пристрої чи на боці сервісу, чи потрібні апаратні гаманці та відновлення доступу.
- Вимоги безпеки: багатофакторна автентифікація, ліміти на операції, журналювання, перевірка адреси отримувача, правила зберігання персональних даних.
- Користувацькі сценарії: створення та імпорт гаманця, надсилання, внутрішній обмін, підключення до зовнішніх сервісів через підпис повідомлень.
- Зовнішні інтеграції: свої або сторонні вузли мережі, провайдери котирувань, платіжні сервіси, наявна авторизація та інфраструктура.
- Обмеження: браузерне розширення, вебзастосунок або мобільний веб, список підтримуваних браузерів, вимоги до доступності.
- Поточний стан: прототипи, дизайн, напрацювання з коду, раніше проведений аудит безпеки.
Далі ми повертаємося з оцінкою за етапами, складом команди під ваш обсяг і зрозумілим планом: провідний інженер блокчейн-напряму, розробка клієнтської та серверної частини, фахівець із безпеки, тестувальник.
Формат співпраці — ітерації з показом результату в кінці кожної, доступ до репозиторію та завдань, зміну обсягу фіксуємо письмово.
Опишіть задачу у вільній формі — повернемося з оцінкою та планом робіт.







