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

# ACM agents

Modul **ACM agents** deklaruje agentov ACM nasadených na vzdialených počítačoch a riadi ich. Agent ACM beží na počítači ako služba systému Windows a pripája sa k službe ACM, ktorú publikuje server Edge Gateway produktu Bastion na získanie hesiel, ktoré potrebujú lokálne aplikácie. Správca používa na vytvorenie položky agenta, vzdialené nasadenie alebo odobratie služby a vygenerovanie konfiguračného materiálu, ktorý sa má vložiť do počítača.

> **Dostupnosť ACM**
>
> Obrazovka **ACM** a jej päť modulov sa v konzole zobrazujú iba vtedy, keď je používanie ACM povolené: je potrebná **licencia** pokrývajúca ACM aj začiarknutá možnosť **Allow ACM usage** pre organizáciu v systémovej konzole. Ak chýba niektorá z týchto dvoch podmienok, obrazovka je skrytá a každá operácia ACM sa zamietne.

## Zoznam agentov

| Stĺpec | Popis |
|---|---|
| **Name** | Jedinečný identifikátor agenta. |
| **Description** | Voľný text. |
| **Host** | Názov počítača, na ktorom je agent nasadený (alebo sa má nasadiť). |

Pole vyhľadávania na paneli s nástrojmi filtruje podľa týchto troch hodnôt naraz. Kým neexistuje žiadny agent, tabuľka zobrazuje **No agents**.

### Akcie panela s nástrojmi

Akcie, ktoré pracujú s existujúcim agentom, zostávajú zakázané, kým to výber neumožní.

| Akcia | Dostupnosť | Účinok |
|---|---|---|
| **+** — popis **Add** | Vždy | Otvorí formulár na vytvorenie (pozrite časť [Pridanie agenta](#add-an-agent)). |
| Ikona úprav — popis **Properties** | Výber = 1 | Otvorí ten istý formulár, vopred vyplnený. |
| **×** — popis **Delete** | Výber ≥ 1 | Vyžiada potvrdenie (pozrite časť [Odstránenie agenta](#delete-an-agent)). |
| **Deploy Agent** | Výber ≥ 1 | Nainštaluje službu na počítače vybraných agentov (pozrite časť [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Výber ≥ 1 | Vzdialene odinštaluje službu (pozrite časť [Remove Agent](#remove-agent)). |
| **Download configuration** | Výber = 1 | Vytvorí archív konfigurácie agenta (pozrite časť [Download configuration](#download-configuration)). |

Dvojité kliknutie na riadok zodpovedá akcii **Properties**.

## Pridanie agenta

Kliknite na **+**. Otvorí sa okno **Add ACM agent**. Všetky polia sú povinné okrem popisu.

| Pole | Popis |
|---|---|
| **Name** | Jedinečný. Najviac 1024 znakov. |
| **Description** | Voliteľný. Najviac 256 znakov. |
| **Host** | Názov cieľového počítača. Najviac 1024 znakov. |

Kliknite na **Validate**. Deklarovanie agenta **nič nenasadí**: iba uloží položku.

> **Názov sa už používa**
>
> Ak názov už existuje, server pridanie zamietne so správou **An ACM agent already has this name.**

## Úprava agenta

Vyberte riadok a potom kliknite na ikonu **Properties** (alebo dvakrát kliknite). Okno **Edit ACM agent** zobrazuje rovnaké polia.

## Odstránenie agenta

Vyberte jeden alebo viac riadkov a potom kliknite na **×**. Vyžaduje sa potvrdenie.

> **Agent používaný zmluvou ACM**
>
> Agenta, ktorý sa nachádza v **ACM contract**, nemožno odstrániť. Operácia sa však nezruší úplne: nepoužívaní agenti **sa odstránia** a chybové hlásenie uvedie **agentov, ktorí boli ponechaní** — „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“ a za ním ich názvy. Ak ich chcete odstrániť, najprv ich odoberte z týchto zmlúv.

## Deploy Agent

Vyberte jedného alebo viacerých agentov a potom kliknite na **Deploy Agent**. Okno s rovnakým názvom si vyžiada parametre nasadenia. Všetky polia sú povinné.

| Pole | Popis |
|---|---|
| **Host** | Iba na čítanie. Počítače vybraných agentov oddelené čiarkami. |
| **Gateway** | Server Edge Gateway, ktorý riadi nasadenie. Ponúkajú sa iba servery Edge Gateway **s nahrávaním**. |
| **Domain** | Doména účtu, ktorý sa používa na otvorenie vzdialenej relácie. |
| **Username** | Účet oprávnený inštalovať softvér na počítači. |
| **Password** | Príslušné heslo (maskované). |
| **Target drive** | Písmeno inštalačnej jednotky. Predvolená hodnota: `c`. |
| **Target directory** | Cesta na tejto jednotke. Predvolená hodnota: `Program Files (x86)\Systancia\ACMAgent`. Najviac 1024 znakov. |

Po odoslaní sa tabuľka zamkne so správou **Deployment in progress...**.

| Výsledok | Spätná väzba |
|---|---|
| Jeden agent | Jedna správa: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** alebo zamietnutie z dôvodu chýbajúceho povolenia. |
| Viacero agentov | Okno **Agent deployment log**, jeden riadok na agenta v tvare `name (host)` so stavom **Success**, **Failure** alebo **Agent already present**. |

## Remove Agent

Vyberte jedného alebo viacerých agentov a potom kliknite na **Remove Agent**. Formulár zobrazuje polia **Host**, **Gateway**, **Domain**, **Username** a **Password** — dve polia špecifické pre inštaláciu sa nevyžadujú. Tabuľka zobrazí **Deletion in progress...** a výsledok sa potom zobrazí rovnakým spôsobom: pri jednom agentovi správa (**The agent is not present on the server.** alebo **The agent is in use and can not be deleted.**), pri viacerých agentoch okno **Agent removal log**, v ktorom stav **Agent not present** nahrádza **Agent already present**.

> **Položka zostáva deklarovaná**
>
> Odobratím služby sa agent zo zoznamu neodstráni: položka zostane a môže poslúžiť na nové nasadenie. Ak ju chcete vymazať, použite **×** (časť [Odstránenie agenta](#delete-an-agent)).

## Download configuration

Vyberte **presne jedného** agenta a potom kliknite na **Download configuration**. Okno si vyžiada iba pole **Host** (iba na čítanie) a **Gateway**. Po odoslaní prehliadač stiahne archív `<agent name>.zip`, ktorý obsahuje:

| Súbor | Obsah |
|---|---|
| `<agent name>.p12` | Klientsky certifikát agenta, generovaný na požiadanie. |
| `ca.crt` | Certifikát certifikačnej autority, ktorá podpisuje službu ACM. |
| `configuration.xml` | Cesta ku klientskemu certifikátu a adresy `fqdn:port` služby ACM publikovanej vybraným serverom Edge Gateway. |
| `readme.txt` | Tri operácie, ktoré treba vykonať na počítači. |

Tento režim slúži na **ručné** nasadenie agenta, keď vzdialená inštalácia nie je možná. Súbor `readme.txt` uvádza postup: importujte `ca.crt` do dôveryhodných koreňových certifikačných autorít **lokálneho počítača**, skopírujte súbory do inštalačného priečinka agenta a potom reštartujte službu **Cleanroom Credentials Manager**.

> **Zlyhanie generovania**
>
> Ak archív nemožno vytvoriť, zobrazí sa správa **An error occured while generating configuration**. Server Edge Gateway musí byť **online**: práve server Edge Gateway poskytuje port služby ACM.
