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

# ACM agents

Modul **ACM agents** deklarira in upravlja agente ACM, uvedene na oddaljenih računalnikih. Agent ACM se na računalniku izvaja kot storitev Windows in dostopa do storitve ACM, ki jo objavlja Edge Gateway za Bastion, da pridobi gesla, ki jih potrebujejo lokalne aplikacije. Skrbnik uporablja ustvari zapis agenta, na daljavo uvede ali odstrani storitev in ustvari konfiguracijsko gradivo, ki ga je treba vgraditi v računalnik.

> **Razpoložljivost ACM**
>
> Zaslon **ACM** in njegovih pet modulov se v konzoli prikažejo le, če je ACM dovoljen: sta potrebni tako **licenca**, ki zajema ACM, kot možnost **Allow ACM usage**, označena za organizacijo v sistemski konzoli. Če katera od njiju manjka, je zaslon skrit, vsaka operacija ACM pa je zavrnjena.

## Seznam agentov

| Stolpec | Opis |
|---|---|
| **Name** | Enolični identifikator agenta. |
| **Description** | Prosto besedilo. |
| **Host** | Ime računalnika, na katerem je agent uveden (ali bo uveden). |

Iskalno polje v orodni vrstici filtrira po teh treh vrednostih hkrati. Dokler ne obstaja noben agent, tabela prikazuje **No agents**.

### Dejanja v orodni vrstici

Dejanja, ki delujejo na obstoječem agentu, ostanejo onemogočena, dokler jih izbor ne omogoči.

| Dejanje | Razpoložljivost | Učinek |
|---|---|---|
| **+** – opis orodja **Add** | Vedno | Odpre obrazec za ustvarjanje (glejte poglavje [Dodajanje agenta](#add-an-agent)). |
| Ikona za urejanje – opis orodja **Properties** | Izbor = 1 | Odpre isti obrazec, vnaprej izpolnjen. |
| **×** – opis orodja **Delete** | Izbor ≥ 1 | Zahteva potrditev (glejte poglavje [Brisanje agenta](#delete-an-agent)). |
| **Deploy Agent** | Izbor ≥ 1 | Namesti storitev na računalnike izbranih agentov (glejte poglavje [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Izbor ≥ 1 | Na daljavo odstrani namestitev storitve (glejte poglavje [Remove Agent](#remove-agent)). |
| **Download configuration** | Izbor = 1 | Ustvari arhiv konfiguracije agenta (glejte poglavje [Download configuration](#download-configuration)). |

Dvoklik vrstice je enakovreden ukazu **Properties**.

## Dodajanje agenta

Kliknite **+**. Odpre se okno **Add ACM agent**. Vsa polja so obvezna, razen opisa.

| Polje | Opis |
|---|---|
| **Name** | Enolično. Največ 1024 znakov. |
| **Description** | Izbirno. Največ 256 znakov. |
| **Host** | Ime ciljnega računalnika. Največ 1024 znakov. |

Kliknite **Validate**. Deklaracija agenta **ničesar ne uvede**: le zapiše vnos.

> **Ime je že uporabljeno**
>
> Če ime že obstaja, strežnik zavrne dodajanje s sporočilom **An ACM agent already has this name.**

## Urejanje agenta

Izberite vrstico in nato kliknite ikono **Properties** (ali dvokliknite). Okno **Edit ACM agent** prikaže ista polja.

## Brisanje agenta

Izberite eno ali več vrstic in nato kliknite **×**. Zahtevana je potrditev.

> **Agent, ki ga uporablja pogodba ACM**
>
> Agenta, ki je naveden v **ACM contract**, ni mogoče izbrisati. Operacija ni preklicana v celoti: neuporabljeni agenti **se izbrišejo**, sporočilo o napaki pa navede **ohranjene agente** – „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“, ki mu sledijo njihova imena. Če jih želite izbrisati, jih najprej odstranite iz teh pogodb.

## Deploy Agent

Izberite enega ali več agentov in nato kliknite **Deploy Agent**. Okno z enakim imenom zahteva parametre uvedbe. Vsa polja so obvezna.

| Polje | Opis |
|---|---|
| **Host** | Samo za branje. Računalniki izbranih agentov, ločeni z vejicami. |
| **Gateway** | Strežnik Edge Gateway, ki upravlja uvedbo. Ponujeni so le strežniki Edge Gateway **s snemanjem**. |
| **Domain** | Domena računa, s katerim se odpre oddaljena seja. |
| **Username** | Račun, ki sme nameščati programsko opremo v računalnik. |
| **Password** | Ustrezno geslo (zakrito). |
| **Target drive** | Črka namestitvenega pogona. Privzeta vrednost: `c`. |
| **Target directory** | Pot na tem pogonu. Privzeta vrednost: `Program Files (x86)\Systancia\ACMAgent`. Največ 1024 znakov. |

Po oddaji se tabela zaklene s sporočilom **Deployment in progress...**.

| Izid | Povratna informacija |
|---|---|
| En sam agent | Eno sporočilo: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** ali zavrnitev zaradi pomanjkanja dovoljenj. |
| Več agentov | Okno **Agent deployment log**, po ena vrstica za vsakega agenta v obliki `name (host)`, s stanjem **Success**, **Failure** ali **Agent already present**. |

## Remove Agent

Izberite enega ali več agentov in nato kliknite **Remove Agent**. Obrazec prikaže **Host**, **Gateway**, **Domain**, **Username** in **Password** – dve polji, specifični za namestitev, se ne zahtevata. Tabela prikaže **Deletion in progress...**, nato pa je izid predstavljen na enak način: sporočilo (**The agent is not present on the server.** ali **The agent is in use and can not be deleted.**) za enega agenta, sicer pa okno **Agent removal log**, v katerem stanje **Agent not present** nadomesti **Agent already present**.

> **Zapis ostane deklariran**
>
> Odstranitev storitve ne odstrani agenta s seznama: zapis ostane in ga je mogoče uporabiti za novo uvedbo. Če ga želite izbrisati, uporabite **×** (poglavje [Brisanje agenta](#delete-an-agent)).

## Download configuration

Izberite **natanko enega** agenta in nato kliknite **Download configuration**. Okno zahteva le polji **Host** (samo za branje) in **Gateway**. Po oddaji brskalnik prenese arhiv `<agent name>.zip`, ki vsebuje:

| Datoteka | Vsebina |
|---|---|
| `<agent name>.p12` | Potrdilo odjemalca agenta, ustvarjeno na zahtevo. |
| `ca.crt` | Potrdilo overitelja potrdil, ki podpisuje storitev ACM. |
| `configuration.xml` | Pot do potrdila odjemalca in naslovi `fqdn:port` storitve ACM, ki jo objavlja izbrani strežnik Edge Gateway. |
| `readme.txt` | Tri operacije, ki jih je treba izvesti v računalniku. |

Ta način je namenjen **ročni** uvedbi agenta, kadar oddaljena namestitev ni mogoča. Datoteka `readme.txt` navaja postopek: uvozite `ca.crt` med zaupanja vredne korenske overitelje potrdil **lokalnega računalnika**, kopirajte datoteke v namestitveno mapo agenta, nato znova zaženite storitev **Cleanroom Credentials Manager**.

> **Napaka pri ustvarjanju**
>
> Če arhiva ni mogoče ustvariti, se prikaže sporočilo **An error occured while generating configuration**. Strežnik Edge Gateway mora biti **povezan**: prav ta strežnik Edge Gateway zagotavlja vrata storitve ACM.
