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

# Access contracts

Il-modulu **Access contracts** jiġbor ir-regoli li jagħtu lill-gruppi tal-utenti d-dritt li jaslu għall-applikazzjonijiet ippubblikati. Kuntratt iwieġeb għal erba’ mistoqsijiet operazzjonali: **min** (liema gruppi), **xiex** (liema applikazzjonijiet u b’liema restrizzjonijiet), **fejn** (fuq liema sit) u **taħt liema kundizzjonijiet** (kundizzjonijiet ta’ aċċess, allarmi, filtrazzjoni tan-netwerk).

Il-gruppi tal-utenti, l-applikazzjonijiet u l-kundizzjonijiet ta’ aċċess iridu jeżistu qabel ma jkunu jistgħu jiġu referenzjati f’kuntratt.

> **Drittijiet kumulattivi**
>
> Grupp jista’ jidher f’diversi kuntratti u utent jista’ jappartjeni għal diversi gruppi. Fiż-żewġ każijiet, id-drittijiet jingħaddu flimkien. Bil-maqlub, meta kuntratt jimmira diversi gruppi, l-appartenenza għal kwalunkwe wieħed minnhom hija biżżejjed biex tibbenefika mid-drittijiet tiegħu.

---

## Lista tal-kuntratti

Il-grilja ewlenija telenka l-kuntratti eżistenti. Kull ringiela tista’ tiġi estiża jew magħluqa biex turi d-dettalji (dominji/gruppi, kundizzjonijiet, siti, kategoriji u applikazzjonijiet, applikazzjonijiet ristretti, allarmi, iffiltrar tan-netwerk, aliases li jistgħu jiġu żvelati).

| Kolonna | Deskrizzjoni |
|---|---|
| **Name** | Isem il-kuntratt, preċedut minn ikona ta’ katnazz. |
| **Groups** | Numru ta’ gruppi tal-utenti assoċjati. |
| **Access conditions** | Numru ta’ kundizzjonijiet ta’ aċċess assoċjati. |
| **Sites** | Numru ta’ siti referenzjati. |
| **Applications** | Numru ta’ applikazzjonijiet awtorizzati. |
| **Restricted applications** | Numru ta’ applikazzjonijiet imqiegħda wara fluss tax-xogħol. |
| **Alerts** | Numru ta’ allarmi ta’ aċċess marbuta mal-kuntratt. |
| **Network connections** | Numru ta’ regoli tal-iffiltrar tan-netwerk (kolonna moħbija b’mod default). |
| **Revealable aliases** | Numru ta’ aliases assoċjati li jistgħu jiġu żvelati (muri biss meta l-funzjonalità tkun attivata). |

Il-qasam tat-tfittxija fil-kantuniera ta’ fuq tal-lemin jiffiltra l-lista skont l-isem.

---

## Żieda ta’ kuntratt

Ikklikkja l-buttuna **+** biex tiftaħ l-assistent tal-ħolqien. L-oqsma tal-intestatura huma komuni għat-tabs kollha:

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Obbligatorju. Jidentifika l-kuntratt. |
| **Description** | Test liberu. |

Il-formola hija maqsuma f’diversi tabs li għandhom jimtlew fl-ordni loġika.

**Groups**

> Agħżel id-dominju tal-awtentikazzjoni mil-lista li tinżel, imbagħad iġbed u poġġi l-gruppi tal-utenti mixtieqa fil-kolonna tal-lemin. Kuntratt wieħed jista’ jgħaqqad gruppi minn diversi dominji. Mill-inqas grupp wieħed irid ikun magħżul biex il-kuntratt ikun validu.

**Access conditions**

> Iġbed u poġġi l-kundizzjonijiet ta’ aċċess li għandhom jiġu applikati. Kundizzjoni tippermetti jew tiċħad l-aċċess abbażi ta’ kriterju (IP, data, ċertifikat, eċċ. — ara [Access conditions](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AccessConditions/)).
>
> > **Diversi kundizzjonijiet jiġu kkombinati permezz ta’ AND**
> >
> > Meta diversi kundizzjonijiet ta’ aċċess ikunu marbuta mal-istess kuntratt, **kollha** jridu jkunu validi biex il-kuntratt japplika: kundizzjoni invalida waħda hija biżżejjed biex twarrbu, u l-utent ma jiksibx id-drittijiet li jagħti. Biex tikseb OR, uża **meta-regola** fil-modulu [Access conditions](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AccessConditions/).
>
> > **Viżibbiltà tat-tab**
> >
> > It-tab tidher biss meta teżisti mill-inqas kundizzjoni ta’ aċċess waħda fil-modulu dedikat.

**Sites**

