Netpulse_SasS/server/internal/store/enrollment.go
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

259 lines
8.3 KiB
Go
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.

package store
import (
"context"
"crypto/sha256"
"errors"
"fmt"
"time"
"github.com/jackc/pgx/v5"
"github.com/netpulse/netpulse/server/internal/auth"
)
// ErrEnrollmentInvalid — токен не існує, згорів або вже використаний.
//
// Одна помилка на всі три випадки навмисно: розрізняти їх у відповіді
// означало б підказувати тому, хто підбирає токени, наскільки він
// близько.
var ErrEnrollmentInvalid = errors.New("запрошення недійсне")
// EnrollmentTTL — скільки живе запрошення.
//
// Доба: людина копіює команду, йде до стійки й ставить агента. Довший
// строк перетворює запрошення на постійний ключ, який лежить у чиємусь
// чаті; коротший не переживає навіть обіду.
const EnrollmentTTL = 24 * time.Hour
// Enrollment — запрошення на реєстрацію зонда.
type Enrollment struct {
ID string `json:"id"`
Prefix string `json:"prefix"`
NameHint string `json:"name_hint,omitempty"`
Modules []string `json:"modules"`
ExpiresAt time.Time `json:"expires_at"`
UsedAt *time.Time `json:"used_at,omitempty"`
UsedBy string `json:"used_by,omitempty"`
AgentName string `json:"agent_name,omitempty"`
CreatedAt time.Time `json:"created_at"`
// Token заповнюється рівно один раз — у відповіді на створення.
Token string `json:"token,omitempty"`
}
// CreateEnrollment видає одноразовий токен.
func (s *Store) CreateEnrollment(ctx context.Context, tenantID, userID, nameHint string,
modules []string, ttl time.Duration) (*Enrollment, error) {
token, err := auth.NewToken("np_enr_")
if err != nil {
return nil, err
}
sum := sha256.Sum256([]byte(token))
if ttl <= 0 {
ttl = EnrollmentTTL
}
if len(modules) == 0 {
modules = []string{"icmp"}
}
e := &Enrollment{
Token: token,
Prefix: token[:min(len(token), 14)],
NameHint: nameHint,
Modules: modules,
ExpiresAt: time.Now().Add(ttl),
}
err = s.InTenantTx(ctx, tenantID, func(tx pgx.Tx) error {
return tx.QueryRow(ctx, `
INSERT INTO core.agent_enrollments
(tenant_id, token_hash, prefix, name_hint, modules, expires_at, created_by)
VALUES ($1, $2, $3, NULLIF($4,''), $5::core.slug[], $6, $7)
RETURNING id::text, created_at
`, tenantID, sum[:], e.Prefix, nameHint, modules, e.ExpiresAt, nullUUID(userID)).
Scan(&e.ID, &e.CreatedAt)
})
if err != nil {
return nil, err
}
return e, nil
}
// ListEnrollments — запрошення тенанта.
func (s *Store) ListEnrollments(ctx context.Context, tenantID string) ([]Enrollment, error) {
out := []Enrollment{}
err := s.InTenantTx(ctx, tenantID, func(tx pgx.Tx) error {
rows, err := tx.Query(ctx, `
SELECT e.id::text, e.prefix, COALESCE(e.name_hint,''), e.modules::text[],
e.expires_at, e.used_at, COALESCE(e.used_by::text,''),
COALESCE(a.name,''), e.created_at
FROM core.agent_enrollments e
LEFT JOIN core.agents a ON a.id = e.used_by
WHERE e.tenant_id = $1
ORDER BY e.created_at DESC
LIMIT 100
`, tenantID)
if err != nil {
return err
}
defer rows.Close()
for rows.Next() {
var e Enrollment
if err := rows.Scan(&e.ID, &e.Prefix, &e.NameHint, &e.Modules,
&e.ExpiresAt, &e.UsedAt, &e.UsedBy, &e.AgentName, &e.CreatedAt); err != nil {
return err
}
out = append(out, e)
}
return rows.Err()
})
return out, err
}
// DeleteEnrollment відкликає невикористане запрошення.
func (s *Store) DeleteEnrollment(ctx context.Context, tenantID, id string) error {
return s.InTenantTx(ctx, tenantID, func(tx pgx.Tx) error {
ct, err := tx.Exec(ctx,
`DELETE FROM core.agent_enrollments WHERE id = $1 AND tenant_id = $2`, id, tenantID)
if err != nil {
return err
}
if ct.RowsAffected() == 0 {
return ErrNotFound
}
return nil
})
}
// EnrolledAgent — те, що зонд отримує після реєстрації.
type EnrolledAgent struct {
ID string
Name string
Token string
}
// RedeemEnrollment обмінює одноразовий токен на постійний зонд.
//
// Уся операція в одній транзакції під `FOR UPDATE`: два агенти, що
// стартували з однієї команди встановлення (скопійований скрипт,
// повторний запуск), інакше створили б два зонди з одного запрошення.
//
// Токен зонда повертається один раз і в базі лежить лише хешем — так
// само, як refresh-токен сесії.
func (s *Store) RedeemEnrollment(ctx context.Context, token, hostname, requestedName,
version, osName, arch string) (*EnrolledAgent, error) {
sum := sha256.Sum256([]byte(token))
var (
enrollID, tenantID string
nameHint string
modules []string
siteID *string
createdBy *string
expires time.Time
usedAt *time.Time
)
// Без InTenantTx: тенант тут ще невідомий — саме його ми й
// з'ясовуємо з токена. RLS натомість не потрібна: вибірка йде за
// унікальним хешем, який знає лише той, кому його видали.
tx, err := s.bg.Begin(ctx)
if err != nil {
return nil, err
}
defer func() { _ = tx.Rollback(ctx) }()
err = tx.QueryRow(ctx, `
SELECT id::text, tenant_id::text, COALESCE(name_hint,''), modules::text[],
site_id::text, created_by::text, expires_at, used_at
FROM core.agent_enrollments
WHERE token_hash = $1
FOR UPDATE
`, sum[:]).Scan(&enrollID, &tenantID, &nameHint, &modules, &siteID,
&createdBy, &expires, &usedAt)
if errors.Is(err, pgx.ErrNoRows) {
return nil, ErrEnrollmentInvalid
}
if err != nil {
return nil, err
}
if usedAt != nil || time.Now().After(expires) {
return nil, ErrEnrollmentInvalid
}
name := firstNonEmpty(requestedName, nameHint, hostname, "зонд")
name, err = uniqueAgentName(ctx, tx, tenantID, name)
if err != nil {
return nil, err
}
agentToken, err := auth.NewToken("np_agt_")
if err != nil {
return nil, err
}
agentSum := sha256.Sum256([]byte(agentToken))
var agentID string
if err := tx.QueryRow(ctx, `
INSERT INTO core.agents
(tenant_id, site_id, name, token_hash, version, os, arch, hostname,
status, enabled_modules, enrolled_at, enrolled_by)
VALUES ($1, $2, $3, $4, NULLIF($5,''), NULLIF($6,''), NULLIF($7,''), NULLIF($8,''),
'pending', $9::core.slug[], now(), $10)
RETURNING id::text
`, tenantID, siteID, name, agentSum[:], version, osName, arch, hostname,
modules, createdBy).Scan(&agentID); err != nil {
return nil, err
}
if _, err := tx.Exec(ctx, `
UPDATE core.agent_enrollments SET used_at = now(), used_by = $2 WHERE id = $1
`, enrollID, agentID); err != nil {
return nil, err
}
if err := tx.Commit(ctx); err != nil {
return nil, err
}
return &EnrolledAgent{ID: agentID, Name: name, Token: agentToken}, nil
}
// uniqueAgentName підбирає вільне ім'я.
//
// Суфікс числом, а не відмова: людина, яка ставить п'ятий агент на
// однакових машинах, не має вигадувати імена — вона хоче, щоб він
// просто запрацював.
func uniqueAgentName(ctx context.Context, tx pgx.Tx, tenantID, base string) (string, error) {
name := base
for i := 2; i < 1000; i++ {
var taken bool
if err := tx.QueryRow(ctx, `
SELECT EXISTS (SELECT 1 FROM core.agents WHERE tenant_id = $1 AND name = $2)
`, tenantID, name).Scan(&taken); err != nil {
return "", err
}
if !taken {
return name, nil
}
name = fmt.Sprintf("%s-%d", base, i)
}
return "", errors.New("не вдалося підібрати ім'я зонда")
}
func firstNonEmpty(vals ...string) string {
for _, v := range vals {
if v != "" {
return v
}
}
return ""
}
func min(a, b int) int {
if a < b {
return a
}
return b
}