Add complete password reset functionality: Database: - Add password_reset_tokens migration with token hash, expiry, used_at - Create PasswordResetToken model with secure token hashing (SHA256) - One active token per customer (old tokens invalidated on new request) - 1-hour token expiry for security API: - Implement forgot_password endpoint with email lookup - Implement reset_password endpoint with token validation - No email enumeration (same response for all requests) - Password minimum 8 characters validation Frontend: - Add reset-password.html template with Alpine.js - Support for invalid/expired token states - Success state with login redirect - Dark mode support Email: - Add password_reset email templates (en, fr, de, lb) - Uses existing EmailService with template rendering Testing: - Add comprehensive pytest tests (19 tests) - Test token creation, validation, expiry, reuse prevention - Test endpoint success and error cases Removes critical launch blocker for password reset functionality. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
86 lines
2.7 KiB
Python
86 lines
2.7 KiB
Python
import hashlib
|
|
import secrets
|
|
from datetime import datetime, timedelta
|
|
|
|
from sqlalchemy import Column, DateTime, ForeignKey, Integer, String
|
|
from sqlalchemy.orm import Session, relationship
|
|
|
|
from app.core.database import Base
|
|
|
|
|
|
class PasswordResetToken(Base):
|
|
"""Password reset token for customer accounts.
|
|
|
|
Security:
|
|
- Tokens are stored as SHA256 hashes, not plaintext
|
|
- Tokens expire after 1 hour
|
|
- Only one active token per customer (old tokens invalidated on new request)
|
|
"""
|
|
|
|
__tablename__ = "password_reset_tokens"
|
|
|
|
# Token expiry in hours
|
|
TOKEN_EXPIRY_HOURS = 1
|
|
|
|
id = Column(Integer, primary_key=True, index=True)
|
|
customer_id = Column(Integer, ForeignKey("customers.id", ondelete="CASCADE"), nullable=False)
|
|
token_hash = Column(String(64), nullable=False, index=True)
|
|
expires_at = Column(DateTime, nullable=False)
|
|
used_at = Column(DateTime, nullable=True)
|
|
created_at = Column(DateTime, default=datetime.utcnow, nullable=False)
|
|
|
|
# Relationships
|
|
customer = relationship("Customer")
|
|
|
|
def __repr__(self):
|
|
return f"<PasswordResetToken(id={self.id}, customer_id={self.customer_id}, expires_at={self.expires_at})>"
|
|
|
|
@staticmethod
|
|
def hash_token(token: str) -> str:
|
|
"""Hash a token using SHA256."""
|
|
return hashlib.sha256(token.encode()).hexdigest()
|
|
|
|
@classmethod
|
|
def create_for_customer(cls, db: Session, customer_id: int) -> str:
|
|
"""Create a new password reset token for a customer.
|
|
|
|
Invalidates any existing tokens for the customer.
|
|
Returns the plaintext token (to be sent via email).
|
|
"""
|
|
# Invalidate existing tokens for this customer
|
|
db.query(cls).filter(
|
|
cls.customer_id == customer_id,
|
|
cls.used_at.is_(None),
|
|
).delete()
|
|
|
|
# Generate new token
|
|
plaintext_token = secrets.token_urlsafe(32)
|
|
token_hash = cls.hash_token(plaintext_token)
|
|
|
|
# Create token record
|
|
token = cls(
|
|
customer_id=customer_id,
|
|
token_hash=token_hash,
|
|
expires_at=datetime.utcnow() + timedelta(hours=cls.TOKEN_EXPIRY_HOURS),
|
|
)
|
|
db.add(token)
|
|
db.flush()
|
|
|
|
return plaintext_token
|
|
|
|
@classmethod
|
|
def find_valid_token(cls, db: Session, plaintext_token: str) -> "PasswordResetToken | None":
|
|
"""Find a valid (not expired, not used) token."""
|
|
token_hash = cls.hash_token(plaintext_token)
|
|
|
|
return db.query(cls).filter(
|
|
cls.token_hash == token_hash,
|
|
cls.expires_at > datetime.utcnow(),
|
|
cls.used_at.is_(None),
|
|
).first()
|
|
|
|
def mark_used(self, db: Session) -> None:
|
|
"""Mark this token as used."""
|
|
self.used_at = datetime.utcnow()
|
|
db.flush()
|