Инструменты пользователя

Инструменты сайта


sharixopen:knowledge:modules:identity_login

Это старая версия документа!


Идентичность: LDAP, Django и единый вход

Тип: контракт. LDAP/Django описываются по исходникам; наличие возможностей и конфигурацию конкретной установки проверяют отдельно. Контракт подготовительного origin_uid согласован, реализация и миграции проверены локально; серверное применение и runtime-приёмка не подтверждены.

Раздел: Модули ShariX Open и их обязанности

Действующая идентичность и права

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-доступ или успешную приёмку каждой установки.

Связанные понятия

sharixopen/knowledge/modules/identity_login.1794755791.txt.gz · Последнее изменение: — sx_knowledge_api_open

© 2022 ShariX