Allow bounded SSO clock tolerance for IAS integration

This commit is contained in:
Aleksandr Meshchryakov
2026-09-28 14:19:15 +02:00
parent 3f5f525708
commit b139a4ea50
3 changed files with 28 additions and 1 deletions

View File

@@ -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` пользователю:

View File

@@ -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",

View File

@@ -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")