Руководство администратора

Навигация

Зайти в панель администратора можно с главной страницы приложения (Менеджер проектов).

image.png

В верхней части страниц расположена навигация по всем разделам (1). Большая часть разделов панели администратора собрана типовым шаблоном, где слева изображен список сущностей (3) выбранного раздела. А при выделении одного из них, в центральной части (4) отображаются параметры, соответствующие текущей вкладке этого раздела. Выход из панели администратора через кнопку «стрелка назад» (2).

image.png

Работа с элементами списка раздела (3), также построена идентичным образом:

Работа с вкладками (4) выделенного элемента списка. На большинстве вкладок разделов находится таблица, в которой собран список тех или иных сущностей связаных с разделом. Основная задача этой таблицы (как и вкладки) управлять этим списком (также идентична во всех разделах такого рода):

Раздел «Пользователи»


Раздел «Пользователи»

Вкладка «Данные»

Позволяет совершить следующие действия:

image.png



Создание пользователя

  1. Для создания пользователя необходимо нажать кнопку «Создать», расположенную под списком пользователей.
  2. В появившемся модальном окне заполнить поля «Логин» и «Пароль».
  3. В выпадающем списке выбрать роль для нового пользователя.
  4. Отметить чекбокс «Выдать лицензию», если это необходимо.
  5. После этого нажать кнопку «Готово».

image.png


Редактировать данные

На вкладке «Данные» администратор может изменить данные пользователя:

  • Пароль
  • Роль
  • Наличие лицензии
Чтобы изменения вступили в силу нужно нажать кнопку «Сохранить»

image.png





Удалить пользователя

Чтобы удалить пользователя при наведении на его логин в списке пользователей появится кнопка «корзинка».

image.png

Либо при наведении на заголовок страницы

image.png

После этого пользователь будет удален из системы. Его лицензия будет освобождена для другого пользователя

Выдача лицензии

Данное действие дублирует то же самое в разделе «Лицензии». При создании пользователя, либо при сохранении изменений система проверит есть ли в лицензионном ключе свободная лицензия с данной ролью, и если да, то добавит пользвателя в список. 

Раздел «Пользователи»

Вкладка «Потоки»

На этой странице администратор управляет доступами пользователя к потокам системы. Таблица содержит все доступы текущего пользователя к потокам. На этой странице администратору доступны следующие действия:: 


Раздел «Пользователи»

Вкладка «Группы»

На этой странице администратор управляет доступами пользователя к группам системы. Таблица содержит все группы в которые добавлен текущей пользователь. На этой странице администратору доступны следующие действия: 

Ожидается в релизе 1.1.0

Раздел «Пользователи»

Вкладка «Черновики»

На этой вкладке администратор получает доступ к списку проектов выбранного пользователя. На данной вкладке доступны все те же действия с проектом что и на одноименной вкладке в разделе «Менеджер проектов»:

Одно исключение: копирование или перенос проектов на этой вкладке осуществляется между черновиками пользователей системы. В выпадающем списке будет выведен список пользвателей

 

Ожидается в релизе 1.1.0

Раздел «Пользователи»

Вкладка «Подключения»

На этой странице администратор управляет доступами пользователя к источникам системы. Таблица содержит все доступы текущего пользователя к источникам и права. На этой странице администратору доступны следующие действия:: 

Раздел «Группы»

Функционал группировки позволяет выдавать доступ с определенными правами для потоков и источников определенной группе людей. Добавляя новых участников в группу они сразу же получают все доступы и права к сущностям которыми обладает группа

Раздел «Группы»

Вкладка «Пользователи»

Вкладка содержит таблицу пользователей группы. 

image.png

Действия доступные на вкладке:

Раздел «Группы»

Вкладка «Потоки»

На этой вкладке можно добавить выделенной группе доступ к потокам. Пользователи группы увидят все эти потоке в своем списке в менеджере проектов

Для каждого потока в списке можно задать отдельные права доступа для этой группы пользователей

image.png

Добавить поток группе
  1. Кликом по кнопке «Добавить» вызвать модальное окно выбора потока
  2. Выбрать права группы. И выбрать один или несколько потоков

    image.png


  3. Подтвердить действие кликом по кнопке «Добавить»

Удалить поток у группы
  1. Навести на строку с нужным потоком
  2. Кликнуть на иконку «Корзинка»

    image.png


  3. Подтвердить удаление