> Iġbed u poġġi s-sit jew is-siti li jospitaw l-applikazzjonijiet. Sit huwa sett ta’ komponenti Edge Gateway li jiddefinixxi punt ta’ dħul sikur għal netwerk lokali.
>
> > **Diversi siti: l-utent jagħżel**
> >
> > Meta l-kuntratt jirreferi għal diversi siti, l-utent jara l-iskrin **Select a site** meta jniedi l-applikazzjoni, biex jagħżel minn liema wieħed jgħaddi.

**Applications**

> Is-siġra telenka l-applikazzjonijiet miġbura skont il-kategorija. Jekk timmarka kategorija, jintgħażlu l-applikazzjonijiet kollha tagħha u tiġi inkluża awtomatikament kull applikazzjoni li tiżdied aktar tard ma’ dik il-kategorija. Jekk timmarka kaxxi individwali, tista’ tagħżel sottosett. Mill-inqas applikazzjoni waħda trid tkun immarkata.
>
> > **Applikazzjonijiet Workplace — esklużività**
> >
> > Meta l-assoċjazzjoni Workplace tkun attivata, jidhru żewġ applikazzjonijiet virtwali: **Access to Workplace applications by merged cloud** u **Access to Workplace applications by redirection**. Dawn jeskludu lil xulxin fl-istess kuntratt.

**Applications to restrict**

> Iqiegħed xi wħud mill-applikazzjonijiet magħżula qabel wara fluss tax-xogħol ta’ approvazzjoni. L-utenti jkollhom jitolbu l-aċċess, u amministratur jaċċetta jew jirrifjuta t-talbiet mill-modulu [Workflow](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/Workflows/).
>
> | Għażla | Deskrizzjoni |
> |---|---|
> | **Ask the user to complete a form when requesting access** | Jekk immarkat, l-utent irid jimla formola kull darba li jitlob aċċess għal applikazzjoni ristretta. |
> | **Applications to restrict** | Lista b’żewġ kolonni (disponibbli / ristretti) b’tfittxija. |

**Personal aliases**

> Magħluqa b’mod default. Meta **Allow personal aliases** ikun immarkat, tista’ tindika, fost l-applikazzjonijiet magħżula, dawk li għalihom l-utent jista’ jissejvja l-aliases tiegħu stess (kredenzjali maħżuna fil-portal).

**Revealable aliases**

> Viżibbli biss meta l-għażla **Allow password display in alias** tkun immarkata fil-modulu [general options](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/GeneralOptions/). Lista b’żewġ kolonni biex tagħżel l-aliases (marbuta mal-utenti) li jistgħu jiġu żvelati permezz ta’ dan il-kuntratt.
>
> > **Meta-aliases**
> >
> > Meta l-għażla jkun fiha mill-inqas meta-alias wieħed, tintwera kaxxa ta’ djalogu ta’ konferma qabel is-salvataġġ.

**Alerts**

> Iġbed u poġġi l-profili tal-allarm li għandhom jiġu skattati meta jintużaw l-aċċessi koperti minn dan il-kuntratt.

**Network connections**

> It-tab tkun attiva biss meta mill-inqas applikazzjoni RDS, HTML5 RDS, SSH jew HTML5 SSH waħda tkun magħżula fit-tab **Applications**.
>
> > **Huwa meħtieġ aġent fuq is-server fil-mira, ikun x’ikun il-protokoll**
> >
> > Il-filtrazzjoni jkollha effett biss jekk is-server fil-mira jkollu l-aġent korrispondenti: l-**aġent Bastion** fuq is-servers RDS u HTML5 RDS, u l-**aġent tal-filtrazzjoni tan-netwerk** fuq is-servers SSH u HTML5 SSH. Mingħajru, ir-regoli mdaħħla hawn ma għandhom l-ebda effett.
>
> Immarka **Filter network connections** biex tattiva l-iffiltrar, imbagħad ipprovdi għal kull regola:
>
> | Qasam | Deskrizzjoni |
> |---|---|
> | **Target IP** | Indirizz IP jew ospitant awtorizzat. Validazzjoni tal-format IPv4. |
> | **Network mask** | Fakultattiva. Meta tkun vojta, ir-regola tapplika biss għall-IP fil-mira. |
> | **Port** | 0 b’mod default: ir-regola tapplika għall-portijiet kollha. |
> | **Protocol** | TCP, UDP jew TCP and UDP. |
>
> Ikklikkja **Add** biex iddaħħal ir-regola fil-lista tan-netwerks awtorizzati. Kull regola tista’ titneħħa individwalment.
>
> > **Semantika tal-iffiltrar**
> >
> > Jekk **Filter network connections** ikun immarkat iżda l-ebda netwerk ma jkun awtorizzat, l-utent ma jista’ jikkonnettja ma’ l-ebda netwerk. Inkella, jistgħu jintlaħqu biss in-netwerks elenkati.

Ikklikkja **Validate** biex tissejvja l-kuntratt. It-tabs **Groups**, **Sites** u **Applications** huma kollha obbligatorji, inkella l-kuntratt jiġi rrifjutat.

