Compare commits

..

3 Commits

Author SHA1 Message Date
Aleksandr Meshchryakov
d40d2c1abc fix(auth): keep SSO compatibility route out of OpenAPI 2026-09-28 11:28:11 +02:00
Aleksandr Meshchryakov
c068022705 fix(auth): accept SSO callback without trailing slash 2026-09-28 11:25:43 +02:00
avm
b37f521cd8 Merge pull request 'fix: group JSON source exports by organization (main)' (#21) from hotfix/json-source-export-20260927 into main
Some checks failed
Deploy Customer Main / Build, Push, Deploy (push) Failing after 51s
CI/CD Pipeline / Code Quality Checks (push) Successful in 1m34s
CI/CD Pipeline / Run Tests (push) Successful in 3m33s
CI/CD Pipeline / Build and Push Dev Images (push) Has been skipped
CI/CD Pipeline / Deploy Dev via Compose (push) Has been skipped
2026-09-27 11:43:48 +03:00
4 changed files with 88 additions and 1 deletions

View File

@@ -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://<state-corp-host>/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: <redirect_path>`. GET callback возвращает 405; токен в URL не принимается. Пустая форма при включённом SSO возвращает 400, при выключенном — 503.
Перед выпуском проверяйте каждый контур отдельно: `SSO_ENABLED`, issuer, service code/target, соответствие callback у ИАС и доступность публичного ключа в контейнере. Включение dev не включает main. Правка маршрута не заменяет настройку провайдера и полный вход с настоящим SSO-токеном. Не копируйте токены/cookie в логи или отчёты.

View File

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

View File

@@ -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"
@@ -23,6 +27,8 @@ jobs_urlpatterns = [
]
urlpatterns = [
# Accept IAS POST forms without a slash without CommonMiddleware's 301.
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")),

View File

@@ -39,6 +39,26 @@ class SsoStartViewTest(SimpleTestCase):
{"target": ["fkc"], "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/",
@@ -118,6 +138,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())