connect-sandbox — Подключение к песочнице API Честного знака

Статус: Активен

Описание

План действий для подключения к тестовому контуру (sandbox) API Честного знака (True API) и выполнения первого успешного запроса. Код приложения уже реализован — требуется выполнить шаги регистрации, получения тестового УКЭП и запуска.

Шаги

1. Регистрация в sandbox Честного знака

1.1. Перейти на портал sandbox: https://markirovka.sandbox.crptech.ru/
1.2. Зарегистрировать участника (юридическое лицо или ИП)
1.3. Создать тестовую учётную запись организации
1.4. Убедиться, что организация активна в sandbox

2. Получение тестового УКЭП

2.1. Перейти на testca2012.cryptopro.ru
2.2. Скачать тестовый сертификат для физического лица (или сгенерировать через КриптоПро CSP)
2.3. Установить сертификат в личное хранилище (Настройки → КриптоПро CSP → Сертификаты)
2.4. Убедиться, что сертификат имеет статус «Действителен»
2.5. Связать тестовый сертификат с зарегистрированной организацией в sandbox (если требуется)

3. Установка КриптоПро Browser Plugin

3.1. Скачать КриптоПро Browser Plugin: https://cryptopro.ru/products/cades/plugin
3.2. Установить плагин в браузер (поддерживаются Chrome, Firefox, Edge, Chromium)
3.3. Перезапустить браузер
3.4. Проверить установку: открыть chrome://plugins/ (или about:addons) — плагин должен быть активен

4. Настройка и запуск приложения

4.1. Склонировать репозиторий (если ещё не):
```
git clone <url>
cd chestno-api
```

4.2. Проверить конфигурацию backend/.env:

TRUE_API_URL=https://markirovka.sandbox.crptech.ru/api/v3/true-api
PUBLIC_CHECK_URL=https://mobile.api.crpt.ru/mobile/check

4.3. Запустить приложение:
```
docker-compose up --build
```
4.4. Проверить, что сервисы запущены:
- Backend: http://localhost:3002/health
- Frontend: http://localhost:3003

5. Авторизация в sandbox через приложение

5.1. Открыть http://localhost:3003
5.2. Убедиться, что страница авторизации показывает «КриптоПро Browser Plugin: Обнаружен»
5.3. Выбрать тестовый сертификат из списка
5.4. Нажать «Подписать и войти»
5.5. Проверить, что получен токен и отображается статус «Авторизован» с TTL

6. Проверка работоспособности

6.1. Ввести тестовый КМ на странице проверки кодов
6.2. Нажать «Проверить с авторизацией»
6.3. Убедиться, что возвращается полная информация о КМ (GTIN, статус, производитель, владелец)
6.4. Проверить публичную проверку (без авторизации) — должна работать всегда

Затрагиваемые сервисы

backend/.env — проверка/корректировка TRUE_API_URL на sandbox (уже установлен по умолчанию)
Внешние:
- testca2012.cryptopro.ru — тестовый УЦ для получения сертификата
- markirovka.sandbox.crptech.ru — sandbox API Честного знака
- КриптоПро Browser Plugin — расширение для браузера (CAdES)
- КриптоПро CSP — если требуется для установки сертификата

Примечания

Sandbox URL по умолчанию уже настроен в backend/.env — код менять не нужно
В sandbox доступны только тестовые коды маркировки (их можно получить в личном кабинете sandbox)
JWT-токены отключены с марта 2026 — приложение использует UUID-токены (unitedToken: true)
Для промышленного контура потребуется:
1. Реальный УКЭП юридического лица (ФНС/УЦ)
2. Регистрация в ГИС МТ как участник
3. Смена TRUE_API_URL на https://markirovka.crpt.ru/api/v3/true-api

5.3 KiB Raw Blame History