diff --git a/README.md b/README.md index 7fd3054..c6b77a7 100644 --- a/README.md +++ b/README.md @@ -259,6 +259,8 @@ make pre-commit ИАС отправляет `POST /api/v1/auth/sso/` с `Content-Type: application/x-www-form-urlencoded`: обязательное поле `sso_token`, необязательное `redirect_path` (локальный путь, по умолчанию `/main`). Вариант URL без завершающего `/` тоже принимает форму напрямую: промежуточного 301, теряющего POST, нет. Для регистрации в ИАС используйте канонический URL со слешем. +`SSO_CLOCK_SKEW_SECONDS` задаёт допустимое расхождение часов в секундах: по умолчанию 5, разрешено от 0 до 60. Увеличивайте его только при измеренном расхождении с ИАС: допуск применяется к `iat`, `nbf` и `exp`, поэтому продлевает окно принятия просроченного токена на указанное число секунд. Ограничение `exp - iat <= 60` и защита от повторного использования сохраняются. Для stage-портала ИАС используйте маршрут `/sso-redirect` без завершающего слеша; вариант со слешем может перенаправить на главную страницу вместо SSO. + Email в SSO-токене необязателен: отсутствующее поле, `null` и пустая строка означают отсутствие почты. Новый SSO-пользователь создаётся с `email=NULL` и `is_verified=false`; фиктивный адрес не генерируется. Переданный непустой email проверяется на формат, длину и конфликты. Если при следующем входе email отсутствует, сохранённый адрес и его признак подтверждения остаются прежними. Обычная регистрация по-прежнему требует email. Повторный вход использует неизменяемую пару `(iss, user_id)`. Автоматическая первичная привязка к локальному аккаунту по-прежнему требует совпадения логина и непустой почты. При совпадении только логина вход отклоняется. Администратор может явно привязать существующий аккаунт после проверки принадлежности внешнего `user_id` пользователю: diff --git a/src/settings/base.py b/src/settings/base.py index 9e33de9..189a75b 100644 --- a/src/settings/base.py +++ b/src/settings/base.py @@ -29,7 +29,9 @@ SSO_ISSUER = os.getenv("SSO_ISSUER", "dvr") SSO_PUBLIC_KEY_PATH = os.getenv("SSO_PUBLIC_KEY_PATH", "") SSO_SESSION_TTL_SECONDS = int(os.getenv("SSO_SESSION_TTL_SECONDS", "7200")) SSO_TOKEN_MAX_AGE_SECONDS = 60 -SSO_CLOCK_SKEW_SECONDS = 5 +SSO_CLOCK_SKEW_SECONDS = int(os.getenv("SSO_CLOCK_SKEW_SECONDS", "5")) +if not 0 <= SSO_CLOCK_SKEW_SECONDS <= 60: + raise ValueError("SSO_CLOCK_SKEW_SECONDS must be between 0 and 60") warnings.filterwarnings( "ignore", diff --git a/tests/apps/user/test_sso.py b/tests/apps/user/test_sso.py index 7aa04d5..2f3075a 100644 --- a/tests/apps/user/test_sso.py +++ b/tests/apps/user/test_sso.py @@ -486,6 +486,29 @@ class SsoCallbackViewTest(APITestCase): ) self.assertFalse(User.objects.exists()) + @override_settings(SSO_CLOCK_SKEW_SECONDS=60) + def test_bounded_clock_tolerance_accepts_provider_clock_ahead(self): + now = int(datetime.now(UTC).timestamp()) + claims = self._claims(email=None, iat=now + 45, exp=now + 105) + self.assertEqual( + self._post_callback(self._encode_claims(claims)).status_code, 303 + ) + + @override_settings(SSO_CLOCK_SKEW_SECONDS=60) + def test_clock_tolerance_keeps_future_expiry_and_lifetime_limits(self): + now = int(datetime.now(UTC).timestamp()) + cases = ( + {"iat": now + 65, "exp": now + 125}, + {"iat": now - 130, "exp": now - 70}, + {"iat": now, "exp": now + 61}, + {"iat": now, "exp": now + 60, "nbf": now + 65}, + ) + for index, values in enumerate(cases): + with self.subTest(index=index): + token = self._token(email=None, jti=f"clock-limit-{index}", **values) + self.assertEqual(self._post_callback(token).status_code, 403) + self.assertFalse(User.objects.exists()) + def test_rejects_missing_required_claim(self): claims = self._claims() claims.pop("user_id")