Изменить права доступа к потоку
  1. Навести на строку с нужным потоком
  2. Кликнуть на иконку «Карандаш»

    image.png


  3. В открывшемся модальном окне выбрать права
  4. Подтвердить изменение кликом на «Изменить»
Раздел «Группы»

Вкладка «Подключения»

На этой вкладке можно добавить выделенной группе доступ к подключениям к источникам. Все пользователи группы увидят эти подключения на странице загрузки данных. Все новые пользователи которые будут добавляться в группу позже, также будут получать такой доступ автоматически.

Для каждого подключения в списке можно задать отдельные права доступа для этой группы пользователей

image.png

Добавить доступ на подключение группе
  1. Кликом по кнопке «Добавить» вызвать модальное окно выбора потока
  2. Выбрать права группы.
  3. И выбрать одно или несколько поподключений

    image.png


  4. Подтвердить действие кликом по кнопке «Добавить»

Удалить у подключению у группы
  1. Навести на строку с нужным потоком
  2. Кликнуть на иконку «Корзинка»

    image.png


  3. Подтвердить удаление

Изменить права доступа к подключению
  1. Навести на строку с нужным потоком
  2. Кликнуть на иконку «Карандаш»

    image.png


  3. В открывшемся модальном окне выбрать права
  4. Подтвердить изменение кликом на «Изменить»

Раздел «Потоки»

Раздел «Потоки»

Вкладка «Доступы»

На этой вкладке администратор управляет списком пользователей и групп пользователей, имеющих доступ к выбранному потоку. Этот список вывведен в таблицу. На данной вкладке доступны все те же действия что и на одноименной вкладке в разделе «Менеджер проектов»:

Ожидается в релизе 1.1.0

Раздел «Потоки»

Вкладка «Проекты»

На этой вкладке администратор получает доступ к списку проектов выбранного потока. На данной вкладке доступны все те же действия с проектом что и на одноименной вкладке в разделе «Менеджер проектов»:

Одно исключение: администратор не имеет возможности скопировать или переместить проект в свои личные черновики, только в другой поток.

Ожидается в релизе 1.1.0

Раздел «Задания»

Раздел предназначен для создания заданий обновления проектов. В таблице выведены все проекты задания которых запускались или запускатся в системе регулярно. По клику на строке задания в секции детали (в нижней части) будут выведена дополнительная информация о результате последнего выполенеия. Она может представлять интерес для пользователя в случае, если при выполенении произошел какой-то сбой.

Со временем эта информация будет расширятся как и функционал самого раздела

image.png

Поиск осуществляется по названию проекта

Сортировка по возрастанию/убыванию кликом на заголовок столбца по которому неоходимо ее применить

Создать задание
  1. Чтобы создать новое задание откройте модальное окно кликом по кнопке «Создать» в правом верхнем углу страницы.
  2. Выберите поток и затем проект для которого неоходимо создать задание
  3. Чтобы задание выполнялось необходимо включить флаг «Активно». Этот флаг можно использовать чтобы временно отключить выполенение задания.
  4. Опишите расписание запуска строкой в формате CRON
  5. Подтвердите кликом на кнопку «Создать»

image.png

Активные директории

Это возможность импортировать пользователей и группы пользователей в систему из других источников с помощью создания подключения к доменам активных директорий. Импортированные пользователи будут иметь такие же права и роли как и все остальные пользователи созданные в системе Fastboard.

После импорта этим пользователям также как и всем остальным неоходимо выдать лицензии с необходимыими ролями. И затем выдавать доступы к потокам, источникам и т.д. Группам импортированных пользователей можно также выдавать доступы и права к ресурсам системы. Есдинственная разница с системными группами это то что их нельзя изменять. При очередном обновлении все изменения сбросятся. 

При входе в систему импортированные пользователи должны вводить те учетные данные которые им были присвоены при создании.

image.png

Страница АД очень похожа на страницу «Задания». Все действия те же, но в отношении подключения а домену.

Поиск осуществляется по названию проекта

Сортировка по возрастанию/убыванию кликом на заголовок столбца по которому неоходимо ее применить

Детали

Поключение к АД может быть регулярной или разовой операцией по синхронизации пользователей с источником. Как и в случае с обновлением данных проекта по клику на строке задания в (в нижней части) будет выведена дополнительная информация о результате последнего выполенения. Она может представлять интерес для пользователя в случае, если при выполенении произошел какой-то сбой или предупреждение.

