Files
ipam_control/docs/changes/020-next-free-address/PLAN.md
T
ayurishchevandClaude Opus 5.5 13e17fbb47 Задачи 011-024: доработки по ревью кодовой базы и исправление находок
Ревью кодовой базы (docs/reviews/2026-09-26-codebase-review.md) и планы по каждой находке:
011 IP уникален в VRF и хранится в самом узком префиксе (addresses.vrf_id, составной FK
    с каскадом при переносе VRF, миграция 0007 с остановкой на дублях).
012 Ограничение попыток входа (login_attempts, 429 + Retry-After), выравнивание времени
    ответа, журнал без вытеснения анонимными событиями (миграция 0006).
013 Границы пагинации: отрицательные/чрезмерные limit/offset дают 422 вместо 500.
014 Экран адресов: страница свободных адресов арифметикой, пагинация в SQL.
015 Запрет адреса сети/broadcast, загрузка не выше 100 %.
016 Роль по умолчанию — viewer.
017 Проверка JWT_SECRET/ADMIN_PASSWORD при старте.
018 null в PATCH очищает текстовые поля; нейтральный текст конфликта БД.
019 Пакетная загрузка в списках вместо N+1.
020 Автоназначение адреса вне вложенных префиксов, с блокировкой префикса.
021 Advisory-lock при снятии прав администратора, уникальный lower(username) (миграция 0008).
022 Контейнер не от root, healthcheck, блокировка миграций, requirements.lock.
023 Экранирование LIKE, журнал отказов очистки, заголовки безопасности, учёт force-удаления,
    отзыв токенов при смене пароля (claim pv, миграция 0005).
024 Исправление находок ревью 011-023 (docs/reviews/2026-09-26-changes-011-023-review.md):
    сериализация попыток входа, запрет переноса адресов в адрес сети/broadcast, журнал входов,
    запрет смены своего пароля через PATCH, валидация PATCH устройства, обновлён тест токенов.

Тесты: 14 passed. Документация: README.md, docs/changes/011-024, docs/reviews.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-09-26 21:33:50 +03:00

2.0 KiB
Raw Blame History

Автоназначение адреса с учётом вложенных префиксов (изменение 020)

Находка ревью № 10 (и часть № 11 — блокировка), серьёзность — низкая. Зависит от № 011.

Context

next_free (app/services.py) исключает только адреса самого пула: если внутри пула есть дочерний префикс, выданный адрес может попасть в его диапазон. Функция перебирает хосты подряд и загружает все занятые адреса в множество. allocate_next не блокирует префикс: при параллельных запросах один получает 409 «повторите».

Решение

  1. next_free_address(net, occupied) — по образцу next_free_subnet (перескок за занятые диапазоны, без перебора): занятыми считаются адреса пула, диапазоны дочерних префиксов того же VRF и (для IPv4 ≤ /30) адрес сети и broadcast.
  2. allocate_next: SELECT … FOR UPDATE строки префикса (как в allocate_subnet) — параллельные запросы сериализуются и получают разные адреса.
  3. Старую next_free удалить.

Файлы

app/services.py, app/api/v1/prefixes.py, tests/test_api.py, README.md (автоназначение).

Тест

Пул /24 с дочерним /30 (.0–.3) и занятым .5: POST …/addresses/next → .4; ещё раз → .6. Параллельно 5 запросов (потоки) → 5 разных адресов, все 201.

Проверка

pytest -q; UI не меняется (кнопка автоназначения отсутствует в UI — проверка через Swagger).