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

# ACM agents

Moodul **ACM agents** deklareerib kaugarvutitesse juurutatud ACM-agendid ja juhib neid. ACM-agent töötab arvutis Windowsi teenusena ja jõuab ACM-teenuseni, mille avaldab Bastion Edge Gateway komponent, et hankida kohalike rakenduste vajatavad paroolid. Administraator kasutab seda agendikirje loomiseks, teenuse kaugjuurutamiseks või -eemaldamiseks ning arvutisse manustatava konfiguratsioonimaterjali genereerimiseks.

> **ACM-i saadavus**
>
> Kuva **ACM** ja selle viis moodulit ilmuvad konsoolis ainult siis, kui ACM on lubatud: on vaja nii ACM-i hõlmavat **litsentsi** kui ka süsteemikonsoolis organisatsiooni jaoks märgitud suvandit **Allow ACM usage**. Kui üks neist puudub, on kuva peidetud ja kõik ACM-toimingud lükatakse tagasi.

## Agentide loend

| Veerg | Kirjeldus |
|---|---|
| **Name** | Agendi kordumatu identifikaator. |
| **Description** | Vaba tekst. |
| **Host** | Arvuti nimi, kuhu agent on juurutatud (või juurutatakse). |

Tööriistariba otsinguväli filtreerib korraga nende kolme väärtuse järgi. Kuni ühtegi agenti pole, kuvatakse tabelis **No agents**.

### Tööriistariba toimingud

Olemasoleva agendiga seotud toimingud jäävad mitteaktiivseks, kuni valik neid võimaldab.

| Toiming | Saadavus | Mõju |
|---|---|---|
| **+** — kohtspikker **Add** | Alati | Avab loomisvormi (vt peatükki [Agendi lisamine](#add-an-agent)). |
| Redigeerimisikoon — kohtspikker **Properties** | Valik = 1 | Avab sama vormi eeltäidetuna. |
| **×** — kohtspikker **Delete** | Valik ≥ 1 | Küsib kinnitust (vt peatükki [Agendi kustutamine](#delete-an-agent)). |
| **Deploy Agent** | Valik ≥ 1 | Installib teenuse valitud agentide arvutitesse (vt peatükki [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Valik ≥ 1 | Desinstallib teenuse kaugelt (vt peatükki [Remove Agent](#remove-agent)). |
| **Download configuration** | Valik = 1 | Loob agendi konfiguratsiooniarhiivi (vt peatükki [Download configuration](#download-configuration)). |

Rea topeltklõpsamine on samaväärne toiminguga **Properties**.

## Agendi lisamine

Klõpsake **+**. Avaneb aken **Add ACM agent**. Kõik väljad on kohustuslikud, välja arvatud kirjeldus.

| Väli | Kirjeldus |
|---|---|
| **Name** | Kordumatu. Kuni 1024 märki. |
| **Description** | Valikuline. Kuni 256 märki. |
| **Host** | Sihtarvuti nimi. Kuni 1024 märki. |

Klõpsake **Validate**. Agendi deklareerimine **ei juuruta midagi**: see ainult salvestab kirje.

> **Nimi on juba kasutusel**
>
> Kui nimi on juba olemas, lükkab server lisamise tagasi teatega **An ACM agent already has this name.**

## Agendi redigeerimine

Valige rida ja klõpsake seejärel ikooni **Properties** (või topeltklõpsake). Aknas **Edit ACM agent** kuvatakse samad väljad.

## Agendi kustutamine

Valige üks või mitu rida ja klõpsake seejärel **×**. Küsitakse kinnitust.

> **ACM-lepingus kasutatav agent**
>
> Agenti, mis esineb lepingus **ACM contract**, ei saa kustutada. Toimingut ei tühistata täielikult: kasutamata agendid **kustutatakse** ja tõrketeade loetleb **alles jäetud agendid** — „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“, millele järgnevad nende nimed. Nende kustutamiseks eemaldage need esmalt neist lepingutest.

## Deploy Agent

Valige üks või mitu agenti ja klõpsake seejärel **Deploy Agent**. Samanimeline aken küsib juurutusparameetreid. Kõik väljad on kohustuslikud.

| Väli | Kirjeldus |
|---|---|
| **Host** | Kirjutuskaitstud. Valitud agentide arvutid, komadega eraldatud. |
| **Gateway** | Juurutamist juhtiv Edge Gateway komponent. Pakutakse ainult **salvestamisega** Edge Gateway komponente. |
| **Domain** | Kaugseansi avamiseks kasutatava konto domeen. |
| **Username** | Konto, millel on õigus arvutisse tarkvara installida. |
| **Password** | Vastav parool (maskitud). |
| **Target drive** | Installikoha draivi täht. Vaikeväärtus: `c`. |
| **Target directory** | Tee selles draivis. Vaikeväärtus: `Program Files (x86)\Systancia\ACMAgent`. Kuni 1024 märki. |

Esitamisel lukustub tabel teatega **Deployment in progress...**.

| Tulemus | Tagasiside |
|---|---|
| Üks agent | Üks teade: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** või loa puudumise tõttu tagasilükkamine. |
| Mitu agenti | Aken **Agent deployment log**, kus on üks rida agendi kohta kujul `name (host)` olekuga **Success**, **Failure** või **Agent already present**. |

## Remove Agent

Valige üks või mitu agenti ja klõpsake seejärel **Remove Agent**. Vormil kuvatakse väljad **Host**, **Gateway**, **Domain**, **Username** ja **Password** — kahte installimisele omast välja ei küsita. Tabelis kuvatakse **Deletion in progress...**, seejärel esitatakse tulemus samal viisil: teade (**The agent is not present on the server.** või **The agent is in use and can not be deleted.**) ühe agendi puhul, mitme agendi puhul aga aken **Agent removal log**, kus olek **Agent not present** asendab olekut **Agent already present**.

> **Kirje jääb deklareerituks**
>
> Teenuse eemaldamine ei eemalda agenti loendist: kirje jääb alles ja seda saab kasutada uueks juurutamiseks. Selle kustutamiseks kasutage nuppu **×** (peatükk [Agendi kustutamine](#delete-an-agent)).

## Download configuration

Valige **täpselt üks** agent ja klõpsake seejärel **Download configuration**. Aken küsib ainult välju **Host** (kirjutuskaitstud) ja **Gateway**. Esitamisel laadib brauser alla arhiivi `<agent name>.zip`, mis sisaldab järgmist:

| Fail | Sisu |
|---|---|
| `<agent name>.p12` | Agendi kliendisertifikaat, mis genereeritakse nõudmisel. |
| `ca.crt` | ACM-teenust allkirjastava sertifitseerimisasutuse sertifikaat. |
| `configuration.xml` | Kliendisertifikaadi tee ja valitud Edge Gateway komponendi avaldatud ACM-teenuse `fqdn:port`-aadressid. |
| `readme.txt` | Kolm arvutis tehtavat toimingut. |

See režiim on mõeldud agendi **käsitsi** juurutamiseks, kui kauginstallimine pole võimalik. Fail `readme.txt` kirjeldab toimingut: importige `ca.crt` usaldusväärsete juursertifitseerimisasutuste salve **kohalikus arvutis**, kopeerige failid agendi installikausta ja taaskäivitage seejärel teenus **Cleanroom Credentials Manager**.

> **Genereerimise nurjumine**
>
> Kui arhiivi ei saa luua, kuvatakse teade **An error occured while generating configuration**. Edge Gateway komponent peab olema **võrgus**: just Edge Gateway komponent annab ACM-teenuse pordi.
