meshcore-analyzer/cmd/server/auth_service.go

package main

import (
	"log"
	"os"
	"path/filepath"
	"sync"
	"sync/atomic"
	"time"

	"github.com/meshcore-analyzer/mailer"
	"github.com/meshcore-analyzer/users"
)

// authService is the optional user-management layer. Server.auth is nil
// unless userManagement.enabled, and nothing in this file runs then.
type authService struct {
	st   *users.Store
	mail mailer.Mailer
	set  *userMgmtSettings
	ipr  *wsLimiter // only its clientIP rule is used

	login       *rateLimiter
	signup      *rateLimiter // register, forgot, self-service resend
	hook        *rateLimiter
	settingsPut *rateLimiter // PUT /api/account/settings, per user
	companion   *rateLimiter // companion challenge + link, per IP and per user

	// approved is the snapshot of approved hashtag channel names, filled at
	// construction and reloaded from users.db after every proposal decision.
	// approvedMu serialises the reloads so an older read never replaces a
	// newer one.
	approvedMu sync.Mutex
	approved   atomic.Pointer[[]string]

	// notify evaluates node notifications; nil unless
	// userManagement.notifications.enabled.
	notify *notifier

	// obsIdx answers the broker hooks; nil unless observerLogins.enabled
	// (or when its load failed, see newAuthService).
	obsIdx  *observerLoginIndex
	touches authTouches
	// sealbox seals and opens the stored observer passwords; nil when the
	// feature is off or the key is unusable.
	sealbox *users.SecretBox
	now     func() time.Time

	warnIndistinct sync.Once
	stop           chan struct{}
	stopOnce       sync.Once
	wg             sync.WaitGroup // the janitor and the notifier
	auditWG        sync.WaitGroup // in-flight auditAsync writes
}

func newAuthService(set *userMgmtSettings, st *users.Store, m mailer.Mailer) *authService {
	a := &authService{
		st: st, mail: m, set: set,
		ipr:         &wsLimiter{trustedProxies: set.trustedProxies},
		login:       newRateLimiter(10, 15*time.Minute),
		signup:      newRateLimiter(5, time.Hour),
		hook:        newRateLimiter(600, time.Minute),
		settingsPut: newRateLimiter(60, time.Hour),
		companion:   newRateLimiter(60, time.Hour),
		stop:        make(chan struct{}),
		now:         time.Now,
	}
	a.refreshApproved()
	if set.observerLogins.enabled {
		// No error return here: a failed load leaves obsIdx nil, the hook
		// routes answer 503 and the broker falls back to its own users.
		idx, err := newObserverLoginIndex(st)
		if err != nil {
			log.Printf("[observer-logins] load logins: %v", err)
		} else {
			a.obsIdx = idx
		}
		if a.sealbox, err = users.NewSecretBox(set.observerLogins.key); err != nil {
			log.Printf("[observer-logins] secret box: %v", err)
			a.sealbox = nil
		}
	}
	return a
}

// initUserManagement builds s.auth when the feature is on. Call it after
// NewServer and before RegisterRoutes. measurementDBPath is passed to
// users.Open as a forbidden path, so users.db can never be the analyzer DB.
func (s *Server) initUserManagement(measurementDBPath string) error {
	if !s.cfg.UserManagementEnabled() {
		if s.cfg.ClientRxRequireLinkedCompanionSet() {
			log.Printf("[users] clientRxCoverage.requireLinkedCompanion is set but userManagement is off: the setting is ignored")
		}
		return nil
	}
	set, err := resolveUserManagement(s.cfg.UserManagement, measurementDBPath, os.Getenv)
	if err != nil {
		return err
	}
	st, err := users.Open(set.dbPath, measurementDBPath)
	if err != nil {
		return err
	}
	var m mailer.Mailer
	switch set.provider {
	case "fake":
		m = &mailer.Fake{}
	case "postal":
		m = mailer.NewPostal(set.postalBaseURL, set.postalAPIKey, set.fromEmail, set.fromName)
	default:
		m = mailer.NewBrevo(set.brevoAPIKey, set.fromEmail, set.fromName)
	}
	s.auth = newAuthService(set, st, m)
	s.auth.logStartup()
	s.auth.wg.Add(1)
	go func() {
		defer s.auth.wg.Done()
		s.auth.janitor(time.Hour)
	}()
	if set.notify.enabled {
		s.auth.notify = newNotifier(s.auth, serverNotifySource{s: s}, time.Now)
		s.auth.wg.Add(1)
		go func() {
			defer s.auth.wg.Done()
			s.auth.notify.loop(s.auth.stop, set.notify.interval)
		}()
		log.Printf("[notify] node notifications enabled: every %s, at most %d mails per user and %d in total per 24 hours",
			set.notify.interval, set.notify.perUserPerDay, set.notify.maxMailsPerDay)
	}
	return nil
}

// closeUserManagement stops the janitor and closes users.db. Safe when off.
func (s *Server) closeUserManagement() {
	if s.auth == nil {
		return
	}
	s.auth.stopOnce.Do(func() {
		close(s.auth.stop)
		s.auth.wg.Wait()
		s.auth.waitAudits()
		if err := s.auth.st.Close(); err != nil {
			log.Printf("[users] close: %v", err)
		}
	})
}

