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

# ACM agents

Il-modulu **ACM agents** jiddikjara u jmexxi l-aġenti ACM skjerati fuq kompjuters remoti. Aġent ACM jaħdem bħala servizz Windows fuq il-kompjuter u jilħaq is-servizz ACM ippubblikat minn komponent Edge Gateway ta’ Bastion biex jikseb il-passwords li jeħtieġu l-applikazzjonijiet lokali. Amministratur jużah biex joħloq rekord tal-aġent, jiskjera jew ineħħi s-servizz mill-bogħod, u jiġġenera il-materjal tal-konfigurazzjoni li għandu jiġi inkorporat fil-kompjuter.

> **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. Jekk waħda minnhom tkun nieqsa, l-iskrin ikun moħbi u kull operazzjoni ACM tiġi rrifjutata.

## Lista tal-aġenti

| Kolonna | Deskrizzjoni |
|---|---|
| **Name** | Identifikatur uniku tal-aġent. |
| **Description** | Test liberu. |
| **Host** | Isem il-kompjuter fejn l-aġent huwa (jew se jkun) skjerat. |

Il-qasam tat-tfittxija tal-istrixxa tal-għodod jiffiltra fuq dawn it-tliet valuri f’daqqa. Sakemm ma jeżisti l-ebda aġent, il-grilja turi **No agents**.

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

L-azzjonijiet li joperaw fuq aġent eżistenti jibqgħu diżattivati sakemm l-għażla ma tagħmilhomx disponibbli.

