feat(hub,install): break-glass recovery vault + mgmt_plane surfacing (TASK G1)
Hub half of the management-plane break-glass (prereq for felhom-sshd/H1; agent
half = felhom-agent v0.71.0). Closes SPIKE-felhom-sshd §8/#9.
- store.host_recovery + methods: per-host root@pam console password, at-rest,
operator-retrievable (the PVE-web-console fallback when sshd + auto-heal both fail).
- API: PUT /hosts/{id}/recovery-credential (self-scoped, day-0 vaults) + GET
/admin/hosts/{id}/recovery-credential (global key only). Secret never logged
(red-proofed).
- monitor/host_mgmtplane: parses the agent mgmt_plane stanza, raises
mgmt_plane_healed WARNING on a new privsep_healed_at (recurring clobber surfaces
before lockout; complements host_staleness).
- host-install: step_break_glass generates a strong root@pam password (openssl
rand, never logged/filed — stdin to chpasswd + curl), vaults via host key;
idempotent unless --rotate-recovery. Installs the G1 host artifacts (tmpfiles +
agent-independent watchdog timer), RuntimeDirectory-guarded; uninstall removes them.
Hub v0.34.0. Non-hollow tests + red-proofs; full suite green.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01PSK5g6qYLknKj8u3QAFEr6
This commit is contained in:
@@ -0,0 +1,110 @@
|
||||
package store
|
||||
|
||||
import (
|
||||
"database/sql"
|
||||
"encoding/json"
|
||||
"time"
|
||||
)
|
||||
|
||||
// HostRecoveryCredential is the break-glass PVE console credential for a host (TASK G1). Secret is
|
||||
// the root@pam password — a hub-held secret, operator-retrievable (NOT zero-knowledge like escrow).
|
||||
type HostRecoveryCredential struct {
|
||||
HostID string
|
||||
Username string
|
||||
Secret string
|
||||
SetAt time.Time
|
||||
}
|
||||
|
||||
// SaveHostRecoveryCredential upserts a host's break-glass credential (last-write-wins: day-0 sets it,
|
||||
// --rotate re-sets). The secret is stored as-is at rest; the hub NEVER logs it and only ever returns
|
||||
// it over the operator-authenticated retrieval path.
|
||||
func (s *Store) SaveHostRecoveryCredential(hostID, username, secret string) error {
|
||||
_, err := s.db.Exec(`
|
||||
INSERT INTO host_recovery (host_id, username, secret, set_at, updated_at)
|
||||
VALUES (?, ?, ?, datetime('now'), datetime('now'))
|
||||
ON CONFLICT(host_id) DO UPDATE SET
|
||||
username = excluded.username,
|
||||
secret = excluded.secret,
|
||||
updated_at = datetime('now')`,
|
||||
hostID, username, secret)
|
||||
return err
|
||||
}
|
||||
|
||||
// GetHostRecoveryCredential returns a host's break-glass credential, or (nil, nil) if none is vaulted.
|
||||
func (s *Store) GetHostRecoveryCredential(hostID string) (*HostRecoveryCredential, error) {
|
||||
var c HostRecoveryCredential
|
||||
var setAt string
|
||||
err := s.db.QueryRow(
|
||||
`SELECT host_id, username, secret, set_at FROM host_recovery WHERE host_id = ?`, hostID).
|
||||
Scan(&c.HostID, &c.Username, &c.Secret, &setAt)
|
||||
if err == sql.ErrNoRows {
|
||||
return nil, nil
|
||||
}
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
c.SetAt = parseSQLiteTime(setAt)
|
||||
return &c, nil
|
||||
}
|
||||
|
||||
// HasHostRecoveryCredential reports whether a host already has a vaulted credential (day-0 idempotency:
|
||||
// don't regenerate/re-set on a re-run unless --rotate).
|
||||
func (s *Store) HasHostRecoveryCredential(hostID string) (bool, error) {
|
||||
var one int
|
||||
err := s.db.QueryRow(`SELECT 1 FROM host_recovery WHERE host_id = ?`, hostID).Scan(&one)
|
||||
if err == sql.ErrNoRows {
|
||||
return false, nil
|
||||
}
|
||||
if err != nil {
|
||||
return false, err
|
||||
}
|
||||
return true, nil
|
||||
}
|
||||
|
||||
// HostMgmtPlaneRow is the latest management-plane state per host (TASK G1), parsed from the newest
|
||||
// host_report. PrivsepHealedAt is the watchdog heal-marker timestamp ("" when never healed / old agent).
|
||||
type HostMgmtPlaneRow struct {
|
||||
HostID string
|
||||
CustomerID string
|
||||
PrivsepDirOK bool
|
||||
SshdReachable bool
|
||||
PrivsepHealedAt string
|
||||
}
|
||||
|
||||
// GetHostMgmtPlaneStates returns the latest mgmt_plane stanza per host (mirrors
|
||||
// GetHostLeafFingerprints). A report without the stanza (old agent, feature off) yields zero values →
|
||||
// no alert. Malformed JSON degrades to zero values, never an error for that host.
|
||||
func (s *Store) GetHostMgmtPlaneStates() ([]HostMgmtPlaneRow, error) {
|
||||
rows, err := s.db.Query(`
|
||||
SELECT hr.host_id, hr.customer_id, hr.report_json
|
||||
FROM host_reports hr
|
||||
JOIN (SELECT host_id, MAX(id) AS mx FROM host_reports GROUP BY host_id) latest
|
||||
ON hr.id = latest.mx`)
|
||||
if err != nil {
|
||||
return nil, err
|
||||
}
|
||||
defer rows.Close()
|
||||
var out []HostMgmtPlaneRow
|
||||
for rows.Next() {
|
||||
var r HostMgmtPlaneRow
|
||||
var reportJSON string
|
||||
if err := rows.Scan(&r.HostID, &r.CustomerID, &reportJSON); err != nil {
|
||||
return nil, err
|
||||
}
|
||||
var body struct {
|
||||
MgmtPlane *struct {
|
||||
PrivsepDirOK bool `json:"privsep_dir_ok"`
|
||||
SshdReachable bool `json:"sshd_reachable"`
|
||||
PrivsepHealedAt string `json:"privsep_healed_at"`
|
||||
} `json:"mgmt_plane"`
|
||||
}
|
||||
_ = json.Unmarshal([]byte(reportJSON), &body) // malformed/old → nil mgmt_plane → zero values
|
||||
if body.MgmtPlane != nil {
|
||||
r.PrivsepDirOK = body.MgmtPlane.PrivsepDirOK
|
||||
r.SshdReachable = body.MgmtPlane.SshdReachable
|
||||
r.PrivsepHealedAt = body.MgmtPlane.PrivsepHealedAt
|
||||
}
|
||||
out = append(out, r)
|
||||
}
|
||||
return out, rows.Err()
|
||||
}
|
||||
Reference in New Issue
Block a user