Создать подключение

Чтобы создать новое подключение к АД откройте модальное окно кликом по кнопке «Создать» в правом верхнем углу страницы. Все поля обязательны для заполнения.

Внимание! Для настройки подключения требуются навыки работы с активными директориями. Перед началом работы  ознакомьтесь с документацией по этому функционалу.

  1. Название для подключения как оно будет отображаться в таблице подключений
  2. URL это подключения откуда будут импортированы пользователи.
  3. Авторизация. Это учетные данные для поключения к домену
  4. Фильтры импорта (для опытных пользователей АД)
    • Домен или домены через запятую 
    • Выражение для фильтрации пользователей
    • Выражение для фильтрации групп
  5. Регулярная синхронизация. Активируйте этот флаг, если необходимо переиодически синхронизировать полученый список пользователей с источником. График синхронизации описывается строкой задания в синтаксисе CRON
  6. Добавлять новых пользователей. Если оставить флаг неактивным, то количество пользователей при каждой последующей синхронизации изменяться не будет. Произойдет разовый импорт пользователей и далее эти пользователи будут только обновляться. Например, их параметры неактивности или черный список

Подтверждаем кликом по кнопке «Создать». Подключение появляется в таблице и сразу запускается. Поскольку это может быть не быстрая операция для обновления стстуса предусмотрена кнопка «Обновить» (рядом с «Создать»).

image.png

Редактирование подключения происходит по такому же принципу. Необходимо изменить требуемые параметры и сохранить изменения.

image.png

После успешного завершения импорта на вкладке «Пользователи» появится список всех полученных пользователей и групп поступивших из этого подключения. Также эти пользователи и группы появятся в системе и после выдачи им ролей и доступов смогут полноценно пользваоться системой. 

image.png

 

Удаление подключения

При удалении подключения все импортированные пользователи этого подключения также будут удалены из системы

image.png

Справочные материалы

Справочные материалы

Роли пользователей в системе

Ролевая модель Fastboard включает в себя четыре роли: администратор, разработчик, аналитик и зритель. Каждому пользователю при создании обязательно присваивается роль, определяющая его уровень возможностей.

Возможности каждой роли описаны в этой таблице:


Лицензия «Разработчик» Лицензия «Аналитик»

Администратор Разработчик Аналитик Зритель
Видит все потоки


Видит потоки к которым есть доступ
Создание, изменение, удаление потока (при наличии соответствующих прав доступа)
Создание, изменение, удаление проекта
Редактирование доступных проектов
Создание копии проекта в потоке
Перезапись проекта в потоке
Изменение проекта в потоке
Удаление проекта из потока

Создание источника данных



Редактирование скрипта загрузки



Удаление любого источника данных 


Удаление доступного источника данных (при наличии соответствующих прав доступа)

Доступ к панели администратора


Управление лицензиями


Справочные материалы

О правах доступа

В системе есть сущности доступ к которым может быть ограничен для пользователей. Такими сущностями являются:

Доступ к таким сущностям предоставляется пользователям или группам пользователе совместно с определенными правами, котоые в дальнейшем определяют этого пользваотеля возможности для этой сущности:

  1. Управление. Пользователь имеет полный доступ к управлению сущностью. Может изменять название или настройки (например подключения), выдавать и забирать доступы, удалять. Управление содержимым сущности, например, работа с проектами в потоке уже будет зависеть от его роли рамках системы.
  2. Использование. Пользователь имеет ограниченый доступ к сущности. Не может ни изменять название или настройки, ни выдавать или забирать доступы, ни удалять. Но может полноценно пользоваться содежимым сущности, например, работать с проектами в потоке, или получать данные из источника. Все что позволяет его роль в рамках системы.

Например. Создавая поток или подключение к источнику пользователь автоматически получает права на управление. И, соответственно, может распоряжаться доступом без ограничений. Выдавая такой же неограниченый доступ другим пользвателям он передает такое же право распоряжаться этой сущностью. Может изменять настройки подключения или удалить его. А пользователи с правами на использования смогут только подключиться к источнку и извлечь данные. Все изменения свойств сущности (настройки, доступы) им не доступны.

Справочные материалы

Синтаксис заданий для CRON

Синтакис представляет собой последовательность 5 символов разделенных пробелами:

1 2 3 4 5

Где цифры обозначают:

Примеры задания в крон:

