Netpulse_SasS/server/migrations/0035_ident_rules.sql
byrsapty ed8fc831bf Дві сесії роботи: 0058–0068, розгортання однією командою, тести
Один коміт, а не десяток тематичних, свідомо: теми переплетені в
спільних файлах (store.go, docker-compose.yml, deploy/README.md), і
розділити їх можна було б лише індексуванням шматків. Коміти, які не
збираються, гірші за один великий — тим паче що це рівно той стан, який
перевірявся разом.

ЩО ПРАЦЮЄ НА СТЕНДІ Й ПЕРЕВІРЕНО ТАМ

  0058  подієві алерти: syslog, ncm, compliance спрацьовують у мить
        події; правило з нереалізованим джерелом більше не зберігається
        мовчки
  0059  snmp.walk і прототипи шаблонів — таблиці з динамічним індексом
        описуються шаблоном, а не Go
  0060  відкат конфігу: план як різниця, маскування паролів із підписом
        плану, обов'язковий контрольний збір, verifying при обриві
  0061  кнопки Telegram: довге опитування, авторизація не з callback_data
  0062  аудит і архів хостів; тест на AST, що падає на ключі без назви
  0063  RLS: три ролі, окремий пул для фонових тактів
  0064  строки зберігання даних і сторінка сховища
  0065  приймач SNMP-трапів; перевірено справжніми пакетами по дроту,
        переклад v1→v2 за RFC 3584 дає правильний OID
  0066  ескалації сповіщень
  0067  алерт про вичерпання диска
  0068  поля заливки конфігу переїхали в каталог профілів

Плюс: 137 тестів вебу з нуля (їх не було взагалі), одинадцять справжніх
вад, знайдених ними й виправлених, і виправлення двох інтеграційних
тестів grpcapi, які мовчки пропускались півтора року.

ЩО ЩЕ НЕ ЗАПУСКАЛОСЬ

  netpulse            установник: одна команда замість 18 змінних і
                      593 рядків інструкції
  RLS з першого запуску  нова інсталяція під політиками одразу;
                      RLS-EXISTING-INSTALL.md лишається тільки для
                      старих інсталяцій
  .forgejo + CI       раннер не зареєстрований

Ці три перевірені компіляцією й міркуванням, але не виконанням.

ГОЛОВНИЙ ВИСНОВОК ДВОХ СЕСІЙ

Зелена перевірка доводить рівно те, що вона перевіряє. Тест ізоляції RLS
був правильний і зелений — і пропустив зламаний вхід, бо перевіряв «чи
не видно чужого», коли зламалось «чи видно своє». Інтеграційні тести
grpcapi були зелені, бо не виконувались. Схема, довідник і протокол
описували те, чого в коді не існувало, і виглядало це як готове.

Тому в кожному завданні цих сесій стояла вимога назвати НЕПОКРИТЕ, а
чотири задачі закінчились не можливістю, а відмовою: правило з
нереалізованим джерелом не зберігається, профіль без команд заливки
каже про це замість мовчазної кнопки, міграція RLS валить сама себе на
таблиці без політики, тест словника аудиту падає на ключі без назви.

Подробиці — HISTORY.md, розділи за 26 і 27 серпня.
2026-08-27 17:32:49 +03:00

97 lines
5.4 KiB
SQL
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

