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

# Access conditions

Il-modulu **Access conditions** jiddefinixxi regoli li, ladarba jkunu marbuta ma’ [access contract](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AccessContracts/), **jippermettu** jew **jiċħdu** lill-utenti l-konnessjoni mal-portal tal-utent abbażi ta’ kriterju tekniku (indirizz IP, firxa ta’ ħin, browser, sistema operattiva, ċertifikat, attribut tal-profil tal-utent, eċċ.).

Kundizzjoni tiġi evalwata fil-mument tal-konnessjoni: jekk tkun **valida**, tiġi applikata l-azzjoni assoċjata (ippermetti jew iċħad).

---

## Lista tal-kundizzjonijiet

Il-grilja turi l-kundizzjonijiet eżistenti kollha, f’paġni ta’ 15, 25 jew 50 entrata.

| Kolonna | Deskrizzjoni |
|---|---|
| **Name** | L-isem muri tal-kundizzjoni, preċedut minn ikona li turi t-tip u d-deċiżjoni (ippermetti jew iċħad). |
| **Type** | It-tip tal-kundizzjoni (ara t-tabella hawn taħt). |
| **Condition** | Sommarju testwali tal-parametri kkonfigurati (firxiet ta’ IP, dati, browsers, eċċ.). |

Il-qasam tat-tfittxija fil-quċċata tal-lemin jiffiltra l-lista skont l-isem.

---

## Żieda ta’ kundizzjoni

Meta tikklikkja l-buttuna **+**, tinfetaħ il-formola tal-ħolqien. Oqsma komuni għat-tipi kollha:

| Qasam | Deskrizzjoni |
|---|---|
| **Condition type** | Obbligatorju. Jiddefinixxi n-natura tar-regola (ara t-tabella hawn taħt). Ma jistax jinbidel wara l-ewwel salvataġġ. |
| **Name** | Obbligatorju. |
| **Description** | Test liberu. |
| **Access** | Żewġ għażliet: **Allow if valid** (default) jew **Deny if valid**. |
| **Notify the user if invalid** | Jekk immarkat, l-utent jara messaġġ meta l-kundizzjoni tiċħad l-aċċess. |
| **Log if invalid** | Jekk immarkat, tinkiteb entrata fir-reġistru meta jkun hemm ċaħda. |

### Tipi disponibbli

| Tip | Verifika li ssir | Klijent meħtieġ |
|---|---|---|
| **Connection address** | URL tal-komponent Mediation Controller użat mill-klijent. | Le |
| **Antispyware** | Preżenza ta’ antispyware attiv fuq l-istazzjon tax-xogħol. | **Iva** |
| **Antivirus** | Preżenza ta’ antivirus attiv fuq l-istazzjon tax-xogħol. | **Iva** |
| **Windows Security Center** | L-istat tas-settings tas-sigurtà ta’ Windows (aġġornament awtomatiku, settings ta’ Internet Explorer, UAC). | **Iva** |
| **Certificate** | Ċertifikat ippreżentat mill-browser biex jawtentika ruħu mal-interfaċċa web. | Le |
| **Date** | Firxa ta’ dati, perjodu ta’ ħin, lista ta’ xhur, jiem tal-ġimgħa. | Le |
| **IP** | Indirizz IP / tad-dominju, firxa ta’ IP jew sottonetwerk. | Le |
| **MD5** | Preżenza ta’ fajl f’mogħdija partikolari b’checksum MD5 mistenni. | **Iva** |
| **Meta-rule** | Kombinazzjoni loġika (AND / OR) ta’ mill-inqas żewġ kundizzjonijiet eżistenti oħra. | Jiddependi mill-kundizzjonijiet ikkombinati |
| **Browser** | Il-browser użat mill-klijent. | Le |
| **Operating system** | Is-sistema operattiva misjuba fuq l-istazzjon tax-xogħol. | **Iva**, sakemm **Use the User-Agent** ma jkunx immarkat |
| **Firewall** | Preżenza ta’ firewall attiv. | **Iva** |
| **System** | Verifika lokali (fajl, numru tal-volum, numru tas-serje tad-diska, proċess li qed jaħdem, ċavetta tar-reġistru). | **Iva** |
| **User** | Preżenza / valur ta’ attribut tal-profil tal-utent. | Le |
| **FIDO2** | Awtentikazzjoni tal-utent permezz ta’ ċavetta FIDO2 / WebAuthn. | Le |

