Это старая версия документа!
Содержание
Идентичность: LDAP, Django и единый вход
Тип: контракт. LDAP/Django описываются по исходникам; наличие возможностей и
конфигурацию конкретной установки проверяют отдельно. Контракт подготовительного
origin_uid согласован, реализация и миграции проверены локально; серверное
применение и runtime-приёмка не подтверждены.
Действующая идентичность и права
LDAP обслуживает учётные данные и инфраструктурные интеграции. Django User — локальная запись пользователя приложения; корректная первая LDAP-аутентификация может материализовать её, а Demo seed может создать заранее. Наличие записи в каталоге не означает наличие локального Django User до материализации.
Вход web/mobile, регистрация и роли должны сохранять единый контракт. Имя входа,
Django PK, LDAP uid, POSIX uidNumber и права выполнять бизнес-операции —
разные понятия, даже когда текущие значения совпадают численно. В действующих
маппингах ещё есть зависимость id ← uid; новый подготовительный столбец её
не меняет. LDAP uid — имя, uidNumber — целочисленный системный UID для
POSIX-доступа. Длинный origin_uid не подставляется ни в один из этих атрибутов.
Сессия и LDAP/Django groups не заменяют effective access к объекту. При смене контекста сервиса повторно проверяются область пользователя, членство и права.
Подготовительный origin_uid
Полем владеет общий модуль user; контракт применяется в ShariX Open и Platform.
origin_uid пока только хранится. Он не является логином, UUID-типом БД,
ключом API/синхронизации, подтверждением личности, разрешением или основанием
объединения аккаунтов. Старые PK, связи, пароль, телефон и роли сохраняются.
Формат — ровно 18 строчных символов base36, алфавит 0–9, a–z:
| Часть | Длина | Правило |
|---|---|---|
| Поколение | 1 | Сначала 0, далее 1..z; после 36 занятых значений — ошибка. |
| Хеш телефона | 13 | SHA-256 от ASCII sharix:user-origin:v1: и нормализованного телефона; big-endian integer modulo 36**13, base36 с нулями слева. |
| ID источника | 4 | Разрешённый установкой METASERVICE_ID, диапазон 0..1679615, base36 с нулями слева. |
У телефона удаляются один начальный + и разделители '' -().''/ASCII whitespace;
результат должен содержать непустые ASCII-цифры. Страна и национальный префикс не
угадываются; короткие цифровые Demo-номера поддерживаются. Это нормализация
отпечатка, а не изменение существующего валидатора или сохранённого телефона.
Значение создаётся один раз из телефона и источника на момент присвоения. Для исторической записи неизвестная первоначальная история регистрации не восстанавливается по предположению. Смена телефона или конфигурации источника не пересчитывает уже сохранённое значение. Публичное редактирование поля закрыто; прямые update/bulk_update этого поля отклоняются.
Повторное использование номера и уникальность
При занятом кандидате читается текущий телефон его владельца. Если полный нормализованный телефон совпадает, создание сообщает о существующем аккаунте; вход, возврат аккаунта или автоматическое объединение не выполняются. Если владелец уже сменил телефон, проверяется следующее поколение. Совпадение только сокращённого хеша разных полных телефонов также повышает поколение, а не устанавливает идентичность.
Уникальность сохранённых значений обеспечивается ограничением БД. Конкурентный конфликт этого ограничения перечитывается после savepoint; другие ошибки БД не маскируются. Нет случайного fallback или обнуления поколения. Удалённые аккаунты этим этапом не получают отдельного реестра исторических резервирований.
Источник берётся из текущего config без нового env-параметра. Demo 0 остаётся
0; одинаковые телефон/source на разных установках дают одинаковое начальное
значение. Здесь не создаётся глобальный реестр источников. Совпадение значения
между хостами само по себе не разрешает связывание учётных записей.
Заполнение и проверка установки
Committed migrations добавляют nullable столбец и уникальность, затем проверяют план и заполняют только отсутствующие значения в порядке PK. Алгоритм v1 фиксирован; старый baseline и старые пользовательские ключи не переписываются. Прерванное заполнение повторяется с сохранением уже присвоенных значений.
Nullable допускает старые процессы во время обновления. После штатного restart выполняется одноразовая команда владельца модуля:
./venv/bin/python manage.py backfill_user_origin_uids ./venv/bin/python manage.py backfill_user_origin_uids --apply ./venv/bin/python manage.py backfill_user_origin_uids
Без –apply команда только читает. Последний preview должен показать
missing=0 и remaining=0. Вывод содержит счётчики, а не телефоны/UID.
Неприменимые исходные данные и исчерпание поколений блокируют заполнение;
выдумывать телефон из PK, очищать выданные значения или сливать аккаунты нельзя.
Нового poller/cron и обращения к LDAP эта команда не вводит.
Порядок получения исходников, миграций и перезапуска — штатное обновление ShariX Open. Общий модуль сначала проверяют в ShariX Open, затем получают опубликованный код в других сборках. Локальные тесты с подменой ORM не доказывают серверную миграцию, SSH-доступ или успешную приёмку каждой установки.