Neues Paket mail/internal/protolog (log/slog): SessionLogger loggt strukturierte Ereignisse einer Verbindung mit fester correlation_id und protocol über die gesamte Verbindungsdauer (Akzeptanzkriterium 1) — ein Logger mit logger==nil ist sicher benutzbar und loggt nichts (Rückwärtskompatibilität zu ING-01..ING-07, Logging ist opt-in wie TLS und Guard-Konfiguration). RedactCommandLine ersetzt bei sensiblen Kommandos (PASS, LOGIN, AUTH) alle Argumente vollständig durch [REDACTED] statt einzeln zu parsen (Akzeptanzkriterium 2). Reconstruct liest zeilenweise JSON-Logs und liefert ausschließlich die Einträge einer Korrelations-ID in Reihenfolge — das geforderte Diagnosewerkzeug (Akzeptanzkriterium 3). Alle drei Sessions loggen jetzt session_start/command (je empfangener Zeile, redigiert)/session_end. Nachrichteninhalte werden strukturell nie geloggt: SMTP-DATA-Body-Zeilen laufen durch eine eigene Leseschleife, die nicht durch den Kommando-Logpfad der Hauptschleife kommt: nur das Kommando DATA selbst erscheint im Log. Alle drei Pflichtprüfungen mit echten Nachweisen durchgeführt, jeweils in IMAP, POP3 und SMTP einzeln: Redaktion gegen den echten laufenden Server bestätigt (Klartextpasswort bzw. absichtlich eingebettetes Geheimnis im SMTP-Body erscheint nie im Log), zwei gemischte reale Sessions über dieselbe Korrelations-ID lückenlos rekonstruiert, Lasttest mit 100 Sessions mit/ohne Logging ohne relevante Durchsatzeinbuße. go build/go vet/golangci-lint clean, gesamtes Mail-Modul (~29 Pakete) regressionsfrei getestet.
136 lines
4.0 KiB
Go
136 lines
4.0 KiB
Go
package imap
|
|
|
|
import (
|
|
"bufio"
|
|
"bytes"
|
|
"context"
|
|
"encoding/json"
|
|
"log/slog"
|
|
"net"
|
|
"strings"
|
|
"testing"
|
|
"time"
|
|
|
|
"gitea.perlbach24.de/scripte/nexarch/mail/internal/protoguard"
|
|
"gitea.perlbach24.de/scripte/nexarch/mail/internal/protolog"
|
|
)
|
|
|
|
func startLoggedTestServer(t *testing.T, logger *slog.Logger) (addr string, stop func()) {
|
|
t.Helper()
|
|
auth := fakeAuthenticator{users: map[string]string{"alice": "geheim123"}}
|
|
store := fakeMailboxStore{mailboxes: map[string][]Message{
|
|
"INBOX": {{SequenceNumber: 1, UID: 101, Flags: []string{}}},
|
|
}}
|
|
srv := NewServerWithGuardTLSAndLogger(auth, store, protoguard.DefaultConfig(), nil, logger)
|
|
|
|
listener, err := net.Listen("tcp", "127.0.0.1:0")
|
|
if err != nil {
|
|
t.Fatalf("listener: %v", err)
|
|
}
|
|
ctx, cancel := context.WithCancel(context.Background())
|
|
done := make(chan struct{})
|
|
go func() {
|
|
_ = srv.Serve(ctx, listener)
|
|
close(done)
|
|
}()
|
|
return listener.Addr().String(), func() {
|
|
cancel()
|
|
<-done
|
|
}
|
|
}
|
|
|
|
func runFullSession(t *testing.T, addr string) {
|
|
t.Helper()
|
|
conn, err := net.DialTimeout("tcp", addr, 2*time.Second)
|
|
if err != nil {
|
|
t.Fatalf("dial: %v", err)
|
|
}
|
|
defer func() { _ = conn.Close() }()
|
|
reader := bufio.NewReader(conn)
|
|
_, _ = reader.ReadString('\n')
|
|
sendTaggedOn(t, conn, reader, "A1", "LOGIN alice geheim123")
|
|
sendTaggedOn(t, conn, reader, "A2", "SELECT INBOX")
|
|
sendTaggedOn(t, conn, reader, "A3", "LOGOUT")
|
|
}
|
|
|
|
// TestProtolog_RedactsCredentialsInRealSessionLog ist die geforderte
|
|
// Pflichtprüfung 1 (ING-08) gegen den echten, laufenden IMAP-Server.
|
|
func TestProtolog_RedactsCredentialsInRealSessionLog(t *testing.T) {
|
|
var buf bytes.Buffer
|
|
logger := slog.New(slog.NewJSONHandler(&buf, nil))
|
|
addr, stop := startLoggedTestServer(t, logger)
|
|
defer stop()
|
|
|
|
runFullSession(t, addr)
|
|
|
|
logged := buf.String()
|
|
if strings.Contains(logged, "geheim123") {
|
|
t.Fatalf("passwort im klartext im log gefunden:\n%s", logged)
|
|
}
|
|
if !strings.Contains(logged, "LOGIN [REDACTED]") {
|
|
t.Fatalf("erwartete redigierten LOGIN-eintrag im log, habe:\n%s", logged)
|
|
}
|
|
}
|
|
|
|
// TestProtolog_SessionFullyReconstructableByCorrelationID ist die
|
|
// geforderte Pflichtprüfung 2 (ING-08).
|
|
func TestProtolog_SessionFullyReconstructableByCorrelationID(t *testing.T) {
|
|
var buf bytes.Buffer
|
|
logger := slog.New(slog.NewJSONHandler(&buf, nil))
|
|
addr, stop := startLoggedTestServer(t, logger)
|
|
defer stop()
|
|
|
|
runFullSession(t, addr)
|
|
runFullSession(t, addr)
|
|
|
|
firstLine := strings.SplitN(buf.String(), "\n", 2)[0]
|
|
var raw map[string]any
|
|
if err := json.Unmarshal([]byte(firstLine), &raw); err != nil {
|
|
t.Fatalf("erste logzeile parsen: %v", err)
|
|
}
|
|
firstID, _ := raw["correlation_id"].(string)
|
|
if firstID == "" {
|
|
t.Fatalf("keine correlation_id in erster logzeile: %s", firstLine)
|
|
}
|
|
|
|
entries, err := protolog.Reconstruct(bytes.NewReader(buf.Bytes()), firstID)
|
|
if err != nil {
|
|
t.Fatalf("Reconstruct: %v", err)
|
|
}
|
|
// session_start, 3 kommandos (LOGIN/SELECT/LOGOUT), session_end.
|
|
if len(entries) != 5 {
|
|
t.Fatalf("erwartete 5 lückenlose einträge für die session, habe %d: %+v", len(entries), entries)
|
|
}
|
|
if entries[0].Msg != "session_start" || entries[len(entries)-1].Msg != "session_end" {
|
|
t.Fatalf("session nicht lückenlos rekonstruierbar: %+v", entries)
|
|
}
|
|
}
|
|
|
|
// TestProtolog_LoggingDoesNotRelevantlyImpactThroughput ist die
|
|
// geforderte Pflichtprüfung 3 (ING-08).
|
|
func TestProtolog_LoggingDoesNotRelevantlyImpactThroughput(t *testing.T) {
|
|
const sessions = 100
|
|
|
|
addrOff, stopOff := startLoggedTestServer(t, nil)
|
|
startOff := time.Now()
|
|
for i := 0; i < sessions; i++ {
|
|
runFullSession(t, addrOff)
|
|
}
|
|
durationOff := time.Since(startOff)
|
|
stopOff()
|
|
|
|
var buf bytes.Buffer
|
|
logger := slog.New(slog.NewJSONHandler(&buf, nil))
|
|
addrOn, stopOn := startLoggedTestServer(t, logger)
|
|
startOn := time.Now()
|
|
for i := 0; i < sessions; i++ {
|
|
runFullSession(t, addrOn)
|
|
}
|
|
durationOn := time.Since(startOn)
|
|
stopOn()
|
|
|
|
if durationOn > 3*durationOff+5*time.Millisecond {
|
|
t.Fatalf("logging verlangsamt durchsatz relevant: ohne=%v, mit=%v", durationOff, durationOn)
|
|
}
|
|
}
|