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

# Authentication domain

**Dominju ta’ awtentikazzjoni** jiddefinixxi *fejn* u *kif* jiġu vverifikati l-identitajiet tal-utenti fil-mument tal-konnessjoni. Kull kont jappartjeni għal grupp, u kull grupp għal dominju: id-dominju huwa dak li jiddetermina minn fejn ġejjin il-kontijiet — direttorju korporattiv, bażi interna, jew fornitur tal-identità estern.

Dan il-modulu jelenka d-dominji ddikjarati. Ikklikkja `+` biex iżżid wieħed, jew ikklikkja darbtejn fuq isem biex tikkonfigurah. **It-tip ta’ direttorju jintgħażel fil-mument tal-ħolqien u ma jistax jinbidel wara.**

Huma offruti erba’ tipi:

| Tip ta’ direttorju | Sors tal-kontijiet | Użu |
|---|---|---|
| **LDAP directory** | Direttorju estern (Active Directory, OpenLDAP…) | Il-każ komuni: il-kontijiet u l-gruppi eżistenti jerġgħu jintużaw kif inhuma, mingħajr ma jiġu kkupjati. |
| **Local directory** | Bażi interna tal-pjattaforma | Kontijiet maħluqa u ġestiti direttament mill-konsol, flimkien ma’ direttorju jew għal ambitu żgħir. |
| **SAML domain** | Fornitur tal-identità estern (IdP) | L-awtentikazzjoni hija ddelegata lill-IdP; il-pjattaforma taġixxi bħala l-fornitur tas-servizz. |
| **Anonymous directory** | Xejn | Każijiet rari fejn l-aċċess għal applikazzjoni ma jeħtieġ l-ebda awtentikazzjoni. |

> **Ordni tal-ħolqien**
>
> Oħloq l-ewwel id-**dominju**, imbagħad il-**gruppi**, imbagħad il-**kontijiet tal-utenti**: id-drittijiet ta’ aċċess għall-applikazzjonijiet imbagħad jingħataw lill-gruppi, permezz ta’ kuntratt ta’ aċċess.

---

## Elementi komuni tal-konfigurazzjoni

