Skip to main content

Синхронизация с DIS: создание, удаление, обновление, сохранение данных

Бизнес-требования

От Fastboard:

  • При создании/копировании/перемещении проекта отправляем запрос в DIS на создание там источника (области + main таблицы для проекта)
  • Создаем автоматически источник в FB, связанный с этой пустой таблицей в DIS
  • У таких источников будет новый параметр link с урлом таблицы в DIS
  • Отправляем запрос на все права для пользователя-создателя проекта, а также всех админов в системе
  • При отправке запроса на все права на бэке хэшируем связку из пароля пользователя и его прав доступа, хэш передаем в DIS
  • При удалении также не забываем отправить запрос на удаление в DIS
  • При входе в диспетчер данных отдавать список не только источников, доступных пользователю, но и источников из DIS для данного проекта
  • При создании новых пользователей в FB отправлять данные о пользователях в DIS
  • В своих черновиках у пользователей автоматически есть все 3 роли для доступа

От DIS:

  • На каждый проект в FB создается пространство с как минимум одной системной таблицей
  • Таблица становится источником этого проекта. Остальные таблицы, созданные в этом пространстве, автоматически становятся источниками этого проекта
  • FB отдает данные пользователей, имеющих доступ к формам ввода. Необходимо сохранять эти данные и проверять доступность по этим данным при попытке пользователя получить доступ к форме ввода
  • При получении информации о создании нового пользователя в FB заводить ему учетку в DIS с новым уровнем доступа – Fastboard
  • При входе пользователя с учеткой Fastboard обязательно должны быть получены:
    • Роль пользователя (текущая)
    • Хэш-пароль для подтверждения доступа и роли

Примерная структура таблицы-связки пользователей с таблицами в DIS:

  • id пользователя
  • id таблицы
  • Роль пользователя
  • Хэш-пароль для входа этого пользователя в эту таблицу с этой ролью

Решение

Синхронизация создания, изменения и удаления данных пользователей и проектов в Fastboard с системой DIS по API с использованием хэширования для повышения безопасности.

Создание и хранение hash-паролей

Системная логика (бэкенд)

Создание:

  • Новая функция для хэширования паролей для сохранения безопасности при их передаче в API DIS
  • На входе функция получает:
    • id пользователя (можно массивом)
    • id проекта (можно массивом)
    • Роль из списка (одна или несколько массивом):
      • "read" для "Просмотреть форму ввода" 
      • "write" для "Ввести данные в форму ввода"
      • "change" для "Редактировать форму ввода"
    • Пароль пользователя (можно массивом)
  • На выходе функция предоставляет hash-пароль (или массив hash-паролей), который сохраняется в системной таблице и может быть запрошен отдельным запросом

Хранение:

  • Предполагается существование отдельной таблицы-связки между пользователями и проектами
  • В таблице должны быть следующие поля:
    • id пользователя
    • id проекта
    • Роль из списка:
      • "read" для "Просмотреть форму ввода" 
      • "write" для "Ввести данные в форму ввода"
      • "change" для "Редактировать форму ввода"
    • hash-пароль

Создание/изменение пользователей

Системная логика (бэкенд)

  • Новый запрос POST {передать данные нового пользователя в DIS}. В запросе передаётся:
    • Логин созданного пользователя
  • Обязательно должна выполняться проверка на роль пользователя – вызывать такой запрос может только пользователь с ролью "Администратор системы" или "Администратор тенанта"
  • Триггер запроса – создание пользователя в Fastboard

  • Новый запрос PATCH {обновить данные пользователя в DIS}. В запросе передаётся:
    • Старый логин пользователя
    • Новый логин пользователя
  • Обязательно должна выполняться проверка на роль пользователя – вызывать такой запрос может только пользователь с ролью "Администратор системы" или "Администратор тенанта"
  • Триггер запроса – смена логина пользователя в Fastboard

Создание/копирование проектов

Системная логика (фронтенд)

  • При создании или копировании проекта в системе выполнять запрос в API Fastboard – POST {передать данные на бэкенд FB для создания пространства с таблицами в DIS}, который передаёт в себе:
    • id проекта (нового или копии)
    • Массив id пользователей:
      • создателя
      • всех пользователей-администраторов системы и администраторов тенанта, в котором создается/копируется этот проект
        • для этого выполняется запрос на бэкенд для получения списка пользователей с указанными ролями
    • Массив ролей (все из списка):
      • "read"
      • "write"
      • "change"

Системная логика (бэкенд)

  • Новый запрос POST {передать данные на бэкенд FB для создания пространства с таблицами в DIS} – создать новую запись в таблице-связке пользователей с проектами в рамках FB (для доступа к источникам DIS).
    • В запросе передаётся:
      • id пользователя (можно массивом)
      • id проекта (можно массивом)
      • Роль из списка (одна или несколько массивом):
        • "read" для "Просмотреть форму ввода" 
        • "write" для "Ввести данные в форму ввода"
        • "change" для "Редактировать форму ввода"
    • Запрос вызывает функцию создания hash-пароля
      • Для каждого указанного пользователя берется из БД его пароль и создается новый hash-пароль для каждой уникальной связки "id_пользователя – id_проекта – роль" (количество hash-паролей на выходе равно произведению из количества id пользователей на количество id проектов на количество ролей в запросе)
      • Для каждой связки "id_пользователя – id_проекта – роль" проверяется наличие записи в БД. Если запись существует, перезаписывать hash-пароль (выполнять функцию) НЕ требуется
    • На фронтенд функция ничего не возвращает
    • Триггер запроса – вызов с фронтенда
  • Новый запрос POST {передать данные в DIS для создания там нового пространства для проекта и его системной таблицы}.
    • Выполняетсяв API DIS
    • В запросе передаётся:
      • id проекта (нового или копии)
      • id создателя (пользователя)
      • Массив hash-паролей для пользователя для ролей:
        • Просмотреть форму ввода
        • Ввести данные в форму ввода
        • Редактировать форму ввода
      • Список id всех пользователей-администраторов системы и администраторов тенанта, в котором создается/копируется этот проект
      • Массив массивов hash-паролей для всех админов для ролей:
        • Просмотреть форму ввода
        • Ввести данные в форму ввода
        • Редактировать форму ввода
    • В ответ приходит массив с данными для подключения источника:
      • Название = "DIS_{Название проекта}"
      • СУБД
      • Хост
      • Порт
      • База данных
        • Логин и пароль равны логину и hash-паролю уровня "Редактировать форму ввода" пользователя-создателя
    • Обязательно должна выполняться проверка на роль пользователя – вызывать такой запрос может только пользователь с возможностью создавать проекты (аналитик/разработчик/любой админ)
    • Триггер запроса – вызов с фронтенда или запрос POST {передать данные на бэкенд FB для создания пространства с таблицами в DIS}

Удаление проектов