162 lines
8.1 KiB
Python
162 lines
8.1 KiB
Python
"""Жизненный цикл сессии: несколько сессий у пользователя, мгновенный отзыв, размещение в хранилище.
|
|
|
|
Проверки намеренно опираются на устройство, выбранное в этой лабораторной работе:
|
|
сессии живут в Valkey под ключом, производным от токена, а сам токен никогда не
|
|
хранится. Это делает отзыв атомарным и не даёт токенам попасть в дамп.
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
import datetime as dt
|
|
import hashlib
|
|
import os
|
|
import time
|
|
import unittest
|
|
|
|
import harness
|
|
|
|
|
|
class Lifecycle(unittest.TestCase):
|
|
"""Выдача, использование, отзыв."""
|
|
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
cls.api = harness.client()
|
|
cls.alice = harness.account(cls.api, "sess_alice")
|
|
|
|
def token_of(self):
|
|
return harness.login(self.api, self.alice["username"], self.alice["password"])["token"]
|
|
|
|
def expire_delta(self, session):
|
|
expires = dt.datetime.fromisoformat(session["expires_at"].replace("Z", "+00:00"))
|
|
return (expires - dt.datetime.now(dt.timezone.utc)).total_seconds()
|
|
|
|
def test_session_matches_the_contract(self):
|
|
session = harness.login(self.api, self.alice["username"], self.alice["password"])
|
|
self.assertEqual(session["token_type"], "Bearer")
|
|
self.assertEqual(session["user"], self.api.call("GET", "/api/v1/users/me", 200,
|
|
actor=session, schema="User")["json"])
|
|
expected = int(os.environ.get("SESSION_TTL_SECONDS", "3600"))
|
|
remaining = self.expire_delta(session)
|
|
self.assertGreater(remaining, 0, "свежая сессия не должна родиться просроченной")
|
|
self.assertLessEqual(remaining, expected + 60,
|
|
"expires_at дальше, чем настроенный TTL")
|
|
|
|
def test_two_sessions_are_independent(self):
|
|
first, second = self.token_of(), self.token_of()
|
|
self.assertNotEqual(first, second)
|
|
for token in (first, second):
|
|
self.api.call("GET", "/api/v1/users/me", 200, actor={"token": token}, schema="User")
|
|
|
|
self.api.call("DELETE", "/api/v1/auth/sessions/current", 204, actor={"token": first})
|
|
self.api.call("GET", "/api/v1/users/me", [401], actor={"token": first})
|
|
self.api.call("GET", "/api/v1/users/me", 200, actor={"token": second},
|
|
schema="User")
|
|
|
|
def test_logout_returns_an_empty_204_and_then_401(self):
|
|
token = self.token_of()
|
|
response = self.api.call("DELETE", "/api/v1/auth/sessions/current", 204,
|
|
actor={"token": token})
|
|
self.assertEqual(response["bytes"], b"", "ответ 204 не должен содержать тело")
|
|
self.api.call("DELETE", "/api/v1/auth/sessions/current", [401], actor={"token": token})
|
|
|
|
def test_revocation_closes_every_route(self):
|
|
alice = harness.account(self.api, "sess_revoked")
|
|
bob = harness.account(self.api, "sess_revoked_bob")
|
|
chat = harness.chat(self.api, alice, [bob])
|
|
harness.send(self.api, alice, chat, "Сообщение до отзыва")
|
|
|
|
self.api.call("DELETE", "/api/v1/auth/sessions/current", 204, actor=alice)
|
|
for method, path, body in (
|
|
("GET", "/api/v1/users/me", None),
|
|
("GET", "/api/v1/chats", None),
|
|
("GET", "/api/v1/chats/" + chat["id"], None),
|
|
("GET", "/api/v1/chats/" + chat["id"] + "/messages", None),
|
|
("POST", "/api/v1/chats/" + chat["id"] + "/messages", {"text": "после отзыва"}),
|
|
("POST", "/api/v1/chats", {"title": "Чат", "member_ids": [alice["id"]]}),
|
|
):
|
|
with self.subTest(path=path):
|
|
self.api.call(method, path, [401], actor=alice, body=body)
|
|
|
|
def test_missing_and_unknown_tokens(self):
|
|
for headers in ({}, {"Authorization": "Bearer " + "A" * 43},
|
|
{"Authorization": "Bearer " + self.alice["token"] + "x"}):
|
|
with self.subTest(headers=headers):
|
|
self.api.call("GET", "/api/v1/users/me", [401], headers=headers)
|
|
|
|
def test_session_survives_an_api_process_restart(self):
|
|
"""Сессии не в памяти процесса: перезапуск только API их сохраняет."""
|
|
harness.require_docker(self)
|
|
token = self.token_of()
|
|
self.api.call("GET", "/api/v1/users/me", 200, actor={"token": token}, schema="User")
|
|
|
|
restart = harness.compose("restart", "--timeout", "10", "api")
|
|
self.assertEqual(restart.returncode, 0, restart.stderr.strip()[:200])
|
|
harness.wait_ready()
|
|
|
|
self.api.call("GET", "/api/v1/users/me", 200, actor={"token": token}, schema="User")
|
|
|
|
|
|
class Storage(unittest.TestCase):
|
|
"""Как сессия на самом деле выглядит внутри Valkey."""
|
|
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
cls.api = harness.client()
|
|
cls.alice = harness.account(cls.api, "sess_store")
|
|
harness.require_docker(cls)
|
|
|
|
def test_token_is_not_stored_verbatim(self):
|
|
token = harness.login(self.api, self.alice["username"], self.alice["password"])["token"]
|
|
fingerprint = hashlib.sha256(token.encode("utf-8")).hexdigest()
|
|
|
|
self.assertEqual(harness.valkey("EXISTS", harness.SESSION_KEY_PREFIX + fingerprint), "1",
|
|
"сессия ожидается под ключом sha256(token)")
|
|
keys = harness.valkey("--scan", "--pattern", harness.SESSION_KEY_PREFIX + "*").split()
|
|
self.assertTrue(keys, "ключи сессий вообще не найдены")
|
|
for key in keys:
|
|
self.assertNotIn(token, key, "сырой токен попал в имя ключа")
|
|
|
|
ttl = int(harness.valkey("TTL", harness.SESSION_KEY_PREFIX + fingerprint))
|
|
self.assertGreater(ttl, 0, "у ключа сессии нет срока жизни: он переживёт токен")
|
|
self.assertLessEqual(ttl, int(os.environ.get("SESSION_TTL_SECONDS", "3600")) + 1)
|
|
|
|
def test_revocation_removes_the_key(self):
|
|
token = harness.login(self.api, self.alice["username"], self.alice["password"])["token"]
|
|
key = harness.SESSION_KEY_PREFIX + hashlib.sha256(token.encode("utf-8")).hexdigest()
|
|
self.assertEqual(harness.valkey("EXISTS", key), "1")
|
|
self.api.call("DELETE", "/api/v1/auth/sessions/current", 204, actor={"token": token})
|
|
self.assertEqual(harness.valkey("EXISTS", key), "0",
|
|
"отзыв должен удалять ключ, а не просто помечать его")
|
|
|
|
def test_token_entropy(self):
|
|
"""16 входов подряд должны дать 16 разных токенов: повтор ломал бы отзыв."""
|
|
tokens = set()
|
|
for _ in range(16):
|
|
tokens.add(harness.login(self.api, self.alice["username"], self.alice["password"])["token"])
|
|
self.assertEqual(len(tokens), 16)
|
|
self.assertTrue(all(len(item) >= 32 for item in tokens))
|
|
|
|
|
|
class ExpiryIsEnforcedByTheStore(unittest.TestCase):
|
|
"""Ключ, истекающий сам по себе, должен перестать аутентифицировать — без задачи очистки."""
|
|
|
|
@classmethod
|
|
def setUpClass(cls):
|
|
cls.api = harness.client()
|
|
harness.require_docker(cls)
|
|
|
|
def test_vanishing_key_means_unauthorized(self):
|
|
alice = harness.account(self.api, "sess_gone")
|
|
token = alice["token"]
|
|
key = harness.SESSION_KEY_PREFIX + hashlib.sha256(token.encode("utf-8")).hexdigest()
|
|
self.api.call("GET", "/api/v1/users/me", 200, actor=alice, schema="User")
|
|
|
|
self.assertEqual(harness.valkey("DEL", key), "1")
|
|
self.api.call("GET", "/api/v1/users/me", [401], actor=alice)
|
|
self.api.call("DELETE", "/api/v1/auth/sessions/current", [401], actor=alice)
|
|
time.sleep(0.1)
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main(verbosity=2)
|