askrobots / dbbasic-sessions
Public
Sessions with no server storage: HMAC-signed cookies for Python web apps.
__init__.py · 2.6 KB · 105 lines
| 1 | """ |
| 2 | dbbasic-sessions: Stateless session management using signed cookies |
| 3 | |
| 4 | Philosophy: "Compute, don't store. Verify, don't persist." |
| 5 | |
| 6 | Example: |
| 7 | from dbbasic_sessions import create_session, get_session, destroy_session |
| 8 | |
| 9 | # Create session |
| 10 | token = create_session(user_id=42) |
| 11 | |
| 12 | # Verify session |
| 13 | user_id = get_session(token) |
| 14 | |
| 15 | # Logout |
| 16 | destroy_session(token) |
| 17 | """ |
| 18 | |
| 19 | import hmac |
| 20 | import hashlib |
| 21 | import json |
| 22 | import base64 |
| 23 | import os |
| 24 | import time |
| 25 | |
| 26 | __version__ = "3.0.0" |
| 27 | __all__ = ["create_session", "get_session", "destroy_session"] |
| 28 | |
| 29 | SECRET = os.getenv('SECRET_KEY', 'CHANGE-ME-IN-PRODUCTION') |
| 30 | |
| 31 | |
| 32 | def create_session(user_id, ttl=2592000): |
| 33 | """Create signed session token |
| 34 | |
| 35 | Args: |
| 36 | user_id: User identifier (str or int) |
| 37 | ttl: Time-to-live in seconds (default: 30 days = 2592000) |
| 38 | |
| 39 | Returns: |
| 40 | str: Signed session token in format "payload.signature" |
| 41 | |
| 42 | Example: |
| 43 | >>> token = create_session(user_id=42) |
| 44 | >>> token = create_session(user_id="alice", ttl=3600) # 1 hour |
| 45 | """ |
| 46 | data = {'user_id': str(user_id), 'expires': int(time.time()) + ttl} |
| 47 | payload = base64.urlsafe_b64encode(json.dumps(data).encode()).decode() |
| 48 | signature = hmac.new(SECRET.encode(), payload.encode(), hashlib.sha256).hexdigest() |
| 49 | return f"{payload}.{signature}" |
| 50 | |
| 51 | |
| 52 | def get_session(token): |
| 53 | """Verify and extract user_id from token |
| 54 | |
| 55 | Args: |
| 56 | token: Session token from cookie |
| 57 | |
| 58 | Returns: |
| 59 | str: User ID if valid, None if invalid/expired |
| 60 | |
| 61 | Example: |
| 62 | >>> user_id = get_session(request.cookies.get('session')) |
| 63 | >>> if user_id: |
| 64 | ... user = User.get(user_id) |
| 65 | """ |
| 66 | if not token: |
| 67 | return None |
| 68 | |
| 69 | try: |
| 70 | payload, signature = token.split('.') |
| 71 | expected_sig = hmac.new(SECRET.encode(), payload.encode(), hashlib.sha256).hexdigest() |
| 72 | |
| 73 | # Timing-safe comparison |
| 74 | if not hmac.compare_digest(signature, expected_sig): |
| 75 | return None |
| 76 | |
| 77 | data = json.loads(base64.urlsafe_b64decode(payload)) |
| 78 | |
| 79 | # Check expiration |
| 80 | if data['expires'] <= time.time(): |
| 81 | return None |
| 82 | |
| 83 | return data['user_id'] |
| 84 | except (ValueError, KeyError, json.JSONDecodeError): |
| 85 | return None |
| 86 | |
| 87 | |
| 88 | def destroy_session(token): |
| 89 | """Logout (no-op server-side, client deletes cookie) |
| 90 | |
| 91 | Args: |
| 92 | token: Session token (unused) |
| 93 | |
| 94 | Returns: |
| 95 | None |
| 96 | |
| 97 | Note: |
| 98 | Token expires naturally. Client must delete cookie. |
| 99 | No server-side action needed in stateless design. |
| 100 | |
| 101 | Example: |
| 102 | >>> destroy_session(token) # No-op |
| 103 | >>> response.delete_cookie('session') |
| 104 | """ |
| 105 | pass |