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

# ACM agents

Modulyje **ACM agents** deklaruojami ir valdomi nuotoliniuose kompiuteriuose įdiegti ACM agentai. ACM agentas kompiuteryje veikia kaip Windows tarnyba ir kreipiasi į ACM paslaugą, kurią publikuoja Bastion Edge Gateway, kad gautų vietinėms taikomosioms programoms reikalingus slaptažodžius. Administratorius jį naudoja, kad sukurtų agento įrašą, nuotoliniu būdu įdiegtų ar pašalintų tarnybą ir sugeneruotų konfigūracijos medžiagą, kurią reikia patalpinti kompiuteryje.

> **ACM prieinamumas**
>
> Ekranas **ACM** ir jo penki moduliai konsolėje rodomi tik tada, kai ACM leidžiamas: reikia ir ACM apimančios **licencijos**, ir sistemos konsolėje organizacijai pažymėtos parinkties **Allow ACM usage**. Jei trūksta bent vieno iš jų, ekranas paslepiamas ir visos ACM operacijos atmetamos.

## Agentų sąrašas

| Stulpelis | Aprašas |
|---|---|
| **Name** | Unikalus agento identifikatorius. |
| **Description** | Laisvas tekstas. |
| **Host** | Kompiuterio, kuriame agentas įdiegtas (arba turi būti įdiegtas), pavadinimas. |

Įrankių juostos paieškos laukas filtruoja pagal šias tris reikšmes vienu metu. Kol nėra nė vieno agento, lentelėje rodoma **No agents**.

### Įrankių juostos veiksmai

Su esamu agentu atliekami veiksmai lieka išjungti, kol pasirinkimas jų neleidžia.