-- =====================================================================
-- NetPulse :: 0035_ident_rules.sql
-- Модель і версія ПЗ визначаються самі. Таблиця правил переїжджає туди,
-- де їй місце.
--
-- Про переїзд. `ncm.profile_auto_assign` заводилась, щоб підбирати
-- профіль збору конфігу. Далі вона обросла `vendor`, потім `kind`, а
-- тепер ще й моделлю з версією — тобто давно перестала бути «про NCM» і
-- стала тим, чим є: правилами розпізнавання пристрою. Ім'я, яке бреше
-- про призначення таблиці, коштує дорожче за одну міграцію: наступний,
-- хто шукатиме, де система вирішує тип хоста, шукатиме де завгодно,
-- тільки не в схемі ncm.
--
-- Профіль лишається одним із наслідків правила, а не його метою.
--
-- Про модель і версію. Пристрій називає їх у sysDescr, але кожен
-- по-своєму, і жодного порядку в цьому немає:
--
-- Juniper Networks, Inc. ex4600-40f Ethernet Switch, kernel JUNOS 14.1X53-D27.3
-- ZXR10 ROS Version V4.6.02A ZXPON C320 Software, Version V1.2.5P3
-- S2326TP-EI / VRP (R) software,Version 5.70 (S2300 V100R006C01SPC100)
-- DGS-1100-06/ME/A1
--
-- Тому не спільний розбір, а зразок на правило: правило вже знає, з
-- ким має справу, бо дійшло до нього за OID і описом.
--
-- Зразки застосовує Go, а не Postgres: потрібні групи захоплення.
-- RE2 не має відкату, тож зразок із довідника не може підвісити збір
-- навіть якщо його напише людина.
-- =====================================================================
ALTER TABLE ncm.profile_auto_assign SET SCHEMA inv;
ALTER TABLE inv.profile_auto_assign RENAME TO ident_rules;
COMMENT ON TABLE inv.ident_rules IS
'Правила розпізнавання пристрою за sysObjectID і sysDescr: виробник, тип, модель, версія, профіль збору конфігу';
-- Порожній зразок означає «цього з опису не дістати» — так чесніше,
-- ніж підставити щось схоже й видавати за модель.
ALTER TABLE inv.ident_rules
ADD COLUMN model_regex text,
ADD COLUMN version_regex text;
COMMENT ON COLUMN inv.ident_rules.model_regex IS
'RE2 із однією групою захоплення; застосовується до sys_descr';
-- ---------------------------------------------------------------------
-- Зразки для вбудованих правил
-- ---------------------------------------------------------------------
-- ZTE OLT: «ZXPON C320 Software, Version V1.2.5P3».
UPDATE inv.ident_rules
SET model_regex = 'ZXPON\s+(\S+)\s+Software',
version_regex = 'Software,\s*Version\s+(\S+)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.3902' AND descr_regex IS NOT NULL;
-- ZTE решта: у ZXR10 модель стоїть одразу за іменем платформи.
UPDATE inv.ident_rules
SET model_regex = 'ZXR10\s+(\S+)',
version_regex = 'Version\s+(V\S+)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.3902' AND descr_regex IS NULL;
-- Juniper: «Juniper Networks, Inc. ex4600-40f ... kernel JUNOS 14.1X53-D27.3,».
UPDATE inv.ident_rules
SET model_regex = 'Juniper Networks, Inc\.\s+(\S+)',
version_regex = 'JUNOS\s+([^,\s]+)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.2636';
-- Huawei і H3C: модель у першому рядку, версія — у дужках, у вигляді
-- VxxxRxxx. Беремо саме її, а не «5.70»: у сервісі оперують релізом.
UPDATE inv.ident_rules
SET model_regex = '^\s*(\S+)',
version_regex = '(V\d{3}R\d{3}[A-Z0-9]*)'
WHERE tenant_id IS NULL AND oid_prefix IN ('1.3.6.1.4.1.2011', '1.3.6.1.4.1.25506');
-- D-Link /ME: «DGS-1100-06/ME/A1» — після /ME йде ревізія заліза, не
-- версія ПЗ. Версії в описі немає взагалі, і вигадувати її нема з чого.
UPDATE inv.ident_rules
SET model_regex = '^([A-Z]{3}-[0-9A-Za-z-]+/ME)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.171' AND descr_regex = '/ME';
-- Cisco: модель надійніше читається з sysObjectID, ніж з опису, тому
-- лише версія — «..., Version 15.0(2)SE11, RELEASE SOFTWARE».
UPDATE inv.ident_rules
SET version_regex = 'Version\s+([^,\s]+)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.9';
-- MikroTik: «RouterOS RB3011UiAS». Версію RouterOS в sysDescr не пише.
UPDATE inv.ident_rules
SET model_regex = 'RouterOS\s+(\S+)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.14988';
-- Eltex: «MES2324B ... version 4.0.14».
UPDATE inv.ident_rules
SET model_regex = '^\s*(MES\S*)',
version_regex = '(?i)version\s+([0-9][^\s,]*)'
WHERE tenant_id IS NULL AND oid_prefix = '1.3.6.1.4.1.35265';