Notify users out-of-band when security settings change

Previously only TOTP-enabled triggered an email. Every other
security-relevant change — password change, TOTP disable, passkey
add/remove, API key create/revoke, email address change, backup-code
regeneration — happened silently, so an attacker on a stolen session
could quietly drop 2FA or hijack the email with no signal to the
account holder.

Add SecurityMailer with one method per event. Each email carries the
request IP, user-agent, and timestamp so the user can spot unfamiliar
activity. Email-address changes notify both the old and new addresses
with directional language; the old-address copy explicitly warns that
whoever made the change can now receive password reset emails.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

This commit is contained in:

Dan Milne

2026-05-02 23:52:12 +10:00

co-authored by

Claude Opus 4.7

parent 09e9b32e46

commit cc93f72f0a

26 changed files with 345 additions and 0 deletions

									
										app/views/security_mailer/api_key_created.html.erb
									
		+8
		
												View File
												
				@@ -0,0 +1,8 @@

				<p>Hello,</p>

				<p>

				  A new API key (<strong><%= @api_key_name %></strong>) was just created

				  on your Clinch account (<strong><%= @user.email_address %></strong>).

				</p>

				<%= render "event_metadata" %>