> **Il-kolonna « Klijent meħtieġ »**
>
> Xi kontrolli jikkonċernaw l-istat tal-istazzjon tax-xogħol: jitwettqu lokalment u għalhekk jeħtieġu li l-**klijent Bastion** ikun installat fuq l-istazzjon tax-xogħol tal-utent. Meta l-klijent ma jkunx preżenti, kundizzjoni li teħtieġu ma tistax tiġi evalwata u tiġi ttrattata bħala **invalida** — li huwa l-każ b’mod partikolari għall-konnessjonijiet magħmula minn Cleanroom Desktop.

### Parametri skont it-tip

**Connection address**

> | Qasam | Deskrizzjoni |
> |---|---|
> | **Domain** | Il-parti tal-ospitant tal-URL tal-komponent Mediation Controller (mingħajr `https://` jew mogħdija). Taċċetta ittri, ċifri, lineetti, il-punt u l-karattri tal-espressjonijiet regolari. |

**Certificate**

> Huma offruti żewġ modalitajiet:
>
> | Modalità | Deskrizzjoni |
> |---|---|
> | **User authenticated using a certificate** *(default)* | Jivverifika li l-utent awtentika ruħu permezz ta’ ċertifikat. |
> | **Test certificate's contents** | Barra minn hekk, iqabbel qasam taċ-ċertifikat ma’ qasam tal-profil tal-utent. |
>
> Oqsma addizzjonali għat-tieni modalità:
>
> | Qasam | Deskrizzjoni |
> |---|---|
> | **Certificate field** | Lista li tinżel: **DN field of the user certificate**, **CN field of the user certificate** *(default)*, **Email field of the user certificate**, **O field of the user certificate**, **OR field of the user certificate** jew **PEM-encoded certificate for client X509**. |
> | **User profile field** | Il-qasam tal-profil tal-utent li l-valur tiegħu jitqabbel. |

**Date**

> Mill-inqas waħda mill-erba’ għażliet trid tkun immarkata; l-għażliet attivi jiġu kkombinati permezz ta’ AND loġiku.
>
> | Għażla | Deskrizzjoni |
> |---|---|
> | **Date** | Firxa ta’ dati (bidu, tmiem). Id-data tat-tmiem ma tistax tkun qabel id-data tal-bidu. |
> | **Hour** | Perjodu ta’ ħin (HH:MM). Il-ħin tat-tmiem irid ikun wara l-ħin tal-bidu (sakemm il-kundizzjoni ma tkoprix diversi jiem). |
> | **Month** | Tnax-il kaxxa ta’ selezzjoni, kollha immarkati b’mod default. |
> | **Day of the week** | Seba’ kaxxi ta’ selezzjoni, kollha immarkati b’mod default. |

**IP**

> Tliet modalitajiet li jeskludu lil xulxin:
>
> | Modalità | Oqsma |
> |---|---|
> | **IP or domain list** | Indirizz IPv4 wieħed jew aktar, separati bil-karattru `;`. |
> | **IP range** | L-IP tal-bidu u l-IP tat-tmiem. |
> | **Subnetwork** | IP u maskra (CIDR minn 0 sa 32). |

**MD5**

> | Qasam | Deskrizzjoni |
> |---|---|
> | **File path** | Mogħdija sħiħa (eż. `C:\Test.ext`). |
> | **MD5 checksum** | Numru eżadeċimali ta’ 32 karattru. |
>
> Link jagħti l-possibbiltà li titniżżel l-utilità tal-checksum MD5 għal Windows ipprovduta minn Bastion.

**Meta-rule**

> | Qasam | Deskrizzjoni |
> |---|---|
> | **Logical operator** | **AND** *(default)* jew **OR**. |
> | **Component rules** | Iġbed u poġġi mill-inqas żewġ kundizzjonijiet mill-kolonna tax-xellug għall-kolonna tal-lemin. Meta-regola ma tistax tirreferi għaliha nnifisha jew għal meta-regola li diġà tintuża fil-ġerarkija tagħha stess. |

**Browser**

> Kaxxi ta’ selezzjoni li jikkorrispondu għall-browsers li għandhom jinstabu: Internet Explorer minn 7 sa 11, Konqueror, Firefox, Safari, Chrome, Opera, Edge. L-għażla **Other** tattiva qasam ta’ test liberu għall-isem eżatt ta’ browser ieħor. B’mod default, **Internet Explorer** ikun immarkat.
>
> > **Iżolar tal-konnessjonijiet magħmula minn Cleanroom Desktop**
> >
> > Il-pjattaforma tara lil Cleanroom Desktop bħala browser: jidentifika ruħu b’user-agent tal-forma `Cleanroom Desktop 1.2.3.4`. Għalhekk, jekk tagħżel **Other** u tdaħħal `Cleanroom Desktop`, timmira l-aċċessi magħmula minn dak il-klijent. Meta tkun marbuta ma’ access contract, il-kundizzjoni tagħtik il-possibbiltà li tirriżerva xi riżorsi għall-klijent Desktop u oħrajn għall-portal tal-utent.

