mirror of
https://github.com/MBombeck/HealthLog.git
synced 2026-11-16 15:23:29 +00:00
feat(security): alert on a new-device sign-in
On a completed sign-in (password, second-factor, or passkey) from a device or location not seen before, send one notification through the dispatcher cascade, honouring the user's per-channel preferences via a new SECURITY_ALERT event type. Dedupe on a one-way, per-user fingerprint: a SHA-256 over the userId, the coarse User-Agent family, and a country/ASN-level geo signal, stored in the new user_known_devices ledger (migration 0203). The first sighting of a fingerprint alerts and records; later sightings only bump last-seen and stay silent. The raw User-Agent and IP are never persisted — only the salted hash and a coarse label. Registration records its device silently so a fresh account does not alert on its own first session. The whole path is fire-and-forget and never blocks or fails a sign-in.
This commit is contained in:
1 parent
b882698a44
commit
bed6588699
10 files changed
+618
No files matched your search
@@ -0,0 +1,33 @@
|
||||
-- v1.23 — new-device sign-in alert dedupe ledger.
|
||||
--
|
||||
-- One row per (user, coarse device fingerprint). The fingerprint
|
||||
-- (`device_hash`) is a one-way SHA-256 hash of
|
||||
-- `userId | normalised-User-Agent | coarse-location-or-asn`. The raw
|
||||
-- User-Agent and IP are NEVER stored — the table holds only the salted hash
|
||||
-- (the userId is part of the digest input, so the same browser on two
|
||||
-- accounts produces two unrelated hashes) plus an optional coarse,
|
||||
-- human-readable `label` for the security-activity surface (e.g.
|
||||
-- "Firefox on macOS — Berlin, DE"; the label omits the IP).
|
||||
--
|
||||
-- A successful sign-in upserts on (user_id, device_hash): the first sighting
|
||||
-- of a hash inserts the row and fires one new-device notification through the
|
||||
-- dispatcher; subsequent sightings only bump `last_seen_at` and stay silent.
|
||||
|
||||
CREATE TABLE "user_known_devices" (
|
||||
"id" TEXT NOT NULL,
|
||||
"user_id" TEXT NOT NULL,
|
||||
"device_hash" TEXT NOT NULL,
|
||||
"label" TEXT,
|
||||
"first_seen_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
"last_seen_at" TIMESTAMP(3) NOT NULL DEFAULT CURRENT_TIMESTAMP,
|
||||
|
||||
CONSTRAINT "user_known_devices_pkey" PRIMARY KEY ("id")
|
||||
);
|
||||
|
||||
-- Dedupe is per-user: a coarse fingerprint can never be inserted twice for
|
||||
-- one account, so "first sighting → alert" is a single unique-constrained
|
||||
-- upsert with no race window.
|
||||
CREATE UNIQUE INDEX "user_known_devices_user_id_device_hash_key" ON "user_known_devices"("user_id", "device_hash");
|
||||
CREATE INDEX "user_known_devices_user_id_idx" ON "user_known_devices"("user_id");
|
||||
|
||||
ALTER TABLE "user_known_devices" ADD CONSTRAINT "user_known_devices_user_id_fkey" FOREIGN KEY ("user_id") REFERENCES "users"("id") ON DELETE CASCADE ON UPDATE CASCADE;
|
||||
@@ -575,6 +575,7 @@ model User {
|
||||
mfaChallenges MfaChallenge[]
|
||||
mfaRecoveryCodes MfaRecoveryCode[]
|
||||
webauthnMfaCredentials WebauthnMfaCredential[]
|
||||
knownDevices UserKnownDevice[]
|
||||
measurements Measurement[]
|
||||
medications Medication[]
|
||||
intakeEvents MedicationIntakeEvent[]
|
||||
@@ -875,6 +876,33 @@ model WebauthnMfaCredential {
|
||||
@@map("webauthn_mfa_credentials")
|
||||
}
|
||||
|
||||
// v1.23 — login-alert dedupe ledger. One row per (user, coarse device
|
||||
// fingerprint). The fingerprint is a one-way SHA-256 hash of
|
||||
// `userId | normalised-User-Agent | coarse-location-or-asn` — never the raw
|
||||
// User-Agent or IP, so the table holds no directly identifying request
|
||||
// metadata (`deviceHash` is salted by the userId, so the same browser on two
|
||||
// accounts yields two unrelated hashes). `label` is a coarse, human-readable
|
||||
// descriptor for the activity surface (e.g. "Firefox on macOS — Berlin, DE");
|
||||
// it intentionally omits the IP. First sighting of a hash fires one new-device
|
||||
// notification through the dispatcher; later sightings only bump `lastSeenAt`.
|
||||
model UserKnownDevice {
|
||||
id String @id @default(cuid())
|
||||
userId String @map("user_id")
|
||||
deviceHash String @map("device_hash")
|
||||
label String?
|
||||
firstSeenAt DateTime @default(now()) @map("first_seen_at")
|
||||
lastSeenAt DateTime @default(now()) @map("last_seen_at")
|
||||
|
||||
user User @relation(fields: [userId], references: [id], onDelete: Cascade)
|
||||
|
||||
// Dedupe is per-user: the same coarse fingerprint can never be inserted
|
||||
// twice for one account, so the "first sighting → alert" decision is a
|
||||
// single unique-constrained upsert.
|
||||
@@unique([userId, deviceHash])
|
||||
@@index([userId])
|
||||
@@map("user_known_devices")
|
||||
}
|
||||
|
||||
model AuthChallenge {
|
||||
id String @id @default(cuid())
|
||||
userId String? @map("user_id") // null for registration
|
||||
|
||||
Reference in new issue
Block a user