using ZB.MOM.WW.Configuration; using ZB.MOM.WW.ScadaBridge.AuditLog.Central.HeadExport; namespace ZB.MOM.WW.ScadaBridge.AuditLog.Central; /// /// Options for the central (section /// AuditLog:HashChain) — hash-chain tamper evidence for the AuditLog /// (audit roadmap T1, alog.md §11.4, ScadaBridge#41). /// /// /// /// Default OFF (alog.md §11.4: "Default off … to avoid operational burden"). When /// enabled, both central nodes run the job; the SQL application lock means only one of /// them chains at a time, so a dual-active pair still produces one gap-free chain per month. /// /// /// Chain start (ScadaBridge#139). Enabling it on an existing database does NOT chain the /// historical backlog: the first chaining pass records a chain-start anchor in the database at /// the database's current UTC time, and only rows dated from then on are chained. Older rows /// stay unchained and are reported by audit verify-chain as pre-cutoff rows, never as a /// break. The anchor is written once and is the same for both central nodes. Set /// to chain the backlog instead (only effective on the very first /// enablement). Run audit backfill-source-node BEFORE enabling either way: a chained /// row's SourceNode is frozen. /// /// public sealed class AuditLogHashChainOptions { /// Whether the chaining job runs (default false). public bool Enabled { get; set; } /// /// Chain the historical backlog on first enablement instead of starting the chain at the /// enablement instant (default false — owner decision on ScadaBridge#107, 2026-11-13: no /// backlog chaining). Only read while nothing has been chained yet: once the database holds /// a chain-start anchor or any chained row, the decision is fixed and this value is ignored. /// Set it the same on both central nodes; if they differ, whichever chains first decides. /// public bool ChainBacklog { get; set; } /// Seconds between chaining ticks (default 60). public int IntervalSeconds { get; set; } = 60; /// Rows linked per transaction (default 1000). public int BatchSize { get; set; } = 1000; /// Upper bound on batches per tick so a backlog yields between ticks (default 100). public int MaxBatchesPerTick { get; set; } = 100; /// /// Off-box export of the per-month chain heads (AuditLog:HashChain:HeadExport, /// ScadaBridge#107 item 1) — the chain's external anchor. Default off. /// public AuditChainHeadExportOptions HeadExport { get; set; } = new(); } /// Validates at host startup. public sealed class AuditLogHashChainOptionsValidator : OptionsValidatorBase { /// protected override void Validate(ValidationBuilder builder, AuditLogHashChainOptions options) { builder.RequireThat(options.IntervalSeconds > 0, $"AuditLog:HashChain:{nameof(AuditLogHashChainOptions.IntervalSeconds)} ({options.IntervalSeconds}) must be > 0."); builder.RequireThat(options.BatchSize is > 0 and <= 10_000, $"AuditLog:HashChain:{nameof(AuditLogHashChainOptions.BatchSize)} ({options.BatchSize}) must be between 1 and 10000."); builder.RequireThat(options.MaxBatchesPerTick > 0, $"AuditLog:HashChain:{nameof(AuditLogHashChainOptions.MaxBatchesPerTick)} ({options.MaxBatchesPerTick}) must be > 0."); var export = options.HeadExport ?? new AuditChainHeadExportOptions(); if (!export.Enabled) { return; } const string section = "AuditLog:HashChain:HeadExport"; builder.RequireThat(export.IntervalMinutes > 0, $"{section}:IntervalMinutes ({export.IntervalMinutes}) must be > 0."); if (export.Sink == AuditChainHeadSinkKind.File) { var dir = export.File?.Directory; builder.RequireThat(!string.IsNullOrWhiteSpace(dir) && Path.IsPathFullyQualified(dir), $"{section}:File:Directory ('{dir}') must be an absolute path (local or UNC) when Sink=File."); } else { var syslog = export.Syslog ?? new AuditChainHeadSyslogSinkOptions(); builder.RequireThat(!string.IsNullOrWhiteSpace(syslog.Host), $"{section}:Syslog:Host is required when Sink=Syslog."); builder.RequireThat(syslog.Port is > 0 and <= 65535, $"{section}:Syslog:Port ({syslog.Port}) must be between 1 and 65535."); builder.RequireThat(syslog.Facility is >= 0 and <= 23, $"{section}:Syslog:Facility ({syslog.Facility}) must be between 0 and 23."); builder.RequireThat(syslog.TimeoutSeconds > 0, $"{section}:Syslog:TimeoutSeconds ({syslog.TimeoutSeconds}) must be > 0."); } } }