> Source: https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/UserGroups/

# User groups

Потребителските акаунти са организирани в логически групи, които улесняват присвояването на права за достъп до приложенията чрез договори за достъп. Групите винаги се управляват в контекста на [authentication domain](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/AuthenticationDomain/): дадена група принадлежи на точно един домейн.

Поведението на този модул зависи от типа на избрания домейн:

| Тип на домейна | Управление на групите |
|---|---|
| **Local directory** | Ръчно добавяне и изтриване. |
| **SAML** (домейни за федерация) | Ръчно добавяне и изтриване. Групите се идентифицират чрез **external id**, който съответства на идентификатора на групата при доставчика на самоличност. Предлага се групово импортиране от CSV файл. |
| **LDAP** (стандартен режим, синхронизирани групи) | Само за четене — групите се извличат автоматично от директорията. Бутоните за добавяне и изтриване са деактивирани. |
| **LDAP с ръчно управление на групите** | Ръчно добавяне и изтриване. Полето **Description** е скрито (описанието идва от директорията). |
| **Anonymous directory** | Не е приложимо — анонимните домейни не се показват в селектора на домейни. |

---

## Избор на домейн и навигация

| Елемент | Описание |
|---|---|
| **Domain** (падащ списък) | Филтрира показваните групи по домейн. Изброяват се само неанонимните домейни. Изборът определя кои бутони са активни, както и видимостта на колоната **External id**. |
| **Поле за търсене** | Филтрира списъка с групи по част от името. Търсенето се задейства 700 ms след последното натискане на клавиш или веднага с клавиша `Enter`. Елементът `×` изчиства полето. |
| **Страниране** | 15, 25 или 50 записа на страница (по подразбиране: 15). |
| **Колони на таблицата** | **Name** (с икона), **External id** (скрита освен за домейните за федерация) и **Description**. Когато няма група, таблицата показва **No available groups**; когато няма домейн, падащият списък показва **No available domains**. |

---

## Добавяне на потребителска група

1. Изберете целевия домейн в падащия списък горе вдясно.
2. Щракнете върху бутона **+**.
3. Попълнете полетата и потвърдете.

### Полета на формуляра

| Поле | Описание |
|---|---|
| **Name** | Име на групата. Задължително. Не може да се състои само от интервали. Знакът `;` не е разрешен. Уникалността се проверява в рамките на домейна, независимо от регистъра на буквите: дубликат се отхвърля със съобщението **The group already exists**. |
| **External id** | Показва се само за домейни за федерация (SAML). Съдържа идентификатора на групата при доставчика на самоличност; използва се за съпоставяне на удостоверен потребител с правилната група на Bastion. Ако остане празно, като резервна стойност се използва стойността на полето **Name**. |
| **Description** | Описание на групата в свободен текст. Знакът `;` не е разрешен. Скрито за домейните LDAP в режим на ръчно управление. |

> **Импортиране от CSV — само за домейни за федерация**
>
> За домейните SAML бутонът **Import** позволява групово добавяне на групи от CSV файл. Очакваните колони са:
>
> - `External id`
> - `Name`
> - `Description`

---

## Редактиране на потребителска група

⛔ **Съществуваща група не може да бъде редактирана**, независимо от типа на домейна. Лентата с инструменти съдържа само три действия — **Add**, **Delete** и **Import** — без иконата **Properties**, а двукратното щракване върху ред от таблицата не прави нищо.

Затова промяната на името, external id или описанието на група означава **тя да бъде изтрита и създадена отново**, като се вземат предвид договорите за достъп, които я използват (вижте частта [Изтриване на потребителска група](#delete-a-user-group)).

---

## Изтриване на потребителска група

1. Изберете една или повече групи в списъка (поддържа се избор на няколко елемента).
2. Щракнете върху бутона **×**.
3. Потвърдете: конзолата пита **Are you sure you want to delete this group?**, в множествено число, когато са избрани няколко групи.

### Специфични случаи

> **Групи, свързани с договори за достъп „за всички“**
>
> Ако една или повече от избраните групи са свързани с договор за достъп, който е насочен към **всички групи в домейна** (клауза „за всички“), преди същинското изтриване се показва междинен прозорец **Group deletion**.
>
> - Групите, които **не могат да бъдат изтрити** (блокирани от строга зависимост), са изброени най-отгоре в оранжево.
> - За всяка група, която **потенциално може да бъде изтрита**, изберете в колоната **Action**:
>     - **Delete**, за да потвърдите изтриването,
>     - **Do not delete**, за да запазите групата (стойност по подразбиране).
> - Потвърдете, за да приложите избора.

### Отчет за изтриването

Ако изтриването е неуспешно за някои групи (ограничения от страна на сървъра, които не са уловени от страна на клиента), прозорец с отчет изброява засегнатите групи със съответното съобщение за грешка.
