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

# ACM contracts

Il-modulu **ACM contracts** fih l-awtorizzazzjonijiet li mingħajrhom l-ebda talba ACM ma tirnexxi qatt. Kuntratt jorbot **aġenti ACM**, **utenti ACM**, **aliases** tal-modulu Vault u — skont l-għażla — jew l-applikazzjonijiet kollha jew lista ta’ **applikazzjonijiet ACM**, fuq **sit wieħed jew aktar**. Barra minn hekk, jista’ jkun validu biss matul perjodi speċifiċi.

> **Disponibbiltà ta’ ACM**
>
> L-iskrin **ACM** u l-ħames moduli tiegħu jidhru fil-konsol biss meta l-użu ta’ ACM ikun ippermess: huma meħtieġa kemm **liċenzja** li tkopri ACM kif ukoll l-għażla **Allow ACM usage** immarkata għall-organizzazzjoni, fil-konsol tas-sistema.

## Lista tal-kuntratti

Kull ringiela turi l-isem tal-kuntratt, preċedut minn ikona ta’ katnazz, imbagħad in-**numru** ta’ elementi assoċjati f’kull dimensjoni.

| Kolonna | Kontenut |
|---|---|
| **Name** | Isem il-kuntratt. |
| **ACM users** | Numru ta’ utenti ACM koperti. |
| **ACM agents** | Numru ta’ aġenti ACM koperti. |
| **Sites** | Numru ta’ siti fejn japplika l-kuntratt. |
| **ACM applications** | Numru ta’ applikazzjonijiet awtorizzati, jew **All** b’korsiv meta l-kuntratt ma jkunx limitat għal lista. |
| **Alias** | Numru ta’ aliases tal-modulu Vault li jistgħu jintlaħqu. |

Il-qasam tat-tfittxija jiffiltra fuq l-isem tal-kuntratt, iżda wkoll fuq l-**isem tal-eżekutibbli** tal-applikazzjonijiet, fuq l-**identifikatur** tal-utenti, u fuq l-**isem** u l-**ospitant** tal-aġenti. Sakemm ma jeżisti l-ebda kuntratt, il-grilja turi **No available ACM contracts**.

> **Espandi ringiela biex tara d-dettall**
>
> Il-vleġġa fil-bidu ta’ ringiela tespandi l-kuntratt u telenka, ringiela waħda għal kull dimensjoni, l-elementi li huma effettivament assoċjati — utenti, aġenti, siti, applikazzjonijiet u mbagħad aliases. Ħjiel jirrepeti l-istess informazzjoni f’forma b’intestaturi (“User: ” / “Users: ”, “ACM agent: ” / “ACM agents: ”, “Site: ” / “Sites: ”, “Application: ” / “Applications: ”, “Alias: ” / “Aliases: ”). L-intestatura taqbel man-numru ta’ elementi.

### Azzjonijiet tal-istrixxa tal-għodod