| Azzjoni | Disponibbiltà | Effett |
|---|---|---|
| **+** — ħjiel **Add** | Dejjem | Jiftaħ il-formola tal-ħolqien (ara l-kapitolu [Żieda ta’ aġent](#add-an-agent)). |
| 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’ aġent](#delete-an-agent)). |
| **Deploy Agent** | Għażla ≥ 1 | Jinstalla s-servizz fuq il-kompjuters tal-aġenti magħżula (ara l-kapitolu [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Għażla ≥ 1 | Jiddiżinstalla s-servizz mill-bogħod (ara l-kapitolu [Remove Agent](#remove-agent)). |
| **Download configuration** | Għażla = 1 | Jipproduċi l-arkivju tal-konfigurazzjoni tal-aġent (ara l-kapitolu [Download configuration](#download-configuration)). |

Meta tagħfas darbtejn fuq ringiela, dan huwa ekwivalenti għal **Properties**.

## Żieda ta’ aġent

Ikklikkja **+**. Tinfetaħ it-tieqa **Add ACM agent**. L-oqsma kollha huma obbligatorji ħlief id-deskrizzjoni.

| Qasam | Deskrizzjoni |
|---|---|
| **Name** | Uniku. Sa 1024 karattru. |
| **Description** | Fakultattiv. Sa 256 karattru. |
| **Host** | Isem il-kompjuter fil-mira. Sa 1024 karattru. |

Ikklikkja **Validate**. Id-dikjarazzjoni ta’ aġent **ma tiskjera xejn**: toħloq l-entrata biss.

> **Isem diġà użat**
>
> Jekk l-isem diġà jeżisti, is-server jirrifjuta ż-żieda bil-messaġġ **An ACM agent already has this name.**

## Editjar ta’ aġent

Agħżel ringiela, imbagħad ikklikkja l-ikona **Properties** (jew agħfas darbtejn). It-tieqa **Edit ACM agent** turi l-istess oqsma.

## Tħassir ta’ aġent

Agħżel ringiela waħda jew aktar, imbagħad ikklikkja **×**. Tintalab konferma.

> **Aġent użat minn kuntratt ACM**
>
> Aġent li jidher fi **ACM contract** ma jistax jitħassar. L-operazzjoni ma tiġix ikkanċellata għalkollox: l-aġenti mhux użati **jitħassru**, u messaġġ ta’ żball jelenka l-**aġenti li nżammu** — “The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” segwit mill-ismijiet tagħhom. Biex tħassarhom, l-ewwel neħħihom minn dawk il-kuntratti.

## Deploy Agent

Agħżel aġent wieħed jew aktar, imbagħad ikklikkja **Deploy Agent**. It-tieqa bl-istess isem titlob il-parametri tal-iskjerament. L-oqsma kollha huma obbligatorji.

| Qasam | Deskrizzjoni |
|---|---|
| **Host** | Biss għall-qari. Il-kompjuters tal-aġenti magħżula, separati b’virgoli. |
| **Gateway** | Il-komponent Edge Gateway li jmexxi l-iskjerament. Huma offruti biss il-komponenti Edge Gateway **bir-reġistrazzjoni**. |
| **Domain** | Id-dominju tal-kont użat biex tinfetaħ is-sessjoni remota. |
| **Username** | Kont awtorizzat biex jinstalla softwer fuq il-kompjuter. |
| **Password** | Il-password korrispondenti (moħbija). |
| **Target drive** | L-ittra tad-drajv tal-installazzjoni. Valur default: `c`. |
| **Target directory** | Mogħdija f’dak id-drajv. Valur default: `Program Files (x86)\Systancia\ACMAgent`. Sa 1024 karattru. |

Meta tibgħat, il-grilja tibqa’ msakkra fuq il-messaġġ **Deployment in progress...**.

| Eżitu | Rispons |
|---|---|
| Aġent wieħed | Messaġġ wieħed: **Agent deployment succeeded**, **Deployment failed**, **Agent already present**, jew iċ-ċaħda minħabba nuqqas ta’ permess. |
| Diversi aġenti | It-tieqa **Agent deployment log**, b’ringiela waħda għal kull aġent fil-forma `name (host)`, bl-istatus **Success**, **Failure** jew **Agent already present**. |

## Remove Agent

Agħżel aġent wieħed jew aktar, imbagħad ikklikkja **Remove Agent**. Il-formola turi **Host**, **Gateway**, **Domain**, **Username** u **Password** — iż-żewġ oqsma speċifiċi għall-installazzjoni ma jintalbux. Il-grilja turi **Deletion in progress...**, imbagħad l-eżitu jiġi ppreżentat bl-istess mod: messaġġ (**The agent is not present on the server.**, jew **The agent is in use and can not be deleted.**) għal aġent wieħed, it-tieqa **Agent removal log** għal aktar minn aġent wieħed, fejn l-istatus **Agent not present** jieħu post **Agent already present**.

> **Ir-rekord jibqa’ ddikjarat**
>
> It-tneħħija tas-servizz ma tneħħix l-aġent mil-lista: ir-rekord jibqa’ u jista’ iservi għal skjerament ġdid. Biex tħassru, uża **×** (kapitolu [Tħassir ta’ aġent](#delete-an-agent)).

## Download configuration

Agħżel **eżattament aġent wieħed**, imbagħad ikklikkja **Download configuration**. It-tieqa titlob biss il-**Host** (biss għall-qari) u l-**Gateway**. Meta tibgħat, il-browser iniżżel arkivju `<agent name>.zip` li fih:

| Fajl | Kontenut |
|---|---|
| `<agent name>.p12` | Iċ-ċertifikat tal-klijent tal-aġent, iġġenerat fuq talba. |
| `ca.crt` | Iċ-ċertifikat tal-awtorità li tiffirma s-servizz ACM. |
| `configuration.xml` | Il-mogħdija taċ-ċertifikat tal-klijent u l-indirizzi `fqdn:port` tas-servizz ACM ippubblikat mill-komponent Edge Gateway magħżul. |
| `readme.txt` | It-tliet operazzjonijiet li għandhom isiru fuq il-kompjuter. |

Din il-modalità sservi għall-iskjerament **manwali** tal-aġent, meta l-installazzjoni mill-bogħod ma tkunx possibbli. Il-fajl `readme.txt` jiddeskrivi l-proċedura: importa `ca.crt` fl-awtoritajiet taċ-ċertifikazzjoni għerq fdati **tal-kompjuter lokali**, ikkopja l-fajls fil-folder tal-installazzjoni tal-aġent, imbagħad ibda mill-ġdid is-servizz **Cleanroom Credentials Manager**.

> **Falliment tal-ġenerazzjoni**
>
> Jekk l-arkivju ma jistax jiġi prodott, jintwera l-messaġġ **An error occured while generating configuration**. Il-komponent Edge Gateway irid ikun **online**: huwa l-komponent Edge Gateway li jipprovdi l-port tas-servizz ACM.