Dawn is-settings huma preżenti għal kull tip ta’ dominju:

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Agħżel isem tad-dominju li jkun jagħmel sens. |
| **Shortcut URL** | Jintwera biss fil-modalità tal-editjar. URL dirett li jagħti aċċess għall-portal tal-utent għal dan id-dominju speċifiku, mingħajr ma tgħaddi mil-lista tad-dominji disponibbli. Format: `https://{server}/cloud/?orgname={organisation}&domainid={id}`. |
| **Description** | Qasam fakultattiv li jiddeskrivi l-kontenut tad-dominju. |
| **Microsoft domain** | Informazzjoni li takkumpanja l-identifikazzjoni tal-utent meta s-single sign-on (SSO) ikun attivat. |
| **Expiration** | Il-ħin massimu ta’ inattività qabel ma tiskadi sessjoni. Valur default: 60 minuta. |
| **Number of attempts before lockout** | Jillimita n-numru ta’ tentattivi ta’ dħul. Valur rakkomandat: 3 tentattivi (protezzjoni kontra attakki ta’ forza bruta). Dan il-limitu għandu jkun ≤ kwalunkwe limitu ssettjat fid-direttorju LDAP. |
| **Time before unlock (minutes)** | Il-ħin qabel ma s-sessjonijiet imblukkati jiġu żblukkati. Issettja għal 0 biex tiddiżattiva. |
| **The domain is part of cascading authentication** | Ara l-kapitolu [Awtentikazzjoni f’kaskata](#cascading-authentication). |
| **Delegate authentication to an external server** | Għażliet: No, CAS, IdeoSSO. |
| **Alternative username attribute** | Attribut LDAP użat bħala identifikatur sekondarju meta l-attribut primarju ma jsibx lill-utent (eż. `mail`, `userPrincipalName`). |
| **Maximum number of simultaneous sessions per user** | Valur rakkomandat: 1 sessjoni. |
| **Automatic deletion of the oldest session** | Jagħlaq awtomatikament sessjoni attiva meta tintalab waħda ġdida. |
| **Note displayed in the authentication form** | Nota maħsuba biss għall-utenti tad-dominju. |

### Metodu tal-awtentikazzjoni

| Qasam | Deskrizzjoni |
|---|---|
| **Authentication method** | Jiddefinixxi kif tiġi vverifikata l-identità tal-utent mad-dħul: **Form** (l-isem tal-utent u l-password jiddaħħlu manwalment) / **User certificate** (l-isem tal-utent jiġi estratt mill-qasam CN taċ-ċertifikat) / **User certificate and form** (xorta tintalab password wara l-awtentikazzjoni biċ-ċertifikat) / **Apache authentication** (awtentikazzjoni delegata lis-server web Apache) / **Pro Santé Connect (CIBA)** (awtentikazzjoni permezz tal-fornitur nazzjonali franċiż tal-identità fis-settur tas-saħħa). |
| **Force the use of the virtual keyboard** | Juri tastiera fuq l-iskrin fil-paġna tal-awtentikazzjoni biex jipproteġi d-dħul tal-password kontra l-keyloggers. |

#### Pro Santé Connect (CIBA)

Dawn l-oqsma jidhru biss meta jintgħażel il-metodu tal-awtentikazzjoni **Pro Santé Connect (CIBA)**. Pro Santé Connect huwa l-fornitur nazzjonali franċiż tal-identità għall-professjonisti tal-kura tas-saħħa.

| Qasam | Deskrizzjoni |
|---|---|
| **Identifier (client id)** | Identifikatur tal-klijent ipprovdut minn Pro Santé Connect meta tiġi rreġistrata l-applikazzjoni. |
| **Secret (client secret)** | Is-sigriet tal-klijent assoċjat, użat biex jiġu vvalidati l-iskambji OIDC ma’ Pro Santé Connect. |
| **Sandbox** | Meta jkun immarkat, CyberElements jikkonnettja mal-ambjent tat-test tal-PSC minflok mal-ambjent tal-produzzjoni. Użah biss għat-testijiet tal-integrazzjoni. |
| **RPPS retrieval** | Jiddetermina minn fejn jiġi n-numru RPPS tal-utent (repertorju franċiż tal-professjonisti tas-saħħa): **Use the authentication attribute** (l-RPPS jiġi estratt mill-attribut primarju tal-awtentikazzjoni) jew **Use another user attribute** (l-RPPS jiġi estratt minn attribut separat, li għandu jiġi speċifikat fil-qasam li jmiss). |
| **User attribute containing the RPPS** | Isem l-attribut li fih in-numru RPPS (eż. `rpps`, `healthcareProfessionalId`). Jidher u huwa obbligatorju biss jekk l-għażla preċedenti tkun issettjata għal “Use another user attribute”. |

### Token tal-awtentikazzjoni OTP

| Qasam | Deskrizzjoni |
|---|---|
| **Authentication token** | Għażla tal-ġeneratur jew tal-ġeneraturi OTP li għandhom jintużaw (iddikjarati qabel permezz tal-menu tal-ġeneraturi tat-tokens OTP). Hija possibbli għażla multipla. |
| **User attribute used to send the OTP** | Jispeċifika l-attribut tal-utent li permezz tiegħu jitwassal l-OTP għal kull token magħżul (eż. `mobile` biex jintbagħat b’SMS, `mail` biex jintbagħat bl-email). Jidher qasam wieħed għal kull token magħżul. |
| **Token expiration duration** | It-tul ta’ żmien wara li OTP mibgħut ma jibqax jiġi aċċettat. Issettja għal 0 biex tiddiżattiva l-iskadenza. |
| **Time unit** | L-unità tat-tul tal-iskadenza: **Hours** jew **Days**. Il-valur imdaħħal fil-qasam preċedenti jiġi mmultiplikat b’din l-unità (1 għas-sigħat, 24 għall-jiem). |
| **Expiration starts** | Il-punt tal-bidu tal-għadd invers tal-iskadenza: **From the last OTP validation** (l-OTP jiskadi X sigħat wara li jkun ġie vvalidat) jew **From the last successful login** (l-OTP jiskadi X sigħat wara li tinfetaħ is-sessjoni). |
| **Replace OTP characters with "*"** | Jaħbi l-karattri mdaħħla fil-qasam tal-password li tintuża darba biss waqt id-dħul. |

### Awtentikazzjoni neomia Pulse

neomia Pulse hija soluzzjoni ta’ awtentikazzjoni kontinwa bbażata fuq l-analiżi tal-imġiba. Dawn l-oqsma jidhru meta tkun immarkata l-kaxxa ta’ selezzjoni **Enable neomia Pulse authentication**.

| Qasam | Deskrizzjoni |
|---|---|
| **Enable neomia Pulse authentication** | Jattiva l-integrazzjoni ma’ neomia Pulse. Tinħoloq konfigurazzjoni Pulse għad-dominju. |
| **API URL** | URL bażi tal-API ta’ neomia Pulse għall-verifika tal-utenti (eż. `https://pulse.example.com/api`). |
| **Authentication API URL** | URL tal-endpoint tal-awtentikazzjoni ta’ Pulse jekk huwa differenti mill-URL prinċipali. |
| **API key** | Ċavetta sigrieta li tippermetti lil CyberElements jawtentika ruħu mal-API ta’ Pulse. |
| **Number of neomia Pulse attempts** | In-numru massimu ta’ tentattivi ta’ awtentikazzjoni Pulse qabel ma t-talba tiġi mblukkata. Valur default: 3. |
| **If Pulse authentication succeeds** | L-imġiba meta Pulse jivvalida b’suċċess lill-utent: **Skip the OTP token** (l-OTPs kollha kkonfigurati fuq id-dominju jinqabżu) jew **Reinforce authentication** (l-OTPs jibqgħu obbligatorji anke wara validazzjoni Pulse b’suċċess). |
| **If Pulse authentication fails** | L-imġiba ta’ riżerva jekk Pulse ifalli jew ma jkunx disponibbli: **Block access** (l-utent ma jistax jidħol, u jintbagħat lura l-kodiċi tal-iżball `PULSE_API_ERROR`) jew **Request an additional authentication factor** (qlib awtomatiku għall-awtentikazzjoni OTP standard). |
| **Display graphical components** | Juri fil-paġna tal-awtentikazzjoni l-elementi viżwali tax-xejra tat-tajping tal-interfaċċa ta’ neomia Pulse. |
| **Display authentication factors** | Juri lill-utent il-lista tal-fatturi tal-awtentikazzjoni identifikati minn Pulse. |

### Delega esterna tal-awtentikazzjoni

#### Server CAS

| Qasam | Deskrizzjoni |
|---|---|
| **CAS server URL** | L-URL sħiħ tas-server CAS li lilu tiġi delegata l-awtentikazzjoni. |

#### IdeoSSO

| Qasam | Deskrizzjoni |
|---|---|
| **CAS server URL** | L-URL sħiħ tas-server IdeoSSO. |
| **IdeoSSO, user property matching the identifier** | Isem il-proprjetà tal-utent IdeoSSO użata bħala l-identifikatur tad-dħul f’CyberElements. |

---

## Konfigurazzjoni ta’ dominju “Local directory”

### Tab: General information

| Qasam | Deskrizzjoni |
|---|---|
| **Invisible shortcut** | Jekk ikun hemm diversi dominji, immarka din il-kaxxa biex id-dominju ma jidhirx fil-lista offruta lill-utent. Id-dominju mbagħad ikun jista’ jintlaħaq biss permezz tal-URL sħiħ ta’ aċċess dirett tiegħu. |
| **Display the access condition if it is invalid** | Jekk ikun immarkat, meta kundizzjoni ta’ aċċess invalida ma tħallix lil utent jidħol, jintwerielu l-messaġġ tal-iżball korrispondenti. Jekk ma jkunx immarkat, l-utent ma jirċievi l-ebda spjegazzjoni. Disponibbli biss fil-modalità tal-editjar. |

### Tab: Password

Din it-tab tintuża biex tikkonfigura l-ġestjoni tal-passwords tal-utenti tad-dominju lokali.

| Qasam | Deskrizzjoni |
|---|---|
| **Change the user's password at first login** | Jekk ikun immarkat, fl-ewwel dħul tiegħu l-utent jiġi ridirett awtomatikament lejn skrin għall-bidla tal-password. Ma jistax jaċċessa l-portal sakemm il-bidla ma ssirx. |
| **Display the password change form** | Jekk ikun immarkat, fuq l-iskrin tad-dħul jintwera link li bih l-utent ikun jista’ jbiddel il-password tiegħu. |
| **Define a custom password policy** | Jagħmilha possibbli li tiġi definita politika tal-kumplessità u tad-durata tal-passwords speċifika għal dan id-dominju. |

Meta **Define a custom password policy** tkun immarkata, isiru disponibbli s-settings li ġejjin:

| Qasam | Deskrizzjoni |
|---|---|
| **Display the password policy to the user** | Jekk ikun immarkat, ir-regoli tal-kumplessità jintwerew lill-utent meta jissettja jew ibiddel il-password tiegħu. |
| **Minimum number of characters** | It-tul minimu meħtieġ tal-password. Valur default: 10. Issettja għal 0 biex tiddiżattiva. |
| **Minimum number of lowercase letters** | In-numru minimu ta’ ittri żgħar meħtieġa. Issettja għal 0 biex tiddiżattiva. |
| **Minimum number of uppercase letters** | In-numru minimu ta’ ittri kbar meħtieġa. Issettja għal 0 biex tiddiżattiva. |
| **Minimum number of digits** | In-numru minimu ta’ ċifri meħtieġa. Issettja għal 0 biex tiddiżattiva. |
| **Minimum number of special characters** | In-numru minimu ta’ karattri speċjali meħtieġa. Issettja għal 0 biex tiddiżattiva. |
| **Minimum password lifetime (days)** | Il-ħin minimu qabel ma l-utent ikun jista’ jbiddel il-password tiegħu. Jevita bidliet frekwenti żżejjed. Issettja għal 0 biex tiddiżattiva. |
| **Maximum password lifetime (days)** | Il-ħin wara li l-password tiskadi u trid tiġġedded. Valur default: 60 jum. Issettja għal 0 biex tiddiżattiva. |
| **Notify the user before expiration (days)** | Jibgħat email lill-utent in-numru speċifikat ta’ jiem qabel ma tiskadi l-password tiegħu. Jeħtieġ durata massima kkonfigurata, server SMTP u indirizz tal-email tas-sors. Issettja għal 0 biex tiddiżattiva. |
| **SMTP server** | Is-server użat biex jintbagħtu n-notifiki tal-iskadenza (minn fost dawk iddikjarati fil-konfigurazzjoni SMTP). |
| **Source e-mail** | L-indirizz tal-email li jidher bħala l-mittent tan-notifiki. |
| **Reject the new password if it contains the login** | Jekk ikun immarkat, jipprojbixxi l-passwords li fihom l-identifikatur tad-dħul tal-utent (protezzjoni kontra passwords ovvji). |
| **Reject the new password if it matches one of the last X** | Iżomm storja tal-passwords u jipprojbixxi l-użu mill-ġdid tan-numru speċifikat ta’ passwords preċedenti. Issettja għal 0 biex tiddiżattiva. |

---

## Konfigurazzjoni ta’ dominju “LDAP directory”

### Tab: General information

| Qasam | Deskrizzjoni |
|---|---|
| **Invisible shortcut** | Jekk ikun hemm diversi dominji, immarka din il-kaxxa biex id-dominju ma jidhirx fil-lista offruta lill-utent. |

### Tab: LDAP settings

#### Konnessjoni

| Qasam | Deskrizzjoni |
|---|---|
| **Authentication through a site** | Jekk immarkat, CyberElements juża l-komponent Edge Gateway ta’ sit biex jasal għad-direttorju, u b’hekk ma jkunx hemm bżonn li jinfetħu regoli tal-firewall għat-traffiku deħlin mid-DMZ. Fit-tieni qasam tista’ tagħżel is-sit li għandu jintuża. |
| **Authentication type** | Il-protokoll tal-bind mas-server LDAP: **SIMPLE** (bind b’DN + password f’test ċar fuq TLS) / **NTLM** (awtentikazzjoni Windows, jeħtieġ is-suffiss tad-dominju Microsoft) / **SASL/Digest-MD5** (awtentikazzjoni SASL b’hashing MD5, ma tibgħatx il-password f’test ċar). |
| **Microsoft domain suffix** | Is-suffiss tad-dominju Windows użat biex jinbena l-identifikatur NTLM (eż. `CONTOSO`). Jidher biss jekk it-tip ta’ awtentikazzjoni jkun NTLM. |

#### Tfittxija ta’ utenti u gruppi

| Qasam | Deskrizzjoni |
|---|---|
| **Search mode** | Jiddefinixxi l-istrateġija għall-irkupru tal-gruppi mid-direttorju: **Retrieve groups from a group attribute** (jgħaddi mill-gruppi u jaqra l-membri tagħhom — adattat għal direttorji standard) / **Retrieve groups from a user attribute** (jaqra l-attribut `memberOf` ta’ kull utent — aktar mgħaġġel fuq Active Directory) / **Retrieve nested groups through the TokenGroups attribute** (juża l-attribut speċjali `tokenGroups` tal-AD biex isolvi l-gruppi inkorporati b’mod rikorsiv — rakkomandat fuq Active Directory). |
| **User attribute containing the groups** | Isem l-attribut tal-oġġett tal-utent li jelenka l-gruppi li jagħmel parti minnhom. Jidher biss jekk tkun magħżula l-modalità “from a user attribute”. |
| **Use the user's DN to log in** | Jekk ikun immarkat, id-DN sħiħ tal-utent jintuża waqt l-operazzjoni tal-bind LDAP (awtentikazzjoni). |
| **User authentication attribute** | Attribut LDAP użat bħala l-identifikatur uniku tal-utent mad-dħul. Valuri ssuġġeriti: `sAMAccountName` (Active Directory), `cn`, `sn`, `uid`, `mailNickname`, `userPrincipalName`, `employeeID`, jew personalizzat. |
| **User attribute customisation** | Iħallik iddaħħal manwalment attribut li mhuwiex fil-lista. Jidher biss jekk tkun magħżula “custom”. |
| **Group authentication attribute** | Attribut LDAP użat biex jidentifika l-gruppi b’mod uniku (eż. `cn`, `sAMAccountName`). |

#### Siġra

| Qasam | Deskrizzjoni |
|---|---|
| **Users branch** | Id-DN sħiħ tal-unità organizzattiva li fiha l-utenti (eż. `ou=Users,dc=example,dc=com`). |
| **Groups branch** | Id-DN sħiħ tal-unità organizzattiva li fiha l-gruppi (eż. `ou=Groups,dc=example,dc=com`). |
| **Manual group management** | Jekk ikun immarkat, il-gruppi ma jiġux sinkronizzati awtomatikament mid-direttorju LDAP. L-amministraturi jridu jżidu u jneħħu l-gruppi manwalment f’CyberElements. |

#### Kont tas-servizz

| Qasam | Deskrizzjoni |
|---|---|
| **Service account (must be able to reset passwords)** | L-identifikatur tal-kont tas-servizz użat minn CyberElements biex jistaqsi lid-direttorju — pereżempju l-attribut `sAMAccountName` tiegħu (`svc_cye`). Dan il-kont irid ikun jista’ **jerġa’ jissettja l-passwords** tal-utenti tad-dominju, inkella l-bidla tal-password mill-portal tal-utent tfalli. Il-konsol ma jirrakkomandax DN sħiħ, li jista’ joħloq problemi fil-ġestjoni tas-servers RDS. Huwa rrakkomandat ħafna li tiddefinixxi kont dedikat u li tiddiżattiva l-bind anonimu mad-direttorju. |
| **Password** | Il-password tal-kont tas-servizz. |
| **User class** | Il-klassi tal-oġġett LDAP tal-utenti li għandhom jiġu mfittxija fid-direttorju (eż. `person`, `inetOrgPerson`, `user` għal Active Directory). |
| **Group filter** | Filtru addizzjonali attribut/valur biex jiġu identifikati l-gruppi fid-direttorju. Jintuża biss mal-modalità tat-tfittxija “from a group attribute”. |

#### Password tal-utenti

| Qasam | Deskrizzjoni |
|---|---|
| **Display the password change form** | Jekk ikun immarkat, fuq l-iskrin tad-dħul jintwera link għall-bidla tal-password. Din l-għażla hija disponibbli biss jekk il-konnessjoni mad-direttorju tuża SSL (LDAPS) jew tgħaddi minn sit. |
| **Check whether the password must be changed** | Jekk ikun immarkat, CyberElements jistaqsi lid-direttorju LDAP biex isir jaf jekk l-utent għandux ibiddel il-password tiegħu (l-attribut `pwdLastSet` fuq Active Directory) u jġiegħlu jagħmel dan jekk ikun meħtieġ. |
| **Check the password complexity when it is changed** | Jekk ikun immarkat, CyberElements jivverifika li l-password il-ġdida tissodisfa l-politika tal-kumplessità definita fid-direttorju meta tinbeda bidla mill-portal. |

#### Għażla Radius

| Qasam | Deskrizzjoni |
|---|---|
| **Enable the Radius option** | Immarka din il-kaxxa biss jekk id-direttorju LDAP ikun akkoppjat ma’ awtentikazzjoni Radius (b’żewġ fatturi). Din l-għażla tista’ tiġi attivata biss meta jinħoloq id-dominju u ma tistax tinbidel wara. |

Meta l-għażla Radius tkun attivata, jidhru s-settings li ġejjin:

| Qasam | Deskrizzjoni |
|---|---|
| **Mode** | Il-modalità tat-tħaddim tas-server Radius: **quicklog** (awtentikazzjoni diretta: il-password tgħaddi kif inhi lis-server Radius) jew **challenge/response** (is-server Radius jibgħat sfida li l-utent irid iwieġeb għaliha). |
| **Server** | L-indirizz IP jew l-isem DNS tas-server Radius. |
| **Port** | Il-port tas-smigħ tas-server Radius. Valur default: 1812. |
| **Secret** | Is-sigriet kondiviż bejn CyberElements u s-server Radius, użat biex jiġu kriptati l-iskambji. |
| **Number of attempts** | In-numru massimu ta’ tentattivi qabel ma CyberElements jieqaf jipprova t-talba lis-server Radius. Valur default: 3. |
| **Timeout (seconds)** | Il-ħin massimu ta’ stennija għat-tweġiba tas-server Radius qabel ma jiskadi ż-żmien. Valur default: 10 sekondi. |
| **Radius NAS IP address** | L-indirizz IP tas-sors li CyberElements jiddikjara lis-server Radius (l-attribut NAS-IP-Address). Għandu jiġi ssettjat jekk is-server Radius jiffiltra t-talbiet skont l-indirizz IP tas-sors. |

#### Settings oħra

| Qasam | Deskrizzjoni |
|---|---|
| **Allow RDS server management** | Jekk ikun immarkat, il-kontijiet f’dan id-dominju jistgħu jiġu assoċjati ma’ servers RDS fil-modulu tal-ġestjoni tas-servers RDS. |
| **Use specific certificate authorities to validate LDAPS certificates** | Jekk ikun immarkat, CyberElements juża ċertifikat CA personalizzat biex jivvalida ċ-ċertifikat ippreżentat mis-server LDAP waqt il-konnessjonijiet SSL. Jekk ma jkunx immarkat, jintużaw is-CAs tas-sistema (`/etc/ssl/certs/ca-certificates.crt`). |
| **Certificate authorities (base64 encoding)** | Fajl li fih il-CA root (waħda jew aktar) f’format PEM (test li jibda bi `-----BEGIN CERTIFICATE-----`). Jidher u huwa obbligatorju biss jekk l-għażla preċedenti tkun attivata. |

#### Servers LDAP

Il-grilja tas-servers telenka s-servers assoċjati mad-dominju (kolonni: **Server**, **Port**, **Protocol**). Id-definizzjoni ta’ diversi servers tiżgura disponibbiltà għolja: CyberElements jaqleb awtomatikament għal server disponibbli f’każ ta’ ħsara.

Biex iżżid server, ikklikkja `+`. Daħħal:

| Qasam | Deskrizzjoni |
|---|---|
| **Server** | L-indirizz IP jew l-isem DNS tas-server LDAP. |
| **Port** | Il-port tal-aċċess. Valur default: 389 (LDAP) jew 636 (LDAPS). |
| **Protocol** | LDAP jew LDAP fuq SSL. L-użu ta’ SSL huwa rrakkomandat ħafna anke fuq netwerk intern. |

Biex timmodifika server eżistenti, agħżlu u kklikkja l-ikona **Properties**.
Biex tħassar server, agħżlu u kklikkja `×`.

---

## Konfigurazzjoni ta’ dominju “Anonymous directory”

Dominju anonimu jista’ jintuża fil-każijiet rari fejn l-aċċess għal applikazzjoni ma jeħtieġx awtentikazzjoni għax l-utent ikun diġà ġie awtentikat b’mezzi speċifiċi.

| Qasam | Deskrizzjoni |
|---|---|
| **Maximum number of connections** | Jillimita n-numru ta’ konnessjonijiet simultanji possibbli fuq dan id-dominju. |
| **Use the certificate CN as the user identifier** | Jekk ikun immarkat, l-identifikatur tal-utent jiġi estratt awtomatikament mill-qasam CN taċ-ċertifikat tal-klijent ippreżentat mal-konnessjoni. Dan l-identifikatur imbagħad jintuża għall-SSO. |
| **Identifier format, from the DN** | Espressjoni għall-bini tal-identifikatur mill-komponenti tad-DN taċ-ċertifikat (eż. `%CN%@%OU%`). Jidher biss jekk l-għażla preċedenti tkun attivata. |

---

## Konfigurazzjoni ta’ dominju “SAML”

Meta jintuża dominju SAML, CyberElements jaġixxi bħala l-fornitur tas-servizz (SP) u jiddelega l-awtentikazzjoni lil fornitur tal-identità estern (IdP).

### Tab: General information

| Qasam | Deskrizzjoni |
|---|---|
| **Identity provider** | It-tip ta’ fornitur tal-identità: **Other** (kwalunkwe IdP SAML standard) jew **Azure** (Microsoft Azure AD / Entra ID, li barra minn hekk jattiva s-sinkronizzazzjoni asinkronika tal-gruppi). |
| **Identity provider EntityId** | L-identifikatur uniku tal-IdP fil-federazzjoni SAML. Il-valur tiegħu jiġi pprovdut mill-IdP (eż. `https://sts.windows.net/{tenant-id}/` għal Azure, `https://[serverName]/idp/shibboleth` għal Shibboleth). |
| **Group names variable** | Isem l-attribut SAML li jġorr is-sħubija tal-utent fil-gruppi fl-asserzjoni (eż. `http://schemas.microsoft.com/ws/2008/06/identity/claims/groups` għal Azure). |
| **Email variable** | Isem l-attribut SAML li minnu l-pjattaforma taqra l-indirizz tal-email. Qasam **li jinqara biss**: il-valur huwa ffissat għal `saml-mail` u ma jistax jiġi kkonfigurat. |
| **Login variable** | Isem l-attribut SAML użat bħala l-identifikatur tad-dħul f’CyberElements (eż. `http://schemas.xmlsoap.org/ws/2005/05/identity/claims/name`). |
| **The domain is part of cascading authentication** | Ara l-kapitolu [Awtentikazzjoni f’kaskata](#cascading-authentication). |
| **Manual configuration** | Jekk ikun immarkat, il-parametri tal-fornitur tal-identità jridu jiddaħħlu manwalment (EntityId tal-endpoints SAML). Jekk ma jkunx immarkat, dawn il-parametri jiġu estratti awtomatikament mill-fajl tal-metadata. Disponibbli biss fil-modalità tal-editjar. |

---

> **Metadata tal-fornitur tal-identità**
>
> Il-konsol tal-amministrazzjoni ma juri l-ebda skrin għall-iskambju tal-metadata SAML: dik it-tab tappartjeni għall-offerta SaaS. F’**client hosted**, il-metadata tal-IdP u l-metadata tal-fornitur tas-servizz huma kkonfigurati **manwalment, fil-fajls tal-konfigurazzjoni Shibboleth tal-komponent Mediation Controller**.

---

## Awtentikazzjoni f’kaskata

Żur il-paġna [general options](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/GeneralOptions/) biex tattiva l-awtentikazzjoni f’kaskata.

Meta utent jaċċessa l-portal, is-sistema tfittex fost id-dominji f’kaskata dawk li għalihom l-awtentikazzjoni hija possibbli mingħajr login/password (SAML, Apache, ċertifikat). Jintuża l-ewwel dominju li jagħraf lill-utent. Jekk l-ebda dominju ma jista’ jawtentika mingħajr password, jintwerew l-oqsma login/password.

Ladarba tiġi attivata, jidhru żewġ buttuni fil-lista tad-dominji:

- **Immarka** “The domain is part of cascading authentication” għal kull dominju mixtieq.
- **L-ordni** jista’ jinbidel bil-vleġeġ ’il fuq/’l isfel. L-ordni 0 jiġi pproċessat l-ewwel.

> **Nota**
>
> Id-dominji **Anonymous** u **Radius**, kif ukoll dawk li jiddelegaw l-awtentikazzjoni lil server estern (**CAS**), ma jistgħux jintużaw fl-awtentikazzjoni f’kaskata.
