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

# User groups

Vartotojų paskyros suskirstytos į logines grupes, kurios supaprastina prieigos prie taikomųjų programų teisių priskyrimą per prieigos sutartis. Grupės visada valdomos domeno [authentication domain](https://docs.cyberelements.io/bastion/4.6/lt/Usage/AdminConsoleReference/AuthenticationDomain/) kontekste: grupė priklauso lygiai vienam domenui.

Šio modulio veikimas priklauso nuo pasirinkto domeno tipo:

| Domeno tipas | Grupių valdymas |
|---|---|
| **Vietinis katalogas** | Pridėjimas ir naikinimas rankiniu būdu. |
| **SAML** (federaciniai domenai) | Pridėjimas ir naikinimas rankiniu būdu. Grupės identifikuojamos pagal **external id**, atitinkantį grupės identifikatorių tapatybės teikėjo pusėje. Galima masiškai importuoti iš CSV. |
| **LDAP** (standartinis režimas, sinchronizuojamos grupės) | Tik skaityti – grupės automatiškai gaunamos iš katalogo. Pridėjimo ir naikinimo mygtukai išjungti. |
| **LDAP su rankiniu grupių valdymu** | Pridėjimas ir naikinimas rankiniu būdu. Laukas **Description** paslėptas (aprašas gaunamas iš katalogo). |
| **Anoniminis katalogas** | Netaikoma – anoniminiai domenai nerodomi domeno parinkiklyje. |

---

## Domeno pasirinkimas ir naršymas

| Elementas | Aprašas |
|---|---|
| **Domain** (išplečiamasis sąrašas) | Filtruoja rodomas grupes pagal domeną. Pateikiami tik neanoniminiai domenai. Nuo pasirinkimo priklauso, kurie mygtukai įjungti ir ar matomas stulpelis **External id**. |
| **Ieškos laukas** | Filtruoja grupių sąrašą pagal pavadinimo poeilutę. Ieška paleidžiama praėjus 700 ms po paskutinio klavišo paspaudimo arba iš karto paspaudus klavišą `Enter`. Piktograma `×` išvalo lauką. |
| **Pagination** | 15, 25 arba 50 elementų puslapyje (numatytoji reikšmė: 15). |
| **Lentelės stulpeliai** | **Name** (su piktograma), **External id** (paslėptas, išskyrus federacinius domenus) ir **Description**. Kai nėra jokios grupės, lentelėje rodoma **No available groups**; kai nėra jokio domeno, išplečiamajame sąraše rodoma **No available domains**. |

---

## Vartotojų grupės pridėjimas

1. Išplečiamajame sąraše viršuje dešinėje pasirinkite tikslinį domeną.
2. Spustelėkite mygtuką **+**.
3. Užpildykite laukus ir patvirtinkite.

### Formos laukai

| Laukas | Aprašas |
|---|---|
| **Name** | Grupės pavadinimas. Privalomas. Negali būti sudarytas tik iš tarpų. Simbolis `;` neleidžiamas. Unikalumas tikrinamas domene, neatsižvelgiant į raidžių dydį: dublikatas atmetamas ir rodomas pranešimas **The group already exists**. |
| **External id** | Rodoma tik federacijos domenams (SAML). Jame saugomas grupės identifikatorius tapatybės teikėjo pusėje; jis naudojamas autentifikuotam vartotojui susieti su tinkama Bastion grupe. Jei laukas paliekamas tuščias, kaip atsarginė naudojama lauko **Name** reikšmė. |
| **Description** | Laisvo teksto grupės aprašas. Simbolis `;` neleidžiamas. Paslėptas LDAP domenuose, veikiančiuose rankinio valdymo režimu. |

> **CSV importas – tik federaciniai domenai**
>
> SAML domenuose mygtukas **Import** leidžia masiškai pridėti grupes iš CSV failo. Laukiami stulpeliai:
>
> - `External id`
> - `Name`
> - `Description`

---

## Vartotojų grupės redagavimas

⛔ **Esamos grupės redaguoti negalima**, nepriklausomai nuo domeno tipo. Įrankių juostoje yra tik trys veiksmai – **Add**, **Delete** ir **Import** –, nėra piktogramos **Properties**, o dukart spustelėjus lentelės eilutę nieko nevyksta.

Todėl norint pakeisti grupės pavadinimą, external id ar aprašą, ją reikia **panaikinti ir sukurti iš naujo**, atsižvelgiant į prieigos sutartis, kuriose ji nurodyta (žr. skyrių [Vartotojų grupės naikinimas](#delete-a-user-group)).

---

## Vartotojų grupės naikinimas

1. Sąraše pasirinkite vieną ar kelias grupes (palaikomas kelių elementų pasirinkimas).
2. Spustelėkite mygtuką **×**.
3. Patvirtinkite: konsolė klausia **Are you sure you want to delete this group?**, daugiskaita, kai pasirinktos kelios grupės.

### Ypatingi atvejai

> **Grupės, susietos su prieigos sutartimis „visiems“**
>
> Jei viena ar kelios pasirinktos grupės susietos su prieigos sutartimi, taikoma **visoms domeno grupėms** (sąlyga „visiems“), prieš faktinį naikinimą rodomas tarpinis langas **Group deletion**.
>
> - **Nepanaikinamos** grupės (blokuojamos griežtos priklausomybės) pateikiamos viršuje oranžine spalva.
> - Kiekvienai **galimai panaikinamai** grupei stulpelyje **Action** pasirinkite:
>     - **Delete**, kad patvirtintumėte naikinimą,
>     - **Do not delete**, kad paliktumėte grupę (numatytoji reikšmė).
> - Patvirtinkite, kad būtų pritaikyti pasirinkimai.

### Naikinimo ataskaita

Jei kai kurių grupių panaikinti nepavyksta (serverio pusės apribojimai, neaptikti kliento pusėje), ataskaitos lange pateikiamos susijusios grupės su atitinkamu klaidos pranešimu.