**Operating system**

> | Għażla | Deskrizzjoni |
> |---|---|
> | **Use the User-Agent** | Jekk immarkat, is-sejba tistrieħ fuq l-intestatura `User-Agent` minflok fuq l-aġent lokali. |
> | **OS list** | Kaxxi ta’ selezzjoni (Windows minn XP sa 11, Windows Server minn 2003 sa 2022, Linux, MacOS X, Vista, 9x, NT, CE, eċċ.). L-għażla **Other** tattiva qasam ta’ test liberu. Mill-inqas kaxxa waħda trid tkun immarkata. |

**System**

> Verifika lokali, f’waħda mill-modalitajiet li ġejjin:
>
> | Modalità | Deskrizzjoni | Validazzjoni tal-lista |
> |---|---|---|
> | **File** | Lista ta’ mogħdijiet ta’ fajls li għandhom jiġu vverifikati. | **Kollha** jridu jkunu preżenti (AND). |
> | **C:\ volume number** | Lista ta’ numri tal-volum (utilità li titniżżel tgħin biex jinkisbu). | **Wieħed biss** irid jaqbel (OR). |
> | **Hard disk serial number** | Lista ta’ numri tas-serje. | **Wieħed biss** irid jaqbel (OR). |
> | **Running process** | Lista ta’ ismijiet ta’ proċessi. | **Kollha** jridu jkunu qed jaħdmu (AND). |
> | **Registry Key** | Lista ta’ ċwievet / valuri fil-forma `HKEY_LOCAL_MACHINE\path\name=value`. | **Kollha** jridu jeżistu, bil-valur speċifikat fejn applikabbli (AND). |
>
> Għal kull modalità, daħħal il-valur u kklikkja **Add** biex iżżidu mat-tabella. Kull ringiela tista’ titħassar individwalment (b’konferma).
>
> > **Il-loġika tvarja minn modalità għal oħra**
> >
> > Iż-żewġ modalitajiet tal-hardware — **C:\ volume number** u **Hard disk serial number** — huma sodisfatti hekk kif valur **wieħed biss** fil-lista jaqbel: hawnhekk, il-lista telenka l-istazzjonijiet tax-xogħol awtorizzati. It-tliet modalitajiet l-oħra jeħtieġu li **kull** valur jiġi vverifikat.

**User**

> | Qasam | Deskrizzjoni |
> |---|---|
> | **Attribute name** | L-attribut tal-profil tal-utent li għandu jiġi ttestjat (eż. `mail`, `employeeID`, `mobile`). |
> | **Attribute value** | Fakultattiv. Espressjoni mqabbla mal-valur rritornat. Jekk jitħalla vojt, il-kundizzjoni tivverifika biss li l-attribut fih valur. |
> | **Exclusive comparison** | Jekk immarkat, l-espressjoni trid taqbel mill-**bidu** tal-valur; inkella tista’ taqbel fi kwalunkwe post fil-valur. |
>
> > **Tipi ta’ dominju appoġġjati**
> >
> > Din il-kundizzjoni mhix limitata għad-direttorji: l-attributi jinqraw mid-direttorju għal dominju **LDAP** u mid-database għal dominju **local**. Għal tipi oħra ta’ dominju — **SAML** b’mod partikolari — ma jiġi rritornat l-ebda attribut, għalhekk hemmhekk il-kundizzjoni **qatt ma tkun valida**, u dan għandu konsegwenzi differenti skont jekk hijiex issettjata għal *Allow* jew għal *Deny*.

---

## Editjar ta’ kundizzjoni

Agħżel il-kundizzjoni fil-lista u kklikkja l-ikona **Properties**, jew agħfas darbtejn fuq ir-ringiela. Jintwerew l-istess oqsma bħal fil-ħolqien, ħlief **Type**, li jsir biss għall-qari.

---

## Tħassir ta’ kundizzjoni

Agħżel kundizzjoni waħda jew aktar u kklikkja l-buttuna **×**. It-tħassir jitlob konferma. L-għażla multipla hija appoġġjata.
