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

# ACM agents

Modulis **ACM agents** deklarē un vada attālajos datoros izvietotos ACM aģentus. ACM aģents darbojas datorā kā Windows pakalpojums un sasniedz ACM pakalpojumu, ko publicē Bastion Edge Gateway, lai iegūtu paroles, kas nepieciešamas lokālajām lietojumprogrammām. Administrators to izmanto, lai izveidotu aģenta ierakstu, attālināti izvietotu vai noņemtu pakalpojumu un ģenerētu konfigurācijas materiālu, kas jāiegulda datorā.

> **ACM pieejamība**
>
> Ekrāns **ACM** un tā pieci moduļi konsolē tiek parādīti tikai tad, ja ACM ir atļauts: ir nepieciešama gan **licence**, kas ietver ACM, gan sistēmas konsolē organizācijai atzīmēta opcija **Allow ACM usage**. Ja kāda no tām trūkst, ekrāns ir paslēpts un jebkura ACM darbība tiek noraidīta.

## Aģentu saraksts

| Kolonna | Apraksts |
|---|---|
| **Name** | Unikāls aģenta identifikators. |
| **Description** | Brīvs teksts. |
| **Host** | Tā datora nosaukums, kurā aģents ir izvietots (vai tiks izvietots). |

Rīkjoslas meklēšanas lauks filtrē vienlaikus pēc šīm trim vērtībām. Kamēr neviena aģenta nav, tabulā tiek rādīts **No agents**.

### Rīkjoslas darbības

Darbības, kas attiecas uz esošu aģentu, paliek atspējotas, līdz atlase tās atļauj.