# выполнение задания каждые 5 минут #
*/5 * * * *

# выполнение задания каждый день в час ночи #
0 1 * * *

# выполнение задания каждый месяц первого числа в три часа ночи пятнадцать минут #
15 3 1 * *

Как использовать операторы

Оператор позволяет указать несколько значений в поле. Существуют четыре оператора:

  1. Звездочка (*): этот оператор задает все возможные значения для поля. Например, звездочка в поле «Часы» будет эквивалентна каждому часу, а звездочка в поле месяца будет эквивалентна каждому месяцу и т.д.
  2. Запятая (,): Этот оператор задает список значений, например: «1,5,10,15,20,25».
  3. Тире (-): Этот оператор задает диапазон значений, например: «5-15» дней, что эквивалентно набору «5,6,7,8,9 … …, 13,14,15», при использования оператора «Запятая».
  4. Слеш (/): этот оператор задает значение шага, например: «0-23 /» можно использовать в поле часов, чтобы указывать выполнение команды каждый час. Шаги также разрешены после звездочки, поэтому, если Вы хотите выполнять что-то каждые два часа, просто используйте «*/2».

Вместо первых пяти полей Вы можете использовать любую из восьми специальных строк. Планировщик cron позволяет такую настройку. Это не только сэкономит Ваше время, но и улучшит читаемость.


Справочные материалы

Рефреш токены аутентификации

В системе используются два вида токенов для аутентификации. Первый из них - это основной токен, который действует лишь пару часов и используется для всех запросов на сервер. Второй рефреш-токен, имеет более продолжительный срок жизни - неделю. Когда основной токен истекает, но рефреш-токен еще действителен, происходит обновление основного. Это позволяет пользователю продолжать пользоваться сервисом без необходимости повторной аутентификации. Однако, если пользователь не заходил в приложение более недели, все токены становятся недействительными, и пользователь должен повторно пройти процесс аутентификации.
При обновлении основного токена, рефреш-токен, с помощью которого мы его обновляли, добавляется в список использованных токенов, и его больше нельзя использовать. Также вместе с новым основным токеном выдается новый рефреш-токен.

Раздел «Лицензии»

Раздел «Лицензии»

Страница «Лицензии»

На этой странице содержится информация о текущем лицензионном ключе, количестве лицензий свободных и выданных. Все пользователи которым выдана лицензия выведены в таблицу. В этой таблице происходит управление этими пользователями и их лицензиями.

image.png

Блок информации (1)

Основная задача этого блока показывать сколько дней осталось до истечения срока действия и активация лицензионного ключа. Активировать ключ можно следующим образом:

  1. Клик по кнопке «Активировать ключ»
  2. В открывшемся попапе выбрать файл ключа
  3. Подтвердить кликом по кнопке «Активировать»

Результат

Фильтр по лицензиям (2)

Показывает количество и процент использованых лицензий от общего количества и по типам. И одновременно является фильтром таблицы по типу лицензии. Кликом по одному из типов лицензии в список выведутся только пользователи с выбранным типом.

Типы лицензий в Fastboard являются взаимозаменяемыми:

  1. Админ./Разраб. выдается пользователям с ролями «Администратор» или «Разработчик» в равной степени. 
  2. Зритель/Аналитик. выдается пользователям с ролям пользователям с ролями «Зритель» или «Аналитик» также в равной степени

Например, 10 лицензий зритель/аналитик, все они могут быть выданы 10 пользователям с ролью «Аналитик», либо 1 аналитик и 9 зрителей, 2 аналитика и 8 зрителей и т.д. В отношении лицензий Админ./Разраб. работает та же логика.Но есть единственное требование: чтобы в системе всегда был хотя бы 1 администратор, иначе доступ к административной панели станет невозможным.

Таблица пользователей (3)

В таблице пользователей происходят все основные действия

Поиск. Фильтрация. Сортировка

Строка поиска отфильтрует список пользователей с лицензиями по логину. Клик по заголовку столбца отсортирует строки таблицы по выранному столбцу: Логин, роль или дата последнего посещения

image.png

Выдать лицензию пользователю

Справа сверху от таблицы нажать кнопку «выдать лицензию»

image.png

В появившемся модальном окне выбрать пользователя и подтвердить операцию кликом по кнопке «Выдать»

image.png

Результат:

Действия с пользователями

Все изменения лицензиях происходят в строках. При наведении на строку появляются иконки действий которые можно выполнить

