fix(auth): accept SSO callback without trailing slash

This commit is contained in:
Aleksandr Meshchryakov
2026-09-28 11:25:43 +02:00
parent b37f521cd8
commit c068022705
3 changed files with 57 additions and 0 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

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

View File

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