| Darbība | Pieejamība | Rezultāts |
|---|---|---|
| **+** — rīka padoms **Add** | Vienmēr | Atver izveides veidlapu (skatiet nodaļu [Aģenta pievienošana](#add-an-agent)). |
| Rediģēšanas ikona — rīka padoms **Properties** | Atlase = 1 | Atver to pašu veidlapu, iepriekš aizpildītu. |
| **×** — rīka padoms **Delete** | Atlase ≥ 1 | Pieprasa apstiprinājumu (skatiet nodaļu [Aģenta dzēšana](#delete-an-agent)). |
| **Deploy Agent** | Atlase ≥ 1 | Instalē pakalpojumu atlasīto aģentu datoros (skatiet nodaļu [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Atlase ≥ 1 | Attālināti atinstalē pakalpojumu (skatiet nodaļu [Remove Agent](#remove-agent)). |
| **Download configuration** | Atlase = 1 | Izveido aģenta konfigurācijas arhīvu (skatiet nodaļu [Download configuration](#download-configuration)). |

Dubultklikšķis uz rindas ir līdzvērtīgs **Properties**.

## Aģenta pievienošana

Noklikšķiniet uz **+**. Tiek atvērts logs **Add ACM agent**. Visi lauki ir obligāti, izņemot aprakstu.

| Lauks | Apraksts |
|---|---|
| **Name** | Unikāls. Līdz 1024 rakstzīmēm. |
| **Description** | Neobligāts. Līdz 256 rakstzīmēm. |
| **Host** | Mērķa datora nosaukums. Līdz 1024 rakstzīmēm. |

Noklikšķiniet uz **Validate**. Aģenta deklarēšana **neko neizvieto**: tā tikai reģistrē ierakstu.

> **Nosaukums jau tiek izmantots**
>
> Ja nosaukums jau eksistē, serveris noraida pievienošanu ar ziņojumu **An ACM agent already has this name.**

## Aģenta rediģēšana

Atlasiet rindu un pēc tam noklikšķiniet uz ikonas **Properties** (vai veiciet dubultklikšķi). Logā **Edit ACM agent** tiek rādīti tie paši lauki.

## Aģenta dzēšana

Atlasiet vienu vai vairākas rindas un pēc tam noklikšķiniet uz **×**. Tiek pieprasīts apstiprinājums.

> **ACM līgumā izmantots aģents**
>
> Aģentu, kas ir iekļauts **ACM contract**, nevar dzēst. Darbība netiek atcelta pilnībā: neizmantotie aģenti **tiek dzēsti**, un kļūdas ziņojumā ir uzskaitīti **saglabātie aģenti** — „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“, kam seko to nosaukumi. Lai tos dzēstu, vispirms noņemiet tos no šiem līgumiem.

## Deploy Agent

Atlasiet vienu vai vairākus aģentus un pēc tam noklikšķiniet uz **Deploy Agent**. Tāda paša nosaukuma logā tiek pieprasīti izvietošanas parametri. Visi lauki ir obligāti.

| Lauks | Apraksts |
|---|---|
| **Host** | Tikai lasāms. Atlasīto aģentu datori, atdalīti ar komatiem. |
| **Gateway** | Komponents Edge Gateway, kas vada izvietošanu. Tiek piedāvāti tikai komponenti Edge Gateway **ar ierakstīšanu**. |
| **Domain** | Tā konta domēns, kas tiek izmantots attālās sesijas atvēršanai. |
| **Username** | Konts, kuram ir atļauts instalēt programmatūru datorā. |
| **Password** | Atbilstošā parole (maskēta). |
| **Target drive** | Instalēšanas diska burts. Noklusējuma vērtība: `c`. |
| **Target directory** | Ceļš šajā diskā. Noklusējuma vērtība: `Program Files (x86)\Systancia\ACMAgent`. Līdz 1024 rakstzīmēm. |

Pēc iesniegšanas tabula tiek bloķēta ar ziņojumu **Deployment in progress...**.

| Iznākums | Atgriezeniskā saite |
|---|---|
| Viens aģents | Viens ziņojums: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** vai atteikums atļaujas trūkuma dēļ. |
| Vairāki aģenti | Logs **Agent deployment log** ar vienu rindu katram aģentam formā `name (host)` un statusu **Success**, **Failure** vai **Agent already present**. |

## Remove Agent

Atlasiet vienu vai vairākus aģentus un pēc tam noklikšķiniet uz **Remove Agent**. Veidlapā tiek rādīti lauki **Host**, **Gateway**, **Domain**, **Username** un **Password** — divi instalēšanai specifiskie lauki netiek pieprasīti. Tabulā tiek rādīts **Deletion in progress...**, pēc tam iznākums tiek parādīts tādā pašā veidā: ziņojums (**The agent is not present on the server.** vai **The agent is in use and can not be deleted.**) viena aģenta gadījumā, bet vairāku aģentu gadījumā — logs **Agent removal log**, kurā statuss **Agent not present** aizstāj **Agent already present**.

> **Ieraksts paliek deklarēts**
>
> Pakalpojuma noņemšana neizņem aģentu no saraksta: ieraksts paliek un var tikt izmantots atkārtotai izvietošanai. Lai to izdzēstu, izmantojiet **×** (nodaļa [Aģenta dzēšana](#delete-an-agent)).

## Download configuration

Atlasiet **tieši vienu** aģentu un pēc tam noklikšķiniet uz **Download configuration**. Logā tiek pieprasīts tikai lauks **Host** (tikai lasāms) un **Gateway**. Pēc iesniegšanas pārlūkprogramma lejupielādē arhīvu `<agent name>.zip`, kurā ir:

| Fails | Saturs |
|---|---|
| `<agent name>.p12` | Aģenta klienta sertifikāts, ģenerēts pēc pieprasījuma. |
| `ca.crt` | Tās sertificēšanas iestādes sertifikāts, kura paraksta ACM pakalpojumu. |
| `configuration.xml` | Klienta sertifikāta ceļš un izvēlētā komponenta Edge Gateway publicētā ACM pakalpojuma `fqdn:port` adreses. |
| `readme.txt` | Trīs darbības, kas jāveic datorā. |

Šis režīms ir paredzēts **manuālai** aģenta izvietošanai, ja attālā instalēšana nav iespējama. Failā `readme.txt` ir aprakstīta procedūra: importēt `ca.crt` uzticamajās saknes sertificēšanas iestādēs **lokālajā datorā**, iekopēt failus aģenta instalēšanas mapē un pēc tam restartēt pakalpojumu **Cleanroom Credentials Manager**.

> **Ģenerēšanas kļūme**
>
> Ja arhīvu nevar izveidot, tiek parādīts ziņojums **An error occured while generating configuration**. Komponentam Edge Gateway ir jābūt **tiešsaistē**: tieši komponents Edge Gateway nodrošina ACM pakalpojuma portu.
