10 KiB
Проверка MCP-вызовов серверов, событий и управления операциями
Сверены 15 вызовов раздела servers, два вызова dashboard и семь вызовов mcp с текущим реестром. В таблицах указано, где вызывается RouterOS, а где проверяется контракт MikrotikManager. Это аудит исходников. Результаты исполнения ниже приведены только для явно указанных тестов.
Серверы
| Вызов | Контракт и следующая проверка |
|---|---|
mm_servers_list |
Каталог БД с областью подключения и пагинацией. Проверить чужой ID и следующую страницу. |
mm_servers_create_plan |
План записи подключения в БД. Проверить привязку секрета к назначению, сохранённый ID и скрытие пароля. |
mm_servers_update_plan |
План обновления записи в БД. Проверить, что изменение endpoint инвалидирует старую привязку, а чужой сервер исключён. |
mm_servers_delete_plan |
План удаления записи MikrotikManager. Проверить зависимости и историю операции в отдельной БД. |
mm_servers_api_ping_settings_get |
Настройки приложения из БД. Проверить область доступа. |
mm_servers_api_ping_settings_update_plan |
План обновления enabled и intervalSec в приложении. При применении обновляется расписание. Само редактирование настройки не изменяет конфигурацию RouterOS. |
mm_server_snapshots_get |
Снимки выбранного сервера из БД. Проверить предел, порядок и отказ для чужого сервера. |
mm_server_source_address_get |
Разрешение управляющего host на стороне приложения. Ответ явно содержит interfaceAddressVerified:false. |
mm_server_wan_runtime_get |
GET /rest/ip/dhcp-client, /rest/ip/address, /rest/ip/route. Проверить фильтрацию IPv4/main, связь шлюза с интерфейсом и отсутствие заявления о forwarding. |
mm_server_test_connection_plan |
После одобрения два GET /rest/system/identity и /rest/system/resource по закреплённому адресу. Проверить ограничения перенаправлений, DNS и подтверждённую идентичность. |
mm_server_poll_plan |
План глобального опроса и обслуживания. Четыре GET к синтетическому RouterOS подтверждены отдельно. Подробный аудит |
mm_server_probe_plan |
После одобрения: bounded POST /rest/tool/ping, /rest/tool/traceroute или /rest/tool/bandwidth-test; route использует GET /rest/ip/route; DNS выполняет Manager. MTU использует ping с count=1, interval=0.2s, конкретным size и do-not-fragment=true. Каждую ветвь проверять раздельно. |
mm_server_probe_receipt_get |
Читает ограниченную часть подтверждённой квитанции из БД. Проверить привязку к операции, область доступа и хеш. |
mm_server_probe_cancel |
Сигнал отмены в приложении. Проверить квоту и остановку последующих стадий. |
mm_server_terminal_diagnostic |
Типизированный список ниже. Проверить каждую ветвь, отзыв доступа, предел вывода и маскирование. |
Маппинг исходников. Серверы и события · Подключение · WAN · Исполнение проб · Клиент RouterOS
Документация RouterOS для нативных путей выше. REST API · DHCP · Адреса · Маршруты · Ping · Traceroute · Bandwidth Test
Варианты терминала
help работает локально. addresses, interfaces, identity, resources, routes, firewall_filters, bgp_sessions и bfd_sessions используют соответственно GET /ip/address, /interface, /system/identity, пару /system/resource и /system/identity, /ip/route, /ip/firewall/filter, /routing/bgp/session и /routing/bfd/session. Меню здесь указаны без REST-префикса. logs читает буфер через GET /log?buffer=memory&.proplist=.id,time,topics,message. ping отправляет POST /tool/ping с адресом, заданным числом проб и интервалом 0.2s. Диспетчер команд · REST API · Log · BFD
ospf_neighbors, ospf_areas, ospf_instances и ospf_interfaces читают /routing/ospf/neighbor, /routing/ospf/area, /routing/ospf/instance и /routing/ospf/interface-template. При отсутствии данных для проекции возможны дополнительные POST /get и /print; для шаблонов парные запросы /print проверяют passive. Ветка с отсутствующим полем проверяется отдельно от обычного GET. REST API · OSPF в RouterOS v7 · Шаблоны OSPF
События и управление
| Вызов | Контракт и следующая проверка |
|---|---|
mm_events_list |
Чтение событий MikrotikManager с глобальной областью. |
mm_events_batch_append_plan |
План добавления пакета событий в БД. Проверить одобрение, атомарность и подтверждённое число записей. |
mm_capabilities_get |
Каталог по правам текущего подключения. Проверить системные и выданные права. |
mm_change_get |
Чтение собственного плана с проверкой области. |
mm_change_cancel |
Перевод допустимого незапущенного плана в cancelled и запись аудита. Его регистрация как read не делает операцию чистым чтением для тестового журнала. |
mm_change_apply |
Принимает только план и ключ идемпотентности. Нативные вызовы зависят от сохранённых шагов плана. Проверить одобрение, сохранённый ID операции и отсутствие повторной записи. |
mm_operation_get |
Чтение существующей операции и её шагов из БД. |
mm_operation_reconcile |
Сетевая сверка по типу операции и сохранённым шагам. Проверять нативные чтения конкретного действия, точное состояние и отсутствие повторной записи. |
mm_global_operation_reconcile |
Сверка поддержанных глобальных сервисов по имеющимся квитанциям. Проверять область и отсутствие повторного выполнения. |
Действия MCP · Сетевая сверка · Глобальная сверка · Пакет событий
Выполненные точечные проверки
Node 22 подтвердил контракт серверных проб в 140 модельных случаях. Локальный HTTP-стаб подтвердил ветви терминала, проверку формата, пределы и отмену. Второй локальный HTTP-тест подтвердил оба GET проверки подключения, закрепление endpoint, запрет redirect и маскирование. При первом запуске песочница не разрешила loopback. После этого повторены только два отказавших теста. Пробы · Терминал · Подключение