.. _demo_user:

Создание пользователей для Citeck Community
============================================

.. contents::
   :depth: 4

.. note::

   Citeck поддерживает интеграцию с **LDAP** для централизованного управления пользователями.
   Также пользователей можно создавать вручную через **Keycloak** — этот способ описан ниже.

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

При установке с помощью Docker Compose
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Откройте консоль администратора Keycloak по адресу `http://localhost/ecos-idp/auth <http://localhost/ecos-idp/auth>`_

Перейдите в **Administration Console**: 

.. image:: _static/new_user/User_1.png
   :width: 600
   :align: center

Войдите с учётными данными по умолчанию: **admin / VeryStrongPassword**:

.. image:: _static/new_user/User_2.png
   :width: 400
   :align: center

В боковом меню перейдите в раздел **Users**:

.. image:: _static/new_user/User_3.png
   :width: 650
   :align: center

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

Кнопка **View all users** отображает список всех существующих пользователей. Для добавления нового пользователя нажмите **Add user**:

.. image:: _static/new_user/User_4.png
   :width: 650
   :align: center

Заполните как минимум поле **Username** и нажмите **Save**:

.. image:: _static/new_user/User_5.png
   :width: 550
   :align: center

Задание пароля
""""""""""""""""""

Перейдите на вкладку **Credentials**, введите пароль и подтвердите его.

.. image:: _static/new_user/User_6.png
   :width: 600
   :align: center

|

.. note::

   Если пароль должен быть временным (пользователю потребуется сменить его при первом входе), установите переключатель **Temporary** в положение **ON**.

Нажмите **Set Password** и подтвердите действие:

.. image:: _static/new_user/User_7.png
   :width: 400
   :align: center

|

.. important::

   После создания пользователь должен **выполнить первый вход в Citeck** под своими учётными данными.
   При этом в систему передаётся только **Username** (системное имя) — остальные данные необходимо заполнить отдельно.

При развертывании с использованием кроссплатформенного лончера
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

В лончере в сервисах выберите **Keycloak Admin**:

.. image:: _static/new_user/launcher_user_01.png
   :width: 700
   :align: center

Перейдите в **Administration Console**:

.. image:: _static/new_user/launcher_user_02.png
   :width: 700
   :align: center

Войдите с учётными данными по умолчанию: **admin / admin**.

.. image:: _static/new_user/launcher_user_03.png
   :width: 400
   :align: center

В боковом меню перейдите в раздел **Manage realms** и выберите **ecos-app**:

.. image:: _static/new_user/launcher_user_04.png
   :width: 700
   :align: center

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

В боковом меню перейдите в раздел **Users**, для добавления нового пользователя нажмите **Add user**:

.. image:: _static/new_user/launcher_user_05.png
   :width: 700
   :align: center

Заполните как минимум поле **Username** и нажмите **Create**:

.. image:: _static/new_user/launcher_user_06.png
   :width: 600
   :align: center

Задание пароля
""""""""""""""""""

Перейдите на вкладку **Credentials** и нажмите **Set password**:

.. image:: _static/new_user/launcher_user_07.png
   :width: 700
   :align: center

Введите пароль, подтвердите его, и нажмите **Save**:

.. image:: _static/new_user/launcher_user_08.png
   :width: 450
   :align: center

.. note::

   Если пароль должен быть временным (пользователю потребуется сменить его при первом входе), установите переключатель **Temporary** в положение **ON**.

Нажмите **Save Password**:

.. image:: _static/new_user/launcher_user_09.png
   :width: 400
   :align: center

|

.. important::

   После создания пользователь должен **выполнить первый вход в Citeck** под своими учётными данными.
   При этом в систему передаётся только **Username** (системное имя) — остальные данные необходимо заполнить отдельно.

Заполнение данных пользователя в Citeck
-----------------------------------------

В :ref:`разделе администратора <admin>` перейдите в **Пользователи** и откройте созданного пользователя в режиме редактирования:

.. image:: _static/new_user/User_8.png
   :width: 700
   :align: center

|

Заполните обязательные поля — **Имя** и **Электронная почта** — а также остальные поля при необходимости:

.. image:: _static/new_user/User_9.png
   :width: 600
   :align: center

|

.. tip::

   Чтобы задачи пользователя были доступны руководителю для контроля, заполните поле **Линейный руководитель**.

Добавление в группы
~~~~~~~~~~~~~~~~~~~~~

Нажмите **Выбрать** в блоке групп и добавьте пользователя в группы **EVERYONE** и **_orgstruct_home_**:

.. image:: _static/new_user/User_10.png
   :width: 600
   :align: center

|

.. image:: _static/new_user/User_11.png
   :width: 600
   :align: center

|

Нажмите **Сохранить**. Пользователю будут выданы права в соответствии с выбранными группами.