From c068022705c62d16fea3c6bf0a9cdedf4e3bfb83 Mon Sep 17 00:00:00 2001 From: Aleksandr Meshchryakov Date: Mon, 28 Sep 2026 11:25:43 +0200 Subject: [PATCH] fix(auth): accept SSO callback without trailing slash --- README.md | 8 +++++++ src/core/api_v1_urls.py | 2 ++ tests/apps/user/test_sso.py | 47 +++++++++++++++++++++++++++++++++++++ 3 files changed, 57 insertions(+) diff --git a/README.md b/README.md index b2dea39..1457106 100644 --- a/README.md +++ b/README.md @@ -254,3 +254,11 @@ make pre-commit Дополнительный SSO-вход включается переменной `SSO_ENABLED=true`. Публичный P-256 PEM-ключ провайдера должен быть смонтирован вне репозитория и webroot, а путь к нему передан в `SSO_PUBLIC_KEY_PATH`. Используются настройки `SSO_PROVIDER_URL`, `SSO_SERVICE_CODE` (по умолчанию `fkc`), `SSO_ISSUER` (по умолчанию `dvr`) и `SSO_SESSION_TTL_SECONDS` (по умолчанию `7200`). Перед включением зарегистрируйте callback `https:///api/v1/auth/sso/` в ИАС ЕЦП и сначала включите backend, затем frontend-кнопку. Для отката достаточно установить `SSO_ENABLED=false`; JWT-вход продолжит работать. + +### Контракт callback ИАС + +ИАС отправляет `POST /api/v1/auth/sso/` с `Content-Type: application/x-www-form-urlencoded`: обязательное поле `sso_token`, необязательное `redirect_path` (локальный путь, по умолчанию `/main`). Вариант URL без завершающего `/` тоже принимает форму напрямую: промежуточного 301, теряющего POST, нет. Для регистрации в ИАС используйте канонический URL со слешем. + +После успешной проверки одноразового ES256 JWT backend устанавливает Django session cookie и CSRF cookie и отвечает `303 Location: `. GET callback возвращает 405; токен в URL не принимается. Пустая форма при включённом SSO возвращает 400, при выключенном — 503. + +Перед выпуском проверяйте каждый контур отдельно: `SSO_ENABLED`, issuer, service code/target, соответствие callback у ИАС и доступность публичного ключа в контейнере. Включение dev не включает main. Правка маршрута не заменяет настройку провайдера и полный вход с настоящим SSO-токеном. Не копируйте токены/cookie в логи или отчёты. diff --git a/src/core/api_v1_urls.py b/src/core/api_v1_urls.py index f79ba7a..7366654 100644 --- a/src/core/api_v1_urls.py +++ b/src/core/api_v1_urls.py @@ -23,6 +23,8 @@ jobs_urlpatterns = [ ] urlpatterns = [ + # Accept IAS POST forms without a slash without CommonMiddleware's 301. + path("auth/sso", SsoCallbackView.as_view()), path("auth/sso/", SsoCallbackView.as_view(), name="sso-callback"), path("auth/sso/start/", SsoStartView.as_view(), name="sso-start"), path("analytics/", include("apps.organization.analytics_root_urls")), diff --git a/tests/apps/user/test_sso.py b/tests/apps/user/test_sso.py index 1c560d8..b243c4b 100644 --- a/tests/apps/user/test_sso.py +++ b/tests/apps/user/test_sso.py @@ -118,6 +118,53 @@ class SsoCallbackViewTest(APITestCase): content_type="application/x-www-form-urlencoded", ) + @override_settings(DEBUG=False) + def test_callback_without_slash_preserves_form_and_creates_session(self): + response = self.client.post( + self.callback_url.rstrip("/"), + urlencode({"sso_token": self._token(), "redirect_path": "/open-data"}), + content_type="application/x-www-form-urlencoded", + ) + self.assertEqual(response.status_code, 303) + self.assertEqual(response["Location"], "/open-data") + self.assertIn("sessionid", response.cookies) + self.assertIn("csrftoken", response.cookies) + self.assertTrue(response.cookies["sessionid"]["secure"]) + self.assertTrue(response.cookies["sessionid"]["httponly"]) + self.assertEqual(self.client.get("/api/v1/users/me/").status_code, 200) + + @override_settings(DEBUG=False) + def test_both_callback_urls_reject_invalid_forms_and_get(self): + for url in (self.callback_url, self.callback_url.rstrip("/")): + with self.subTest(url=url): + self.assertEqual(self.client.get(url).status_code, 405) + missing = self.client.post( + url, "", content_type="application/x-www-form-urlencoded" + ) + self.assertEqual(missing.status_code, 400) + unsafe = self.client.post( + url, + urlencode( + { + "sso_token": self._token(), + "redirect_path": "https://attacker.example/", + } + ), + content_type="application/x-www-form-urlencoded", + ) + self.assertEqual(unsafe.status_code, 400) + + @override_settings(DEBUG=False) + def test_callback_alias_cannot_replay_token_used_on_canonical_url(self): + token = self._token() + self.assertEqual(self._post_callback(token).status_code, 303) + response = self.client.post( + self.callback_url.rstrip("/"), + urlencode({"sso_token": token}), + content_type="application/x-www-form-urlencoded", + ) + self.assertEqual(response.status_code, 403) + def test_valid_token_creates_regular_user_identity_and_session(self): response = self._post_callback(self._token())