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

# User groups

Il-kontijiet tal-utenti huma organizzati fi gruppi loġiċi, li jissimplifikaw l-assenjazzjoni tad-drittijiet tal-aċċess għall-applikazzjonijiet permezz tal-kuntratti ta’ aċċess. Il-gruppi dejjem jiġu ġestiti fil-kuntest ta’ [authentication domain](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AuthenticationDomain/): grupp jappartjeni għal dominju wieħed biss.

L-imġiba ta’ dan il-modulu tiddependi mit-tip tad-dominju magħżul:

| Tip ta’ dominju | Ġestjoni tal-gruppi |
|---|---|
| **Local directory** | Żieda u tħassir manwali. |
| **SAML** (dominji ta’ federazzjoni) | Żieda u tħassir manwali. Il-gruppi huma identifikati permezz ta’ **external id** li jikkorrispondi mal-identifikatur tal-grupp fuq il-fornitur tal-identità. L-importazzjoni bl-ingrossa minn CSV hija disponibbli. |
| **LDAP** (modalità standard, gruppi sinkronizzati) | Għall-qari biss — il-gruppi jinġabu awtomatikament mid-direttorju. Il-buttuni taż-żieda u tat-tħassir huma diżattivati. |
| **LDAP b’ġestjoni manwali tal-gruppi** | Żieda u tħassir manwali. Il-qasam **Description** huwa moħbi (id-deskrizzjoni ġejja mid-direttorju). |
| **Anonymous directory** | Mhux applikabbli — id-dominji anonimi ma jidhrux fis-selettur tad-dominju. |

---

## Għażla tad-dominju u navigazzjoni

| Element | Deskrizzjoni |
|---|---|
| **Domain** (lista drop-down) | Jiffiltra l-gruppi murija skont id-dominju. Jiġu elenkati biss id-dominji mhux anonimi. L-għażla tikkontrolla liema buttuni huma attivati u l-viżibbiltà tal-kolonna **External id**. |
| **Qasam tat-tfittxija** | Jiffiltra l-lista tal-gruppi skont parti mill-isem. It-tfittxija tibda 700 ms wara l-aħħar tagħfa fuq it-tastiera, jew minnufih bit-tasta `Enter`. Skattatur `×` ibattal il-qasam. |
| **Paġnazzjoni** | 15, 25 jew 50 entrata għal kull paġna (default: 15). |
| **Kolonni tal-grilja** | **Name** (b’ikona), **External id** (moħbija ħlief għad-dominji ta’ federazzjoni) u **Description**. Meta ma jkun hemm l-ebda grupp, il-grilja turi **No available groups**; meta ma jkun hemm l-ebda dominju, il-lista drop-down turi **No available domains**. |

---

## Żid grupp ta’ utenti

1. Agħżel id-dominju fil-mira fil-lista drop-down fin-naħa ta’ fuq tal-lemin.
2. Ikklikkja l-buttuna **+**.
3. Imla l-oqsma u kkonferma.

### Oqsma tal-formola

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | L-isem tal-grupp. Obbligatorju. Ma jistax ikun magħmul biss minn spazji. Il-karattru `;` mhuwiex aċċettat. L-unikità tiġi vverifikata fi ħdan id-dominju, irrispettivament mill-ittri kbar jew żgħar: duplikat jiġi rifjutat bil-messaġġ **The group already exists**. |
| **External id** | Jintwera biss għad-dominji tal-federazzjoni (SAML). Fih l-identifikatur tal-grupp fil-fornitur tal-identità; jintuża biex utent awtentikat jiġi mqabbel mal-grupp Bastion korrett. Jekk jitħalla vojt, il-valur tal-qasam **Name** jintuża bħala alternattiva. |
| **Description** | Deskrizzjoni b’test liberu tal-grupp. Il-karattru `;` mhuwiex aċċettat. Moħbi għad-dominji LDAP fil-modalità ta’ ġestjoni manwali. |

> **Importazzjoni CSV — għad-dominji ta’ federazzjoni biss**
>
> Għad-dominji SAML, buttuna **Import** tħallik iżżid gruppi bl-ingrossa minn fajl CSV. Il-kolonni mistennija huma:
>
> - `External id`
> - `Name`
> - `Description`

---

## Editja grupp ta’ utenti

⛔ **Grupp eżistenti ma jistax jiġi editjat**, ikun x’ikun it-tip ta’ dominju. L-istrixxa tal-għodod fiha tliet azzjonijiet biss — **Add**, **Delete** u **Import** — mingħajr l-ikona **Properties**, u klikk doppju fuq ringiela tal-grilja ma jagħmel xejn.

Għalhekk, biex tibdel l-isem, l-external id jew id-deskrizzjoni ta’ grupp, trid **tħassru u toħolqu mill-ġdid**, filwaqt li tqis il-kuntratti ta’ aċċess li jirreferu għalih (ara l-kapitolu [Ħassar grupp ta’ utenti](#delete-a-user-group)).

---

## Ħassar grupp ta’ utenti

1. Agħżel grupp wieħed jew aktar fil-lista (l-għażla multipla hija appoġġata).
2. Ikklikkja l-buttuna **×**.
3. Ikkonferma: il-konsol jistaqsi **Are you sure you want to delete this group?**, fil-plural meta jkunu magħżula diversi gruppi.

### Każijiet speċifiċi

> **Gruppi marbuta ma’ kuntratti ta’ aċċess « kulħadd »**
>
> Jekk grupp magħżul wieħed jew aktar ikunu marbuta ma’ kuntratt ta’ aċċess li jimmira lejn **il-gruppi kollha tad-dominju** (klawżola « kulħadd »), tintwera tieqa intermedja **Group deletion** qabel it-tħassir effettiv.
>
> - Il-gruppi **li ma jistgħux jitħassru** (imblukkati minn dipendenza stretta) jiġu elenkati fin-naħa ta’ fuq bl-oranġjo.
> - Għal kull grupp **li potenzjalment jista’ jitħassar**, agħżel fil-kolonna **Action**:
>     - **Delete** biex tikkonferma t-tħassir,
>     - **Do not delete** biex iżżomm il-grupp (valur default).
> - Ikkonferma biex tapplika l-għażliet.

### Rapport tat-tħassir

Jekk it-tħassir ifalli għal xi gruppi (restrizzjonijiet min-naħa tas-server li ma nqabdux min-naħa tal-klijent), tieqa ta’ rapport telenka l-gruppi affettwati bil-messaġġ ta’ żball assoċjat.
