🔒 Настройка локальных сертификатов

Локальные сертификаты позволяют безопасно подключать ваши сервисы Barfinex к Studio.Barfinex в режиме разработки. Эта инструкция покажет, как быстро настроить HTTPS для локальных окружений, чтобы избежать ошибок браузера и обеспечить корректную работу всех инструментов.

Зачем это нужно?

Наше приложение Studio.Barfinex работает по HTTPS.

👉 Чтобы подключать к нему локальные сервисы (provider, detector, inspector) и отображать данные в браузере, они тоже должны быть доступны по HTTPS.

Если сервис работает только на HTTP, браузер блокирует подключение (mixed content error).

Поэтому мы настраиваем локальные сертификаты.

Почему это безопасно?

Сертификаты создаются локально через mkcert.
Браузер доверяет этим сертификатам, потому что mkcert добавляет локальный CA в систему.
Studio.Barfinex не проксирует и не кэширует данные — торговые данные остаются только у клиента.

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

🔹 Установка

1. Установи `mkcert`

Windows

# download mkcert binary
cd ...\app-provider

Invoke-WebRequest `
  -Uri "https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-windows-amd64.exe" `
  -OutFile "mkcert.exe"

.\mkcert.exe -install

или

# скачать исполняемый файл mkcert
curl -L -o mkcert.exe https://github.com/FiloSottile/mkcert/releases/download/v1.4.4/mkcert-v1.4.4-windows-amd64.exe
.\mkcert.exe -install

macOS

brew install mkcert nss
mkcert -install

Linux (Ubuntu/Debian)

sudo apt install libnss3-tools
mkcert -install

2. Сгенерируй сертификаты вручную

В корне проекта выполни:

mkcert -key-file cert/localhost+2-key.pem -cert-file cert/localhost+2.pem "localhost" "127.0.0.1" "::1"

После выполнения появится папка:

cert/
├── localhost+2.pem
└── localhost+2-key.pem

3. Настрой `.env.local`

Создай или обнови файл .env.local в проекте:

APP_MODE=local
SSL_KEY=./cert/localhost+2-key.pem
SSL_CERT=./cert/localhost+2.pem

4. Запусти сервис

npm run start:dev

В консоли увидишь:

✅ HTTPS включён (сертификаты загружены)
🚀 API is running on: https://localhost:8101/api
📘 Swagger docs: https://localhost:8101/api/docs

Теперь данные из твоих локальных сервисов могут безопасно отображаться на https://studio.barfinex.com.