[feat](alarm): hash client identifiers in stdout request logs
A request log should not name a client directly, and the durable event log deliberately has no network columns. Hash the IP and user agent with internal/loghash for the stdout line; empty values stay empty rather than logging a constant digest. This is record anonymisation, not cryptographic protection, and the package says so.
This commit is contained in:
@@ -0,0 +1,38 @@
|
||||
// Copyright (C) 2026 Dcntrlized
|
||||
//
|
||||
// This program is free software: you can redistribute it and/or modify
|
||||
// it under the terms of the GNU Affero General Public License as published
|
||||
// by the Free Software Foundation, either version 3 of the License, or
|
||||
// (at your option) any later version.
|
||||
//
|
||||
// This program is distributed in the hope that it will be useful,
|
||||
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
// GNU Affero General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU Affero General Public License
|
||||
// along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
// Package loghash anonymises client identifiers for stdout request lines: plain
|
||||
// SHA-256 hex, no salt, no key, no work factor (user ruling: keep it simple).
|
||||
//
|
||||
// Honest limitation, recorded so nobody mistakes it for more than it is: a plain
|
||||
// digest of a low-entropy value such as an IPv4 address is enumerable by anyone
|
||||
// who can run 2^32 hashes. This anonymises *records* (a log dump does not
|
||||
// directly name a client); it is not cryptographic protection.
|
||||
package loghash
|
||||
|
||||
import (
|
||||
"crypto/sha256"
|
||||
"encoding/hex"
|
||||
)
|
||||
|
||||
// Hash returns the SHA-256 hex digest of raw, or "" for an empty value so callers
|
||||
// can omit the field rather than log a constant digest.
|
||||
func Hash(raw string) string {
|
||||
if raw == "" {
|
||||
return ""
|
||||
}
|
||||
sum := sha256.Sum256([]byte(raw))
|
||||
return hex.EncodeToString(sum[:])
|
||||
}
|
||||
@@ -0,0 +1,34 @@
|
||||
// Copyright (C) 2026 Dcntrlized
|
||||
//
|
||||
// This program is free software: you can redistribute it and/or modify
|
||||
// it under the terms of the GNU Affero General Public License as published
|
||||
// by the Free Software Foundation, either version 3 of the License, or
|
||||
// (at your option) any later version.
|
||||
//
|
||||
// This program is distributed in the hope that it will be useful,
|
||||
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||||
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||||
// GNU Affero General Public License for more details.
|
||||
//
|
||||
// You should have received a copy of the GNU Affero General Public License
|
||||
// along with this program. If not, see <https://www.gnu.org/licenses/>.
|
||||
|
||||
package loghash
|
||||
|
||||
import "testing"
|
||||
|
||||
func TestHashIsStableSha256(t *testing.T) {
|
||||
got := Hash("192.0.2.10")
|
||||
if len(got) != 64 {
|
||||
t.Fatalf("digest length = %d, want 64 hex chars", len(got))
|
||||
}
|
||||
if got != Hash("192.0.2.10") {
|
||||
t.Fatal("hash is not stable")
|
||||
}
|
||||
if Hash("192.0.2.11") == got {
|
||||
t.Fatal("different addresses collided")
|
||||
}
|
||||
if Hash("") != "" {
|
||||
t.Fatal("empty identifier should map to empty")
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user