From 610b1870772b168b56ad391bcfe883dc8cbfe4fa Mon Sep 17 00:00:00 2001 From: Denozordec Date: Sat, 21 Nov 2026 15:12:39 +0700 Subject: [PATCH] =?UTF-8?q?chore(docs):=20IPsec=20=E2=80=94=20=D1=81=D0=BE?= =?UTF-8?q?=D0=B2=D0=BC=D0=B5=D1=81=D1=82=D0=B8=D0=BC=D0=BE=D1=81=D1=82?= =?UTF-8?q?=D1=8C=20=D1=81=20RouterOS=207.24=20=D0=B8=20=D0=B3=D0=B5=D0=BD?= =?UTF-8?q?=D0=B5=D1=80=D0=B0=D0=BB=D1=8C=D0=BD=D0=B0=D1=8F=20=D1=80=D0=B5?= =?UTF-8?q?=D0=BF=D0=B5=D1=82=D0=B8=D1=86=D0=B8=D1=8F=20=D0=BD=D0=B0=20?= =?UTF-8?q?=D1=81=D1=82=D0=B5=D0=BD=D0=B4=D0=B5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- docs/mcp-completion-plan.md | 2 +- docs/mcp-current-progress.json | 26 +++++++++++++++++--- docs/mcp-ipsec-call-audit-20261114.md | 2 ++ docs/mcp-stand-run-a-plan.md | 35 ++++++++++++++++++++++++++- 4 files changed, 60 insertions(+), 5 deletions(-) diff --git a/docs/mcp-completion-plan.md b/docs/mcp-completion-plan.md index b5f77a61..f2300559 100644 --- a/docs/mcp-completion-plan.md +++ b/docs/mcp-completion-plan.md @@ -101,7 +101,7 @@ - [ ] IPsec: новый MCP-сценарий `mm_ipsec_*` с подтверждением, трафиком и SA на стенде CHR (единственный прежний сценарий `tmp/ipsec-network82.mjs` октябрьский и идёт через REST приложения, не MCP) - 2026-11-21: сценарий написан и отрепетирован (`tmp/mcp-stand-ipsec-20261121/`). Решение владельца: CHR1 — сервер только через MCP, CHR2 — клиент как REST-фикстура. Найдены два дефекта продукта: - **счётчики `/interface` в доказательстве инициализации** — исправлено в `28738785`, `mmapp-test` переведён на этот backend; - - **`comment` у `/certificate`**, которого RouterOS 7.24.5 не принимает: инициализация останавливается на первой записи. Не исправлено, ждёт решения владельца. + - **несовместимость с RouterOS 7.24.5** (`comment` у сертификатов, подпись и экспорт только по `.id`, поля после подписи, `address` peer, ID файлов `**…`) — исправлено в `e7eb108c` по решению владельца; генеральная репетиция на CHR прошла (туннель, ping 10/10, рост SA, 66/66), приёмочный прогон через MCP ждёт нового образа. - Подробности в `mcp-stand-run-a-plan.md`, раздел «IPsec через MCP». - [x] Нестабильные сценарии Edge (39 из 41 без повтора) — 2026-11-21, по решению D11 (5 повторов подряд): `npm run test:mcp` из корня (Node 25.5.0, Playwright `playwright.mcp.config.ts`, Edge, `retries: 0`) пять раз подряд, в каждом 4 из 4 node-тестов и 43 из 43 сценариев Edge, ни одного повтора и ни одного flaky. Набор вырос с 41 до 43 сценариев; причина исторических отказов не установлена, повторы показывают только текущую стабильность. Подробности в `mcp-stand-run-a-plan.md`, фаза 6 - [x] Нестабильные сценарии маршрутизации (203 из 205 без повтора) — 2026-11-21, по решению D11: набор из 205 тестов восстановлен по `stage-local-tests.log` (17 файлов, точная команда в `mcp-stand-run-a-plan.md`, фаза 6) и пройден пять раз подряд, каждый раз 205 из 205, отказов 0. Оба прежних отказа (`scoped transport fixes one PATCH…`, `ignores DHCP lease countdown…`) проходят diff --git a/docs/mcp-current-progress.json b/docs/mcp-current-progress.json index 4ff87ceb..7148307a 100644 --- a/docs/mcp-current-progress.json +++ b/docs/mcp-current-progress.json @@ -13837,7 +13837,7 @@ }, "ipsecMcpScenario20261121": { "item": "IPsec: MCP-сценарий mm_ipsec_* на стенде CHR", - "outcome": "blocked-by-product-defect", + "outcome": "fixed-awaiting-acceptance-image", "runner": "tmp/mcp-stand-ipsec-20261121/", "decision": "CHR1 responder only through MCP with UI approvals; CHR2 initiator as REST fixture (owner 2026-11-21)", "fixedDefect": { @@ -13852,8 +13852,28 @@ "what": "RouterOS 7.24.5 /certificate has no comment: PUT with comment -> HTTP 400 unknown parameter comment; product creates CA/server/client certificates with comment and owns certificates by comment", "run": "runs/2026-11-21-3dcfd8ae", "operation": "unknown/inconclusive/MUTATION_OUTCOME_UNKNOWN, confirmedWrites 0", - "standClean": true + "standClean": true, + "fixed": "e7eb108c" }, - "accessRevoked": true + "accessRevoked": true, + "routerOs724Fixes": [ + "no comment on /certificate; certificates owned by name and signing chain", + "sign by .id with ca only", + "export-certificate by .id", + "authority and digest-algorithm change on sign", + "peer any-address omitted in REST rows", + "file ids **" + ], + "dressRehearsal": { + "serverInitCommands": 13, + "pskClientCommands": 2, + "projectionMismatches": 0, + "tunnel": true, + "ping": "10/10", + "saGrowthAllFour": true, + "cleanup": "21 deleted, 0 remaining", + "reconciliation": "66/66 both", + "acceptance": false + } } } diff --git a/docs/mcp-ipsec-call-audit-20261114.md b/docs/mcp-ipsec-call-audit-20261114.md index 185b6119..374a461d 100644 --- a/docs/mcp-ipsec-call-audit-20261114.md +++ b/docs/mcp-ipsec-call-audit-20261114.md @@ -46,4 +46,6 @@ 3. **Неполное воспроизведение снимка.** `mm_ipsec_revision_restore_plan` ограничен режимами `pre-shared-key` и `digital-signature`. Отсутствующий policy или mode-config останавливает восстановление: снимок не содержит необходимых `template`/`group`/`action`/`tunnel`/`peer` либо `responder`/`address-prefix-length`. Изменение прежнего `peer.certificate` отклоняется; актуальный сертификат задаётся в identity. Неизвестный PSK новой записи также блокирует план. Профили, proposals и сертификаты проверяются как зависимости, создание их тем же restore не предусмотрено. [Peer CLI](https://manual.mikrotik.com/docs/cli-reference/ip/ipsec/peer/), [Identity CLI](https://manual.mikrotik.com/docs/cli-reference/ip/ipsec/identity/), [Policy CLI](https://manual.mikrotik.com/docs/cli-reference/ip/ipsec/policy/), [Mode config CLI](https://manual.mikrotik.com/docs/cli-reference/ip/ipsec/mode-config/), [ограничения снимка](../backend/src/services/ipsec-revision-restore-model.ts#L48). 4. **Rename и состояние туннеля.** Проверяющий ожидает, что после `PATCH` имени peer RouterOS автоматически обновит ссылки identity и статических policy, и останавливается, если чтение этого не подтверждает. Это ожидание реализации, отдельного обещания в CLI-описании не найдено. `mm_ipsec_state_get` читает `active-peers`, но не `installed-sa`, и возвращает `dataPlaneVerified=false`. Живое переименование и трафик здесь не проверялись. [Peer CLI](https://manual.mikrotik.com/docs/cli-reference/ip/ipsec/peer/), [IPsec](https://manual.mikrotik.com/docs/virtual-private-networks/ipsec/), [проекция rename](../backend/src/services/ipsec-peer-update.ts#L66), [составные каталоги](../backend/src/modules/mcp/vpn-catalog-actions.ts#L48). +**Поправка 2026-11-21 (живой RouterOS 7.24.5).** Описанные выше тела сертификатов на этой версии не работают: `PUT /certificate` отклоняет `comment`; `sign` и `export-certificate` принимают сертификат только по `.id` и отклоняют `name` и `days-valid`; подпись меняет `authority` и `digest-algorithm`; peer с `address=0.0.0.0/0` возвращается без `address`; ID файлов имеют вид `**`. Исправлено в `e7eb108c`: сертификаты создаются без `comment` и опознаются по имени и цепочке подписи, подпись идёт телом `{ ".id", ca }`, экспорт — `{ ".id", type, file-name, export-passphrase }`. Подробности и генеральная репетиция на стенде — `mcp-stand-run-a-plan.md`, раздел «IPsec через MCP». + На одноразовой PostgreSQL с локальным HTTP-стабом REST и MCP отправили одинаковый SAN `IP:2001:db8::10`. Некорректный IPv4 отклонён как `INVALID_INPUT` в MCP и HTTP 400 в REST до первой записи. [Локальная приёмка инициализации](../backend/src/modules/mcp/ipsec-server-init-acceptance.ts). diff --git a/docs/mcp-stand-run-a-plan.md b/docs/mcp-stand-run-a-plan.md index 4a19b9b6..a6a4c65f 100644 --- a/docs/mcp-stand-run-a-plan.md +++ b/docs/mcp-stand-run-a-plan.md @@ -501,7 +501,7 @@ o route to host; при этом остаются требования 0 отв - Образ Gitea 2749 `sha256:5fa33d44…`. На `mmapp-test` заменён только backend (`mcp-28738785`), frontend остался `mcp-29998815`: изменений в нём нет. Резервная копия БД и `.env` лежит в `/root/backups/…-pre-28738785-…`. - После замены 4 репетиции из 4 подготовили план с первой попытки. -**Дефект 2 — не исправлен, нужно решение владельца.** +**Дефект 2 — исправлен в `e7eb108c` по решению владельца (см. ниже).** - Прогон `runs/2026-11-21-3dcfd8ae` дошёл до применения `server_init`: - контрольный ping до туннеля 0 из 3; @@ -518,6 +518,39 @@ o route to host; при этом остаются требования 0 отв - в БД осталась операция `unknown` с `needsReview`, незавершённых операций и открытых планов нет. - Доступы закрыты: подключение `a4-ipsec` отозвано, MCP выключен, `a3-agent` отключена (23 сессии отозваны), токен удалён из переменных. +**Совместимость с RouterOS 7.24.5: пробы и исправление `e7eb108c` (решение владельца «исправить в продукте»).** + +Пробы на CHR1 под `claude` с именами-маркерами (каждая с удалением и проверкой отсутствия) нашли расхождения продукта с RouterOS 7.24.5: + +| Что шлёт продукт | Ответ RouterOS 7.24.5 | Исправление | +| --- | --- | --- | +| `PUT /certificate` с `comment` | HTTP 400 `unknown parameter comment` | сертификаты создаются без `comment`; свой сертификат — `ipsec-ca` с CN `MikrotikManager IPsec CA`, `ipsec-server` и `ipsec-user-*`, подписанные `ipsec-ca`; если комментарий есть (старые версии), решает он | +| `POST /certificate/sign` с `name` и `days-valid` | HTTP 400 `unknown parameter days-valid`, без него `missing =.id=` | подпись по `.id` сертификата, созданного и подтверждённого этим же прогоном, только с `ca`; срок задаёт шаблон | +| `POST /certificate/export-certificate` с `name` | HTTP 400 `unknown parameter name` | экспорт по `.id` (создание клиента, экспорт существующего сертификата, REST-путь `mikrotik.ts`) | +| проверка подписи ждёт неизменными все поля, кроме известного списка | подпись меняет `authority` и `digest-algorithm` | поля добавлены в общий список `ipsecSignedCertificateFields` | +| `PUT /ip/ipsec/peer` с `address=0.0.0.0/0` | строка возвращается без `address` | отсутствующий `address` peer равен `0.0.0.0/0` при проверке созданного объекта и в значении состояния | +| чтение `/file` | ID вида `**Qb24a2…` (base62, регистр значим) | общий помощник `isRouterOsNativeId`, ключ дублей без сворачивания регистра для `**`; без этого отказывало создание любого клиента IPsec | + +- Стабы приёмки (`ipsec-server-init-acceptance.ts`, `ipsec-user-create-acceptance.ts`) отказывают так же, как RouterOS 7.24.5: старый код на них не проходит применение, новый проходит (`--module-completion --only=ipsec-init` и `--only=ipsec-create`). +- Версии операций подняты: `server_init` 5, `user_create` 3, экспорт существующего сертификата 2. +- Не проверено на стенде: выдача клиентских сертификатов, их экспорт и REST-путь `ipsec-ca.ts` (сценарий использует PSK). + +**Генеральная репетиция (не приёмка), `tmp/mcp-stand-ipsec-20261121/rehearse-product.mts`.** + +- Исправленные планировщики и проекции продукта из `backend/src` управляют CHR1 по REST под `claude` так, как шлют исправленные исполнители. Перед каждой записью и после неё значение состояния продукта сравнивается с повторным чтением. +- Итог последнего прохода: + - `server_init`: 13 команд (CA 4096 бит подписывается за 7–16 с), все сверки совпали; + - PSK-клиент: 2 команды, сверки совпали; + - туннель IKEv2 установлен, ping CHR1 → `198.18.246.10` 10 из 10; + - рост `current-bytes` на всех четырёх SA (сервер 560, клиент 504–560 байт, SPI попарно совпадают); + - очистка 21 строка, остатков 0, сверка 66/66 на обоих CHR. +- По ходу найдены и исправлены ошибки самой фикстуры и раннера (не продукта): + - шаблон клиента должен принимать `dst 0.0.0.0/0`: шаблон продукта отдаёт TSr `0.0.0.0/0`, и более узкий шаблон клиента ответил `TS_UNACCEPTABLE` (видно по отладочному логу IPsec; правило лога временное и удалено); + - `current-bytes` отсутствует, пока SA не нёс трафика, это 0; + - счётчики CHR2 отстают от последнего ответа: перед вторым чтением 2 с, критерий — рост не меньше одного пакета (56 байт) на каждом SA при ping 10 из 10; + - базовые `.id` CHR1 хранятся по меню, сертификаты продукта опознаются по имени и появлению после базы; + - после удаления IPsec-политик RouterOS возвращает `ipv4/ipv6-fast-path-active` с задержкой; перед финальным снимком раннер ждёт значения базы (до 120 с), только чтением. + ## Разбор `autosupout.rif` CHR2 (2026-11-19, скачивание разрешено владельцем) - Файл скачан только чтением (REST `/file/read` по 32 КБ, по документации MikroTik `get` отдаёт только файлы до 60 КБ): `tmp/chr2-supout-20261119/chr2-autosupout-20261008.rif`, 418 284 байт, sha256 `2e36109f71587e6002cf051b6d2f33a2f37259bd3e819ad5fe9897ce30b70192`, 85 разделов расшифрованы локально в `decoded/` (base64 с обратным порядком битов, затем zlib).