image.png

Изменить пользователя лицензии. Например, чтобы передать лицензию другому пользователю. 

  1. В таблице лицензий в столбце пользователя кликнуть на иконку «Карандаш» (редактирование)
  2. В открывшемся модальном окне выбрать другого пользователя из списка
  3. Подтвердить кликом по кнопке «Изменить»

Изменить роль в выданной лицензии. Поскольку роли в лицензиях и в системе одни и те же, то при изменении роли в лицензии она также изменится и в системе

Вариант 1. Сделать это на странице лицензий

  1. В таблице лицензий в столбце «Роли» в строке нужного пользователя кликнуть на иконку «Карандаш» 
  2. В открывшемся модальном окне выбрать другую пользователя из списка
  3. Подтвердить кликом по кнопке «Изменить»

Вариант 2. Сделать это на странице пользователя. (Перекрестный функционал)

  1. На странице пользователя изменить роль
  2. Нажать кнопку «Сохранить»

Лишить пользователя лицензии. На странице лицензий нельзя удалить пользвателя из системы. Только из лицензионного ключа, то есть отобрать лицензию (освободить)

Вариант 1. Сделать это на странице лицензий

  1. В таблице лицензий в столбце «пользователи» в строке нужного пользователя кликнуть на иконку «Корзинка» 
  2. В открывшемся модальном окне подтвердить действие кликом по кнопке «Удалить»

Вариант 2. Сделать это на странице пользователя. (Перекрестный функционал)

  1. На странице пользователя деактивировать чекбокс «Лицензия выдана»
  2. Нажать кнопку «Сохранить»
Раздел «Лицензии»

Лицензионный ключ

Описание и атрибуты

Лицензионный ключ позволяет получить доступ к функциям программы пользователям согласно квотам обозначеным при его генерации. Без лицензионного ключа использование программы не возможно. 

Лицензионный ключ имеет следующие атрибуты:

Выпуск и передача заказчику

Осуществляется в специальнй программе на стороне владельца продукта. Выпуск ключа производится для конкретного заказчика программы согласно условиям договора поставки. Передача лицензионного ключа происходит одновременно с передачей, либо установкой программного обеспечения.

Активация

Для активации лицензионного ключа необходимо воспользоваться этой учетной записью «администратора по умолчанию» при первом запуске программы. Эта учетная запись создается автоматически при развертывании:

После корректного ввода учетных на этапе входа данных система автоматически переведет пользователя на экран для ввода лицензионного ключа. Необходимо нажать единственную кнопку на экране «Выбрать файл», в открывшемся окне проводника на вашем компьютере найти и выбрать файл лицензионного ключа, переданный поставщиком ПО и нажать кнопку «Загрузить».

image.png

Результатом успешной активации ключа будет всплывающее уведмление и станет доступной панель администратора, где можно будет создать необходимое количество пользователей, выдать им лицензии согласно квотам установленным в лицензионном ключе. 

Активация другого лицензионного ключа

Активация другого лицензионного ключа может потребоваться:

В Административной панели на вкладке «Лицензии» необходимо нажать на кнопку «Активировать ключ». После этого, так же как и при активации нового ключа, в открывшемся окне проводника на вашем компьютере найти и выбрать файл лицензионного ключа и нажать кнопку «Загрузить».

image.png


Типы лицензий для пользователей

В программе Fastboard существует дыв типа лицензий:

  1. Админ./Разраб. выдается пользователям с ролями «Администратор» или «Разработчик» в равной степени. 
  2. Зритель/Аналитик. выдается пользователям с ролями «Зритель» или «Аналитик» также в равной степени
Роли пользователей в рамках одного типа лицензии являются взаимозаменяемыми

Например, 10 лицензий зритель/аналитик, все они могут быть выданы 10 пользователям с ролью «Аналитик», либо 1 аналитик и 9 зрителей, 2 аналитика и 8 зрителей и т.д. В отношении лицензий Админ./Разраб. работает та же логика. Но есть единственное требование: чтобы в системе всегда оставался хотя бы 1 администратор, т.к. только пользователи с этой ролью имеют доступ в административную панель и могут управлять лицензиями.

Лицензия не привязывается к конкретной учетной записи пользователя и может быть передана другому пользователю. 

Количество пользователей в системе может быть больше чем лицензий. Но доступ к функциям программы получат только те пользователи которым выдана лицензия