Один коміт, а не десяток тематичних, свідомо: теми переплетені в
спільних файлах (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 серпня.
218 lines
7.7 KiB
Go
218 lines
7.7 KiB
Go
package httpapi
|
||
|
||
import (
|
||
"encoding/json"
|
||
"errors"
|
||
"net/http"
|
||
|
||
"github.com/netpulse/netpulse/server/internal/store"
|
||
)
|
||
|
||
// Обмеження тіла запиту. Полотно на 1000 вузлів у патчі — це ~1 МБ;
|
||
// 8 МБ лишає запас і водночас не дає одним запитом з'їсти пам'ять.
|
||
const maxPatchBody = 8 << 20
|
||
|
||
func (s *Server) handleCreateMap(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:write")
|
||
return
|
||
}
|
||
|
||
var in struct {
|
||
Name string `json:"name"`
|
||
Slug string `json:"slug"`
|
||
Kind string `json:"kind"`
|
||
}
|
||
if !decodeBody(w, r, &in) {
|
||
return
|
||
}
|
||
|
||
m, err := s.store.CreateMap(r.Context(), p.TenantID, in.Name, in.Slug, in.Kind)
|
||
if err != nil {
|
||
s.writeStoreError(w, "створення мапи", err)
|
||
return
|
||
}
|
||
writeJSON(w, http.StatusCreated, m)
|
||
}
|
||
|
||
func (s *Server) handleDeleteMap(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:write")
|
||
return
|
||
}
|
||
|
||
if err := s.store.DeleteMap(r.Context(), p.TenantID, r.PathValue("id")); err != nil {
|
||
s.writeStoreError(w, "видалення мапи", err)
|
||
return
|
||
}
|
||
w.WriteHeader(http.StatusNoContent)
|
||
}
|
||
|
||
// handlePatchMap — редактор полотна.
|
||
func (s *Server) handlePatchMap(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:write")
|
||
return
|
||
}
|
||
|
||
var patch store.MapPatch
|
||
if !decodeBody(w, r, &patch) {
|
||
return
|
||
}
|
||
|
||
mapID := r.PathValue("id")
|
||
|
||
// Право «редагувати мапи» і право «редагувати ЦЮ мапу» — різні речі:
|
||
// друге дають групи доступу.
|
||
if level, err := s.store.MapAccess(r.Context(), p.TenantID, p.UserID, mapID); err == nil &&
|
||
level != "write" {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає доступу на запис до цієї мапи")
|
||
return
|
||
}
|
||
|
||
res, err := s.store.ApplyMapPatch(r.Context(), p.TenantID, mapID, "", &patch)
|
||
if err != nil {
|
||
s.writeStoreError(w, "збереження мапи", err)
|
||
return
|
||
}
|
||
|
||
// Інші відкриті полотна мають дізнатись про зміну: у NOC над однією
|
||
// мапою часто працюють кілька людей, і мовчазне розходження станів
|
||
// закінчується взаємним затиранням.
|
||
s.hub.BroadcastMapUpdate(p.TenantID, mapID, res.Revision)
|
||
|
||
writeJSON(w, http.StatusOK, res)
|
||
}
|
||
|
||
// handleBuildMap добудовує мапу з виявленої топології.
|
||
func (s *Server) handleBuildMap(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:write")
|
||
return
|
||
}
|
||
|
||
mapID := r.PathValue("id")
|
||
st, err := s.store.BuildFromTopology(r.Context(), p.TenantID, mapID, "")
|
||
if err != nil {
|
||
s.writeStoreError(w, "автопобудова мапи", err)
|
||
return
|
||
}
|
||
|
||
if st.NodesAdded > 0 || st.EdgesAdded > 0 {
|
||
s.hub.BroadcastMapUpdate(p.TenantID, mapID, st.Revision)
|
||
}
|
||
writeJSON(w, http.StatusOK, st)
|
||
}
|
||
|
||
// handleMapInterfaces — порти хостів мапи для ручного зіставлення.
|
||
//
|
||
// Право читання мапи, а не хостів: перелік імен портів пристроїв, які
|
||
// вже намальовані на цій мапі, нічого не додає до того, що людина
|
||
// й так бачить.
|
||
func (s *Server) handleMapInterfaces(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:read") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:read")
|
||
return
|
||
}
|
||
|
||
mapID := r.PathValue("id")
|
||
if level, err := s.store.MapAccess(r.Context(), p.TenantID, p.UserID, mapID); err == nil &&
|
||
level == "deny" {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає доступу до цієї мапи")
|
||
return
|
||
}
|
||
|
||
ifs, err := s.store.MapInterfaces(r.Context(), p.TenantID, mapID)
|
||
if err != nil {
|
||
s.writeStoreError(w, "порти мапи", err)
|
||
return
|
||
}
|
||
writeJSON(w, http.StatusOK, map[string]any{"interfaces": ifs})
|
||
}
|
||
|
||
// handleMapDiscover просить зібрати топологію з хостів цієї мапи.
|
||
//
|
||
// devices:write, а не maps:write: дія заводить хостам перевірку й
|
||
// змушує зонд їх опитати. Це зміна опитування, і той, кому дозволили
|
||
// лише малювати схеми, робити її не має.
|
||
func (s *Server) handleMapDiscover(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("devices:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права devices:write")
|
||
return
|
||
}
|
||
|
||
mapID := r.PathValue("id")
|
||
if level, err := s.store.MapAccess(r.Context(), p.TenantID, p.UserID, mapID); err == nil &&
|
||
level == "deny" {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає доступу до цієї мапи")
|
||
return
|
||
}
|
||
|
||
res, err := s.store.RequestMapDiscovery(r.Context(), p.TenantID, mapID, p.Scope())
|
||
if err != nil {
|
||
s.writeStoreError(w, "збір топології", err)
|
||
return
|
||
}
|
||
writeJSON(w, http.StatusOK, res)
|
||
}
|
||
|
||
// handleUndoMap відкочує полотно до попереднього знімка.
|
||
func (s *Server) handleUndoMap(w http.ResponseWriter, r *http.Request, p *Principal) {
|
||
if !p.Can("maps:write") {
|
||
writeError(w, http.StatusForbidden, "forbidden", "немає права maps:write")
|
||
return
|
||
}
|
||
|
||
mapID := r.PathValue("id")
|
||
res, err := s.store.UndoMap(r.Context(), p.TenantID, mapID, "")
|
||
if errors.Is(err, store.ErrNothingToUndo) {
|
||
writeError(w, http.StatusConflict, "nothing_to_undo", "історії змін ще немає")
|
||
return
|
||
}
|
||
if err != nil {
|
||
s.writeStoreError(w, "відкат мапи", err)
|
||
return
|
||
}
|
||
|
||
s.hub.BroadcastMapUpdate(p.TenantID, mapID, res.Revision)
|
||
writeJSON(w, http.StatusOK, res)
|
||
}
|
||
|
||
// ---------------------------------------------------------------------
|
||
|
||
func decodeBody(w http.ResponseWriter, r *http.Request, v any) bool {
|
||
dec := json.NewDecoder(http.MaxBytesReader(w, r.Body, maxPatchBody))
|
||
// Невідоме поле — майже завжди друкарська помилка в клієнті.
|
||
// Мовчки її проковтнути означає, що правка «збереглась», але
|
||
// не застосувалась.
|
||
dec.DisallowUnknownFields()
|
||
|
||
if err := dec.Decode(v); err != nil {
|
||
writeError(w, http.StatusBadRequest, "bad_body", "не вдалося розібрати тіло: "+err.Error())
|
||
return false
|
||
}
|
||
return true
|
||
}
|
||
|
||
func (s *Server) writeStoreError(w http.ResponseWriter, what string, err error) {
|
||
switch {
|
||
case errors.Is(err, store.ErrNotFound):
|
||
writeError(w, http.StatusNotFound, "not_found", "не знайдено")
|
||
|
||
case errors.Is(err, store.ErrConflict):
|
||
// 409 із поточною ревізією дозволяє клієнту перечитати мапу
|
||
// й повторити правку, а не втратити її.
|
||
writeError(w, http.StatusConflict, "revision_conflict", err.Error())
|
||
|
||
case errors.Is(err, store.ErrPlanLimit):
|
||
// 402 — саме те, що сталося: потрібен інший тариф.
|
||
writeError(w, http.StatusPaymentRequired, "plan_limit", err.Error())
|
||
|
||
case errors.Is(err, store.ErrInvalid):
|
||
writeError(w, http.StatusBadRequest, "invalid", err.Error())
|
||
|
||
default:
|
||
s.log.Error(what, "err", err)
|
||
writeError(w, http.StatusInternalServerError, "internal", "внутрішня помилка")
|
||
}
|
||
}
|