From 1aa537c9a76ef9786cf647dd7660acceb674824c Mon Sep 17 00:00:00 2001 From: Aleksandr Meshchryakov Date: Mon, 28 Sep 2026 11:25:43 +0200 Subject: [PATCH 1/2] 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 ddb3eb4..a54ddb3 100644 --- a/README.md +++ b/README.md @@ -258,3 +258,11 @@ make pre-commit `SSO_GROUP_ROLE_MAP_JSON` — JSON-объект с именами доверенных групп ИАС ЕЦП в ключах и значениями только `user` или `admin`, например `{"ias_admin":"admin"}`. Группы вне этого списка не дают повышенных прав. Созданный через SSO пользователь без группы из списка получает `user`; при последующем входе исчезнувшая admin-группа понижает его до `user`. У ранее существовавшей локальной учётной записи ручная роль сохраняется. Только явная настройка `SSO_MANAGE_LINKED_USER_ROLES=true` передаёт управление её ролью SSO. Нормализованные группы, ОКПО, тип пользователя и организация сохраняются в `SsoIdentity`, исходный JWT не сохраняется. Публичный PEM следует монтировать в контейнер как отдельный read-only файл и указывать его контейнерный путь в `SSO_PUBLIC_KEY_PATH`. Не размещайте PEM, реальные `.env` и токены обмена в webroot или offline-архиве. Полностью изолированная установка описана в [deploy/offline/README.md](deploy/offline/README.md). + +### Контракт 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 576ef8a..8040d56 100644 --- a/tests/apps/user/test_sso.py +++ b/tests/apps/user/test_sso.py @@ -119,6 +119,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()) From 357ef4cdf005e062435d98cbccd38465a0523b23 Mon Sep 17 00:00:00 2001 From: Aleksandr Meshchryakov Date: Mon, 28 Sep 2026 11:28:11 +0200 Subject: [PATCH 2/2] fix(auth): keep SSO compatibility route out of OpenAPI --- src/apps/user/sso_views.py | 6 ++++++ src/core/api_v1_urls.py | 8 ++++++-- tests/apps/user/test_sso.py | 20 ++++++++++++++++++++ 3 files changed, 32 insertions(+), 2 deletions(-) diff --git a/src/apps/user/sso_views.py b/src/apps/user/sso_views.py index 48ec62b..007d05e 100644 --- a/src/apps/user/sso_views.py +++ b/src/apps/user/sso_views.py @@ -183,3 +183,9 @@ class SsoCallbackView(APIView): response = HttpResponse(status=303) response["Location"] = redirect_path return response + + +class SsoCallbackWithoutSlashView(SsoCallbackView): + """Accept legacy callback URLs without duplicating the public API schema.""" + + swagger_schema = None diff --git a/src/core/api_v1_urls.py b/src/core/api_v1_urls.py index 7366654..671dea0 100644 --- a/src/core/api_v1_urls.py +++ b/src/core/api_v1_urls.py @@ -11,7 +11,11 @@ from apps.core.views import ( BackgroundJobStatusView, BackgroundJobStreamView, ) -from apps.user.sso_views import SsoCallbackView, SsoStartView +from apps.user.sso_views import ( + SsoCallbackView, + SsoCallbackWithoutSlashView, + SsoStartView, +) from django.urls import include, path app_name = "api_v1" @@ -24,7 +28,7 @@ jobs_urlpatterns = [ urlpatterns = [ # Accept IAS POST forms without a slash without CommonMiddleware's 301. - path("auth/sso", SsoCallbackView.as_view()), + path("auth/sso", SsoCallbackWithoutSlashView.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 8040d56..60ddd30 100644 --- a/tests/apps/user/test_sso.py +++ b/tests/apps/user/test_sso.py @@ -40,6 +40,26 @@ class SsoStartViewTest(SimpleTestCase): {"target": ["fkc_ecos"], "path": ["/open-data?scope=rosatom"]}, ) + def test_callback_alias_does_not_duplicate_openapi_operations(self): + from core.api_v1_urls import urlpatterns + from drf_yasg import openapi + from drf_yasg.generators import OpenAPISchemaGenerator + + schema = OpenAPISchemaGenerator( + info=openapi.Info(title="SSO", default_version="v1"), + patterns=[ + item for item in urlpatterns if str(item.pattern).startswith("auth/sso") + ], + ).get_schema(request=None, public=True) + operations = [ + operation.operation_id + for item in schema.paths.values() + for _, operation in item.operations + ] + self.assertEqual(len(operations), len(set(operations))) + self.assertIn("/sso/", schema.paths) + self.assertNotIn("/sso", schema.paths) + def test_rejects_absolute_redirect_path(self): response = self.client.get( "/api/v1/auth/sso/start/",