| Veiksmas | Prieinamumas | Poveikis |
|---|---|---|
| **+** — patarimas **Add** | Visada | Atidaro kūrimo formą (žr. skyrių [Agento pridėjimas](#add-an-agent)). |
| Redagavimo piktograma — patarimas **Properties** | Pasirinkimas = 1 | Atidaro tą pačią, iš anksto užpildytą formą. |
| **×** — patarimas **Delete** | Pasirinkimas ≥ 1 | Prašo patvirtinimo (žr. skyrių [Agento naikinimas](#delete-an-agent)). |
| **Deploy Agent** | Pasirinkimas ≥ 1 | Įdiegia tarnybą pasirinktų agentų kompiuteriuose (žr. skyrių [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Pasirinkimas ≥ 1 | Nuotoliniu būdu pašalina tarnybą (žr. skyrių [Remove Agent](#remove-agent)). |
| **Download configuration** | Pasirinkimas = 1 | Sukuria agento konfigūracijos archyvą (žr. skyrių [Download configuration](#download-configuration)). |

Dukart spustelėjus eilutę, veikiama taip pat kaip spustelėjus **Properties**.

## Agento pridėjimas

Spustelėkite **+**. Atidaromas langas **Add ACM agent**. Visi laukai privalomi, išskyrus aprašą.

| Laukas | Aprašas |
|---|---|
| **Name** | Unikalus. Iki 1024 simbolių. |
| **Description** | Pasirinktinai. Iki 256 simbolių. |
| **Host** | Tikslinio kompiuterio pavadinimas. Iki 1024 simbolių. |

Spustelėkite **Validate**. Deklaravus agentą, **niekas neįdiegiama**: tik užregistruojamas įrašas.

> **Pavadinimas jau naudojamas**
>
> Jei pavadinimas jau egzistuoja, serveris atsisako pridėti ir pateikia pranešimą **An ACM agent already has this name.**

## Agento redagavimas

Pasirinkite eilutę, tada spustelėkite piktogramą **Properties** (arba dukart spustelėkite). Lange **Edit ACM agent** rodomi tie patys laukai.

## Agento naikinimas

Pasirinkite vieną ar kelias eilutes, tada spustelėkite **×**. Prašoma patvirtinimo.

> **ACM sutartyje naudojamas agentas**
>
> Agento, nurodyto **ACM contract**, panaikinti negalima. Operacija nėra atšaukiama visiškai: nenaudojami agentai **panaikinami**, o klaidos pranešime išvardijami **išsaugoti agentai** — „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“, po kurio pateikiami jų pavadinimai. Norėdami juos panaikinti, pirmiausia pašalinkite juos iš tų sutarčių.

## Deploy Agent

Pasirinkite vieną ar kelis agentus, tada spustelėkite **Deploy Agent**. Tokio pat pavadinimo lange prašoma nurodyti diegimo parametrus. Visi laukai privalomi.

| Laukas | Aprašas |
|---|---|
| **Host** | Tik skaitomas. Pasirinktų agentų kompiuteriai, atskirti kableliais. |
| **Gateway** | Diegimą valdantis Edge Gateway. Siūlomi tik Edge Gateway **su įrašymu**. |
| **Domain** | Paskyros, naudojamos nuotoliniam seansui atidaryti, domenas. |
| **Username** | Paskyra, kuriai leidžiama diegti programinę įrangą kompiuteryje. |
| **Password** | Atitinkamas slaptažodis (paslėptas). |
| **Target drive** | Diegimo disko raidė. Numatytoji reikšmė: `c`. |
| **Target directory** | Kelias tame diske. Numatytoji reikšmė: `Program Files (x86)\Systancia\ACMAgent`. Iki 1024 simbolių. |

Pateikus formą, lentelė užrakinama su pranešimu **Deployment in progress...**.

| Rezultatas | Grįžtamasis ryšys |
|---|---|
| Vienas agentas | Vienas pranešimas: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** arba atsisakymas dėl leidimo trūkumo. |
| Keli agentai | Langas **Agent deployment log**, po vieną eilutę kiekvienam agentui formatu `name (host)`, su būsena **Success**, **Failure** arba **Agent already present**. |

## Remove Agent

Pasirinkite vieną ar kelis agentus, tada spustelėkite **Remove Agent**. Formoje rodomi laukai **Host**, **Gateway**, **Domain**, **Username** ir **Password** — du tik diegimui skirti laukai neprašomi. Lentelėje rodoma **Deletion in progress...**, tada rezultatas pateikiamas taip pat: vienam agentui – pranešimas (**The agent is not present on the server.** arba **The agent is in use and can not be deleted.**), o keliems agentams – langas **Agent removal log**, kuriame būsena **Agent not present** pakeičia **Agent already present**.

> **Įrašas lieka deklaruotas**
>
> Pašalinus tarnybą, agentas iš sąrašo nepašalinamas: įrašas lieka ir gali būti panaudotas naujam diegimui. Norėdami jį panaikinti, naudokite **×** (skyrius [Agento naikinimas](#delete-an-agent)).

## Download configuration

Pasirinkite **lygiai vieną** agentą, tada spustelėkite **Download configuration**. Lange prašoma nurodyti tik **Host** (tik skaitomas) ir **Gateway**. Pateikus formą, naršyklė atsisiunčia archyvą `<agent name>.zip`, kuriame yra:

| Failas | Turinys |
|---|---|
| `<agent name>.p12` | Agento kliento sertifikatas, sugeneruojamas pagal pareikalavimą. |
| `ca.crt` | ACM paslaugą pasirašančios sertifikavimo institucijos sertifikatas. |
| `configuration.xml` | Kliento sertifikato kelias ir pasirinkto Edge Gateway publikuojamos ACM paslaugos `fqdn:port` adresai. |
| `readme.txt` | Trys operacijos, kurias reikia atlikti kompiuteryje. |

Šis režimas skirtas **rankiniam** agento diegimui, kai nuotolinis diegimas neįmanomas. Faile `readme.txt` aprašyta procedūra: importuokite `ca.crt` į patikimas šakninės sertifikavimo institucijas **vietiniame kompiuteryje**, nukopijuokite failus į agento diegimo aplanką, tada iš naujo paleiskite tarnybą **Cleanroom Credentials Manager**.

> **Generavimo klaida**
>
> Jei archyvo sukurti nepavyksta, rodomas pranešimas **An error occured while generating configuration**. Edge Gateway turi būti **prisijungęs**: būtent Edge Gateway suteikia ACM paslaugos prievadą.
