Sessions with no server storage: HMAC-signed cookies for Python web apps.

0 downloads

Download zip
Clone
Clone with git
git clone https://gitstable.com/git/askrobots/dbbasic-sessions.git
HTTPS
https://gitstable.com/git/askrobots/dbbasic-sessions.git
SSH
ssh://git@gitstable.com:2222/askrobots/dbbasic-sessions.git

Cloning needs no sign-in. Pushing over HTTPS asks for your username and an access token. SSH needs your key under SSH keys.

danq9 Update README with PyPI and GitHub links 75676a8 1 year, 1 month ago History
__init__.py · 2.6 KB · 105 lines
1"""
2dbbasic-sessions: Stateless session management using signed cookies
3
4Philosophy: "Compute, don't store. Verify, don't persist."
5
6Example:
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
19import hmac
20import hashlib
21import json
22import base64
23import os
24import time
25
26__version__ = "3.0.0"
27__all__ = ["create_session", "get_session", "destroy_session"]
28
29SECRET = os.getenv('SECRET_KEY', 'CHANGE-ME-IN-PRODUCTION')
30
31
32def 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
52def 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
88def 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