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

# User groups

Lietotāju konti ir sakārtoti loģiskās grupās, kas vienkāršo piekļuves tiesību piešķiršanu lietojumprogrammām, izmantojot piekļuves līgumus. Grupas vienmēr tiek pārvaldītas kāda [authentication domain](https://docs.cyberelements.io/bastion/4.6/lv/Usage/AdminConsoleReference/AuthenticationDomain/) kontekstā: grupa pieder tieši vienam domēnam.

Šī moduļa darbība ir atkarīga no atlasītā domēna tipa:

| Domēna tips | Grupu pārvaldība |
|---|---|
| **Local directory** | Manuāla pievienošana un dzēšana. |
| **SAML** (federācijas domēni) | Manuāla pievienošana un dzēšana. Grupas tiek identificētas pēc **external id**, kas atbilst grupas identifikatoram identitātes sniedzējā. Ir pieejama lielapjoma importēšana no CSV. |
| **LDAP** (standarta režīms, sinhronizētas grupas) | Tikai lasāms — grupas tiek automātiski izgūtas no direktorija. Pievienošanas un dzēšanas pogas ir atspējotas. |
| **LDAP ar manuālu grupu pārvaldību** | Manuāla pievienošana un dzēšana. Lauks **Description** ir paslēpts (apraksts tiek iegūts no direktorija). |
| **Anonymous directory** | Nav piemērojams — anonīmie domēni netiek rādīti domēnu atlasītājā. |

---

## Domēna atlase un navigācija

| Elements | Apraksts |
|---|---|
| **Domain** (nolaižamā izvēlne) | Filtrē parādītās grupas pēc domēna. Tiek uzskaitīti tikai domēni, kas nav anonīmi. Atlase nosaka, kuras pogas ir iespējotas, un kolonnas **External id** redzamību. |
| **Meklēšanas lauks** | Filtrē grupu sarakstu pēc nosaukuma apakšvirknes. Meklēšana tiek aktivizēta 700 ms pēc pēdējā taustiņsitiena vai uzreiz, nospiežot taustiņu `Enter`. Aktivizētājs `×` notīra lauku. |
| **Pagination** | 15, 25 vai 50 ieraksti lapā (noklusējums: 15). |
| **Tabulas kolonnas** | **Name** (ar ikonu), **External id** (paslēpta, izņemot federācijas domēnus) un **Description**. Ja nav nevienas grupas, tabulā tiek rādīts **No available groups**; ja nav neviena domēna, nolaižamajā izvēlnē tiek rādīts **No available domains**. |

---

## Lietotāju grupas pievienošana

1. Augšējā labajā stūrī esošajā nolaižamajā sarakstā atlasiet mērķa domēnu.
2. Noklikšķiniet uz pogas **+**.
3. Aizpildiet laukus un apstipriniet.

### Veidlapas lauki

| Lauks | Apraksts |
|---|---|
| **Name** | Grupas nosaukums. Obligāts. Nedrīkst sastāvēt tikai no atstarpēm. Rakstzīme `;` nav atļauta. Unikalitāte tiek pārbaudīta domēna ietvaros neatkarīgi no lielajiem un mazajiem burtiem: dublikāts tiek noraidīts ar ziņojumu **The group already exists**. |
| **External id** | Tiek parādīts tikai federācijas domēniem (SAML). Satur grupas identifikatoru identitātes sniedzējā; to izmanto, lai autentificētu lietotāju piesaistītu pareizajai Bastion grupai. Ja tas ir atstāts tukšs, kā rezerves vērtība tiek izmantota lauka **Name** vērtība. |
| **Description** | Grupas brīva teksta apraksts. Rakstzīme `;` nav atļauta. Paslēpts LDAP domēniem manuālās pārvaldības režīmā. |

> **CSV importēšana — tikai federācijas domēniem**
>
> SAML domēniem poga **Import** ļauj lielapjomā pievienot grupas no CSV faila. Paredzētās kolonnas ir šādas:
>
> - `External id`
> - `Name`
> - `Description`

---

## Lietotāju grupas rediģēšana

⛔ **Esošu grupu nevar rediģēt** neatkarīgi no domēna tipa. Rīkjoslā ir tikai trīs darbības — **Add**, **Delete** un **Import** — bez ikonas **Properties**, un dubultklikšķis uz tabulas rindas neko nedara.

Tāpēc, lai mainītu grupas nosaukumu, External id vai aprakstu, grupa ir **jāizdzēš un jāizveido no jauna**, ņemot vērā piekļuves līgumus, kas uz to atsaucas (skatiet nodaļu [Lietotāju grupas dzēšana](#delete-a-user-group)).

---

## Lietotāju grupas dzēšana

1. Sarakstā atlasiet vienu vai vairākas grupas (tiek atbalstīta vairāku vienumu atlase).
2. Noklikšķiniet uz pogas **×**.
3. Apstipriniet: konsole jautā **Are you sure you want to delete this group?**, daudzskaitlī, ja ir izvēlētas vairākas grupas.

### Īpaši gadījumi

> **Grupas, kas saistītas ar piekļuves līgumiem „visiem“**
>
> Ja viena vai vairākas atlasītās grupas ir saistītas ar piekļuves līgumu, kas attiecas uz **visām domēna grupām** (klauzula „visiem“), pirms faktiskās dzēšanas tiek parādīts starplogs **Group deletion**.
>
> - **Nedzēšamās** grupas (bloķētas stingras atkarības dēļ) ir uzskaitītas augšdaļā oranžā krāsā.
> - Katrai **potenciāli dzēšamajai** grupai kolonnā **Action** izvēlieties:
>     - **Delete**, lai apstiprinātu dzēšanu,
>     - **Do not delete**, lai saglabātu grupu (noklusējuma vērtība).
> - Apstipriniet, lai piemērotu izdarītās izvēles.

### Dzēšanas atskaite

Ja dažu grupu dzēšana neizdodas (servera puses ierobežojumi, kas netika konstatēti klienta pusē), atskaites logā tiek uzskaitītas attiecīgās grupas ar saistīto kļūdas ziņojumu.