---

## Editjar ta’ kuntratt

Agħżel il-kuntratt fil-lista, imbagħad ikklikkja l-ikona **Properties**, jew agħfas darbtejn fuq ir-ringiela. It-tieqa hija identika għal dik tal-ħolqien, mimlija minn qabel bil-valuri attwali.

---

## Tħassir ta’ kuntratt

Agħżel kuntratt wieħed jew aktar, imbagħad ikklikkja l-buttuna **×**. It-tħassir jeħtieġ konferma.

---

## Esportazzjoni tal-kuntratti

Il-buttuna **Export** tniżżel il-kuntratti kollha murija f’fajl CSV. Id-dejta esportata tirrifletti l-filtri attwali (tfittxija, eċċ.).

### Struttura tal-fajl

Il-fajl fih ringiela tal-intestatura waħda, imbagħad ringiela għal kull kuntratt. Il-kolonni jidhru f’din l-ordni:

| # | Kolonna | Kontenut | Obbligatorja fl-importazzjoni |
|---|---|---|---|
| 1 | **Alerts** | Ismijiet tal-profili tal-allarm. |  |
| 2 | **Categories** | Ismijiet tal-kategoriji tal-applikazzjonijiet. |  |
| 3 | **Description** | Test liberu. |  |
| 4 | **Groups** | Gruppi tal-utenti, fil-forma `group@domain`. | **Iva** |
| 5 | **Name** | Isem il-kuntratt. | **Iva** |
| 6 | **Applications** | Ismijiet tal-applikazzjonijiet awtorizzati. |  |
| 7 | **Restricted applications** | Ismijiet tal-applikazzjonijiet imqiegħda wara fluss tax-xogħol. |  |
| 8 | **Access conditions** | Ismijiet tal-kundizzjonijiet ta’ aċċess. |  |
| 9 | **Sites** | Ismijiet tas-siti. | **Iva** |
| 10 | **Request a form** | `True` jew `False`. |  |
| 11 | **Filter network connections** | `True` jew `False`. |  |
| 12 | **Network connections** | Regoli tal-iffiltrar, fil-forma `ip/mask:port:protocol`. |  |
| 13 | **Revealable aliases** | Ismijiet tal-aliases. |  |
| 14 | **Revealable password rotation aliases** | Ismijiet tal-aliases. |  |
| 15 | **Revealable dynamic aliases** | Ismijiet tal-aliases. |  |
| 16 | **Personal aliases** | Ismijiet tal-applikazzjonijiet li għalihom huma ppermessi l-aliases personali. |  |

### Sintassi

| Element | Separatur | Eżempju |
|---|---|---|
| Kolonni | `;` | `Name;Description;…` |
| Valuri multipli fl-istess ċellula | `+` | `Accounting+Management+Support` |
| Grupp tal-utenti | `@` bejn il-grupp u d-dominju tiegħu | `Accounting@AD-Internal` |
| Il-gruppi kollha ta’ dominju | Il-kelma ewlenija `all` | `all@AD-Internal` |
| Regola tal-iffiltrar tan-netwerk | `/` imbagħad `:` | `10.0.0.5/255.255.255.0:3389:TCP` — port issettjat għal `0` ifisser “kull port” |
| Booleani | — | `True` jew `False`; ċellula vojta titqies bħala `False` |

> **Volum**
>
> L-esportazzjoni hija limitata: lil hinn minn numru massimu ta’ ringieli stabbilit fuq il-pjattaforma, jinkitbu fil-fajl biss l-ewwel kuntratti.

---

## Importazzjoni tal-kuntratti

Il-buttuna **Import** tiftaħ tieqa fejn jista’ jittella’ fajl CSV. L-istruttura tiegħu trid tkun dik deskritta fil-kapitolu [Esportazzjoni tal-kuntratti](#export-contracts): l-aktar triq sigura hija li tibda minn esportazzjoni u teditjaha.

| Qasam | Deskrizzjoni |
|---|---|
| **File** | Fajl CSV li għandu jiġi importat. |
| **Record delimiter** | Is-separatur tal-kolonni, `;` għal fajl prodott mill-esportazzjoni. |
| **Value delimiter inside a field** | Is-separatur għall-valuri multipli, `+` għal fajl prodott mill-esportazzjoni. |

Il-kolonni **Name**, **Groups** u **Sites** huma obbligatorji: ringiela li jkun nieqes minnha wieħed minnhom tiġi rrifjutata. Il-valuri referenzjati (applikazzjonijiet, kategoriji, kundizzjonijiet ta’ aċċess, allarmi, aliases, siti) iridu **diġà jeżistu** u jitqabblu skont l-isem.

Wara l-validazzjoni, tieqa tagħti sommarju tar-riżultat tal-importazzjoni għal kull kuntratt fil-fajl.
