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

# User groups

Kasutajakontod on korraldatud loogilistesse rühmadesse, mis lihtsustavad rakenduste juurdepääsuõiguste määramist juurdepääsulepingute kaudu. Rühmi hallatakse alati [authentication domain](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AuthenticationDomain/) domeeni kontekstis: rühm kuulub täpselt ühte domeeni.

Selle mooduli käitumine oleneb valitud domeeni tüübist:

| Domeeni tüüp | Rühmade haldus |
|---|---|
| **Local directory** | Käsitsi lisamine ja kustutamine. |
| **SAML** (föderatsioonidomeenid) | Käsitsi lisamine ja kustutamine. Rühmad tuvastatakse **external id** järgi, mis vastab rühma identifikaatorile identiteedipakkuja juures. Saadaval on hulgiimport CSV-failist. |
| **LDAP** (standardrežiim, sünkroonitud rühmad) | Kirjutuskaitstud — rühmad tuuakse automaatselt kataloogist. Lisamis- ja kustutamisnupud on välja lülitatud. |
| **LDAP käsitsi rühmahaldusega** | Käsitsi lisamine ja kustutamine. Väli **Description** on peidetud (kirjeldus pärineb kataloogist). |
| **Anonymous directory** | Ei kohaldu — anonüümseid domeene domeenivalijas ei kuvata. |

---

## Domeeni valimine ja navigeerimine

| Element | Kirjeldus |
|---|---|
| **Domain** (ripploend) | Filtreerib kuvatavaid rühmi domeeni järgi. Loetletakse ainult mitteanonüümsed domeenid. Valikust olenevad sisse lülitatud nupud ja veeru **External id** nähtavus. |
| **Otsinguväli** | Filtreerib rühmade loendit nime alamstringi järgi. Otsing käivitub 700 ms pärast viimast klahvivajutust või kohe klahviga `Enter`. Päästik `×` tühjendab välja. |
| **Lehekülgedeks jaotamine** | 15, 25 või 50 kirjet lehekülje kohta (vaikimisi: 15). |
| **Tabeli veerud** | **Name** (ikooniga), **External id** (peidetud, välja arvatud föderatsioonidomeenide puhul) ja **Description**. Kui rühmi pole, kuvatakse tabelis **No available groups**; kui domeene pole, kuvatakse ripploendis **No available domains**. |

---

## Kasutajarühma lisamine

1. Valige paremas ülanurgas olevast ripploendist sihtdomeen.
2. Klõpsake nuppu **+**.
3. Täitke väljad ja kinnitage.

### Vormi väljad

| Väli | Kirjeldus |
|---|---|
| **Name** | Rühma nimi. Kohustuslik. Ei tohi koosneda ainult tühikutest. Märk `;` pole lubatud. Kordumatust kontrollitakse domeeni piires, suur- ja väiketähti eristamata: duplikaat lükatakse tagasi teatega **The group already exists**. |
| **External id** | Kuvatakse ainult föderatsioonidomeenide (SAML) korral. Sisaldab rühma identifikaatorit identiteedipakkuja juures; seda kasutatakse autenditud kasutaja vastendamiseks õige Bastion rühmaga. Kui see jäetakse tühjaks, kasutatakse varuvariandina välja **Name** väärtust. |
| **Description** | Rühma vabatekstiline kirjeldus. Märk `;` pole lubatud. Käsitsihaldusrežiimis LDAP-domeenide puhul peidetud. |

> **CSV-import — ainult föderatsioonidomeenid**
>
> SAML-domeenide puhul võimaldab nupp **Import** lisada rühmi hulgi CSV-failist. Oodatavad veerud on järgmised:
>
> - `External id`
> - `Name`
> - `Description`

---

## Kasutajarühma muutmine

⛔ **Olemasolevat rühma ei saa muuta**, olenemata domeeni tüübist. Tööriistaribal on ainult kolm toimingut — **Add**, **Delete** ja **Import** — ikooni **Properties** pole ning tabeli rea topeltklõpsamine ei tee midagi.

Rühma nime, välise ID või kirjelduse muutmine tähendab seega rühma **kustutamist ja uuesti loomist**, arvestades sellele viitavaid juurdepääsulepinguid (vt peatükk [Kasutajarühma kustutamine](#delete-a-user-group)).

---

## Kasutajarühma kustutamine

1. Valige loendis üks või mitu rühma (mitmikvalik on toetatud).
2. Klõpsake nuppu **×**.
3. Kinnitage: konsool küsib **Are you sure you want to delete this group?**, mitmuses, kui valitud on mitu rühma.

### Erijuhud

> **„Kõigile“ kehtivate juurdepääsulepingutega seotud rühmad**
>
> Kui üks või mitu valitud rühma on seotud juurdepääsulepinguga, mis on suunatud **domeeni kõigile rühmadele** (klausel „kõigile“), kuvatakse enne tegelikku kustutamist vahepealne aken **Group deletion**.
>
> - **Mittekustutatavad** rühmad (mida blokeerib range sõltuvus) loetletakse ülaosas oranžilt.
> - Iga **potentsiaalselt kustutatava** rühma puhul valige veerus **Action**:
>     - **Delete**, et kustutamine kinnitada,
>     - **Do not delete**, et rühm alles jätta (vaikeväärtus).
> - Valikute rakendamiseks kinnitage.

### Kustutamise aruanne

Kui kustutamine mõne rühma puhul nurjub (serveripoolsed piirangud, mida kliendi poolel ei tuvastatud), loetleb aruandeaken mõjutatud rühmad koos vastava tõrketeatega.