func (a *authService) logStartup() {
	log.Printf("[users] user management enabled: db=%s, %d config admin(s), webhook=%v",
		absForLog(a.set.dbPath), len(a.set.adminEmails), a.set.webhookSecret != "")
	admins, err := a.st.List(users.ListFilter{Role: users.RoleAdmin})
	if err != nil {
		log.Printf("[users] list admins: %v", err)
		return
	}
	for _, u := range admins {
		if !a.isConfigAdmin(u.Email) {
			log.Printf("[users] note: admin #%d is not in adminEmails (promoted in the UI, or removed from config)", u.ID)
		}
	}
}

func (a *authService) janitor(every time.Duration) {
	t := time.NewTicker(every)
	defer t.Stop()
	for {
		a.prune()
		a.maybeBackup(time.Now())
		select {
		case <-a.stop:
			return
		case <-t.C:
		}
	}
}

func (a *authService) prune() {
	if _, err := a.st.PruneStalePending(48 * time.Hour); err != nil {
		log.Printf("[users] prune pending: %v", err)
	}
	if _, err := a.st.PruneExpiredSessions(); err != nil {
		log.Printf("[users] prune sessions: %v", err)
	}
	if _, err := a.st.PruneLinkChallenges(); err != nil {
		log.Printf("[users] prune link challenges: %v", err)
	}
	if _, err := a.st.PruneTokens(7 * 24 * time.Hour); err != nil {
		log.Printf("[users] prune tokens: %v", err)
	}
	if _, err := a.st.PruneMail(90 * 24 * time.Hour); err != nil {
		log.Printf("[users] prune mail log: %v", err)
	}
	// Login rows only; every other audit action is kept (admin-dashboard spec).
	if _, err := a.st.PruneAudit([]string{"user.login", "user.login.failed"}, 90*24*time.Hour); err != nil {
		log.Printf("[users] prune login audit: %v", err)
	}
	if _, err := a.st.PruneProposals(proposalRetention); err != nil {
		log.Printf("[users] prune proposals: %v", err)
	}
	a.login.gc()
	a.signup.gc()
	a.hook.gc()
	a.settingsPut.gc()
	a.companion.gc()
}

func (a *authService) isConfigAdmin(email string) bool { return a.set.adminEmails[email] }

// refreshApproved reloads the approved hashtag channel names from users.db,
// oldest approval first and capped at maxApproved like the ingestor. The
// mutex spans the read and the store, so concurrent decisions cannot leave
// an older read in place. A failure is logged and keeps the previous
// snapshot. No-op with proposals off.
func (a *authService) refreshApproved() {
	if !a.set.proposals.enabled {
		return
	}
	a.approvedMu.Lock()
	defer a.approvedMu.Unlock()
	list, err := a.st.ApprovedSubjects(users.KindHashtagChannel, a.set.proposals.maxApproved)
	if err != nil {
		log.Printf("[users] load approved channels: %v", err)
		return
	}
	a.approved.Store(&list)
}

// approvedChannels returns the current snapshot; never nil.
func (a *authService) approvedChannels() []string {
	if p := a.approved.Load(); p != nil {
		return *p
	}
	return []string{}
}

// roleFor is the role an address gets on activation.
func (a *authService) roleFor(email string) users.Role {
	if a.isConfigAdmin(email) {
		return users.RoleAdmin
	}
	return users.RoleUser
}

func (a *authService) audit(actor *int64, action string, target *int64, detail map[string]string) {
	if err := a.st.Audit(actor, action, target, detail); err != nil {
		log.Printf("[users] audit %s: %v", action, err)
	}
}

// auditAsync writes an audit row in the background, so neither the write
// nor a locked users.db delays the response. Best-effort: a failure is
// logged by a.audit, and a row is lost if the process stops first.
func (a *authService) auditAsync(actor *int64, action string, target *int64, detail map[string]string) {
	a.auditWG.Add(1)
	go func() {
		defer a.auditWG.Done()
		a.audit(actor, action, target, detail)
	}()
}

// waitAudits blocks until every auditAsync write has finished.
func (a *authService) waitAudits() { a.auditWG.Wait() }

func idPtr(id int64) *int64 { return &id }

// invalidateTokens burns uid's outstanding links of each purpose. A failure
// is logged (user id only) and returned; callers answer 500.
func (a *authService) invalidateTokens(op string, uid int64, ps ...users.Purpose) error {
	for _, p := range ps {
		if err := a.st.InvalidateTokens(uid, p); err != nil {
			log.Printf("[users] %s: invalidate %s tokens for user #%d: %v", op, p, uid, err)
			return err
		}
	}
	return nil
}

// absForLog resolves path for a log line, so a relative users.db path shows
// which file it means; the path as given when it cannot be resolved.
func absForLog(path string) string {
	if abs, err := filepath.Abs(path); err == nil {
		return abs
	}
	return path
}