| Azzjoni | Disponibbiltà | Effett |
|---|---|---|
| **+** — ħjiel **Add** | Dejjem | Jiftaħ il-formola tal-ħolqien (ara l-kapitolu [Żieda ta’ kuntratt](#add-a-contract)). |
| Ikona tal-editjar — ħjiel **Properties** | Għażla = 1 | Jiftaħ l-istess formola, mimlija minn qabel. |
| **×** — ħjiel **Delete** | Għażla ≥ 1 | Jitlob konferma (ara l-kapitolu [Tħassir ta’ kuntratt](#delete-a-contract)). |
| **Export** | Dejjem | Iniżżel il-kuntratti f’format CSV (ara l-kapitolu [Esportazzjoni tal-kuntratti](#export-the-contracts)). |
| **Import** | Dejjem | Jiftaħ l-assistent tal-importazzjoni CSV (ara l-kapitolu [Importazzjoni tal-kuntratti](#import-contracts)). |

## Żieda ta’ kuntratt

Ikklikkja **+**. Tinfetaħ it-tieqa **Add ACM contract**. Din tikkonsisti f’intestatura komuni u f’navigazzjoni b’**sitt tabs**, li għandhom jiġu mgħoddija bl-ordni waqt il-ħolqien: il-buttuna tal-bgħit issir attiva biss meta kull tab tkun valida.

### Intestatura

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Obbligatorju, uniku. Sa 256 karattru. Valur magħmul biss minn spazji vojta jiġi rrifjutat. |
| **Description** | Fakultattiv. Sa 256 karattru. |

### Tabs

L-ewwel ħames tabs jaħdmu bl-istess mod: **lista doppja**, bl-elementi disponibbli fuq ix-xellug, l-elementi magħżula fuq il-lemin, u buttuna biex tagħżel kollox.

**ACM agents**

> Aġenti ACM iddikjarati fil-modulu [ACM agents](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AcmAgents/). **Mill-inqas aġent wieħed** huwa meħtieġ. Jekk ma jkun iddikjarat l-ebda aġent, il-lista turi **No agents**.

**Sites**

> Is-siti fejn japplika l-kuntratt. **Mill-inqas sit wieħed** huwa meħtieġ. Jekk ma jeżisti l-ebda sit, il-lista turi **No Sites**.

**ACM applications**

> Il-kontenut tat-tab huwa rregolat mill-kaxxa ta’ selezzjoni **Only allow specific applications**.
>
> | Stat tal-kaxxa ta’ selezzjoni | Effett |
> |---|---|
> | **Immarkata** *(stat inizjali waqt il-ħolqien)* | Il-kuntratt ikopri biss l-applikazzjonijiet magħżula fil-lista. Għalhekk, **mill-inqas applikazzjoni waħda** hija meħtieġa, inkella t-tab tibqa’ invalida. |
> | **Mhux immarkata** | Il-kuntratt ikopri l-applikazzjonijiet **kollha**, u l-kontenut tal-lista jiġi injorat. Il-kolonna **ACM applications** tal-grilja mbagħad turi **All**. |
>
> L-applikazzjonijiet offruti huma dawk tal-modulu [ACM applications](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AcmApplications/); jekk ma tkun iddikjarata l-ebda waħda, il-lista turi **No applications**.

**ACM users**

> Utenti ACM iddikjarati fil-modulu [ACM users](https://docs.cyberelements.io/bastion/4.6/mt/Usage/AdminConsoleReference/AcmUsers/). **Mill-inqas utent wieħed** huwa meħtieġ. Jekk ma jkun iddikjarat l-ebda wieħed, il-lista turi **No users**.

**Alias**

> Aliases tal-modulu Vault. Kull alias huwa segwit, bejn parentesi, mill-kont li fih, fil-forma `domain\name` (jew l-isem tal-kont waħdu meta ma jkollux dominju). **Mill-inqas alias wieħed** huwa meħtieġ. Jekk il-modulu Vault ma jesponi l-ebda wieħed, il-lista turi **No alias**.

**Restrictions**

> Erba’ restrizzjonijiet indipendenti u kumulattivi. Kull waħda tiġi attivata mill-kaxxa ta’ selezzjoni tagħha; l-oqsma korrispondenti jibqgħu **diżattivati** sakemm tiġi mmarkata.
>
> | Kaxxa ta’ selezzjoni | Oqsma attivati |
> |---|---|
> | **Date:** | **Beginning date** u **End Date**, fil-format `dd/mm/yyyy`. Id-data tat-tmiem titressaq lura għad-data tal-bidu meta tiġi qabilha. |
> | **Hour** | **Starting hour** u **Ending hour**. Il-ħinijiet jintwerew fiż-żona tal-ħin tal-konsol. Iż-żewġ valuri jridu jkunu differenti, inkella l-qasam **Ending hour** jirrapporta “Ending hour cannot be equal to starting hour”. |
> | **Month:** | Tnax-il kaxxa ta’ selezzjoni, waħda għal kull xahar, identifikati bl-**inizjali** tagħhom. Kollha jiġu mmarkati meta r-restrizzjoni tiġi attivata, u mill-inqas waħda trid tibqa’ mmarkata. |
> | **Day of the week** | Seba’ kaxxi ta’ selezzjoni, waħda għal kull jum, identifikati bl-**inizjali** tagħhom. Kollha jiġu mmarkati meta r-restrizzjoni tiġi attivata, u mill-inqas waħda trid tibqa’ mmarkata. |
>
> Taħt il-formola, test jiġbor fil-qosor l-effett tar-restrizzjonijiet bi kliem sempliċi u jiġi aġġornat ma’ kull bidla: jew **The current contract allows connections without restriction.**, jew **The current contract allows connections with following restrictions:** segwit minn punt elenkat wieħed għal kull restrizzjoni attiva — “Connections are allowed from … to …”, “… from … to …”, “… in ”, “… on ”.

Ikklikkja **Validate** biex tissejvja.

> **Isem diġà użat**
>
> Jekk l-isem diġà jintuża minn kuntratt ieħor, is-salvataġġ jiġi rrifjutat bil-messaġġ **An ACM contract already has this name.**

## Editjar ta’ kuntratt

Agħżel ringiela, imbagħad ikklikkja l-ikona **Properties** (jew agħfas darbtejn). It-tieqa **Edit ACM contract** turi l-istess formola, bl-għażliet attwali mgħobbija minn qabel f’kull tab, inklużi ir-restrizzjonijiet. Kuntratt li jkopri l-applikazzjonijiet kollha jinfetaħ bil-kaxxa ta’ selezzjoni tat-tab **ACM applications** mhux immarkata.

## Tħassir ta’ kuntratt

Agħżel ringiela waħda jew aktar, imbagħad ikklikkja **×**. Tintalab konferma. It-tħassir jaffettwa biss il-kuntratt: l-aġenti, l-applikazzjonijiet, l-utenti u l-aliases li kien isemmi jibqgħu — u jerġgħu jsiru jistgħu jitħassru jekk l-ebda kuntratt ieħor ma jirreferi għalihom.

## Esportazzjoni tal-kuntratti

Il-buttuna **Export** tniżżel fajl `acm_contracts.csv`, separat b’punt u virgola, li jiddeskrivi il-kuntratti murija. Kolonna waħda għal kull dimensjoni tal-kuntratt:

| Kolonna | Kontenut |
|---|---|
| **Name**, **Description** | Intestatura tal-kuntratt. |
| **Allow any application** | Valur Boolean: veru meta l-kuntratt ma jkunx limitat għal lista ta’ applikazzjonijiet. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Listi tal-elementi assoċjati, indikati bl-isem tagħhom (isem l-eżekutibbli għall-applikazzjonijiet, identifikatur għall-utenti). |
| **Beginning date**, **End Date** | Il-limiti tal-validità, meta r-restrizzjoni tad-data tkun attiva. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Restrizzjonijiet perjodiċi. ⚠ Il-firxiet tal-ħin jiġu esportati f’**GMT**, filwaqt li l-iskrin jurihom fiż-żona tal-ħin tal-konsol. |

## Importazzjoni tal-kuntratti

Il-buttuna **Import** tiftaħ l-assistent tal-importazzjoni tal-konsol, li jistenna fajl CSV li fih il-kolonni ta’ hawn fuq — għalhekk esportazzjoni sservi ta’ mudell. Il-kolonna **Name** biss hija obbligatorja; kuntratt li ismu diġà meħud jiġi rrappurtat bħala duplikat.

> **Importazzjoni tista’ toħloq applikazzjonijiet u utenti**
>
> L-elementi **ACM applications** u **ACM users** imsemmija fil-fajl li għadhom ma jeżistux **jinħolqu** matul il-proċess, sakemm il-valur tagħhom ikun validu (mogħdija tal-eżekutibbli, identifikatur tal-kont). Min-naħa l-oħra, l-elementi **ACM agents** u s-**siti** iridu jeżistu minn qabel: l-importazzjoni ma toħloqhomx.
