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

# ACM agents

Modul **ACM agents** deklaruje a řídí agenty ACM nasazené na vzdálených počítačích. Agent ACM běží na počítači jako služba systému Windows a připojuje se ke službě ACM, kterou publikuje server Edge Gateway produktu Bastion, aby získal hesla, která potřebují místní aplikace. Správce používá k vytvoření záznamu agenta, ke vzdálenému nasazení nebo odebrání služby a ke generování konfiguračního materiálu, který se má umístit na počítač.

> **Dostupnost ACM**
>
> Obrazovka **ACM** a jejích pět modulů se v konzole zobrazí pouze tehdy, když je používání ACM povoleno: jsou vyžadovány jak **licence** zahrnující ACM, tak možnost **Allow ACM usage** zaškrtnutá pro organizaci v systémové konzole. Pokud jedno z nich chybí, obrazovka je skrytá a každá operace ACM je odmítnuta.

## Seznam agentů

| Sloupec | Popis |
|---|---|
| **Name** | Jedinečný identifikátor agenta. |
| **Description** | Volný text. |
| **Host** | Název počítače, na kterém je agent nasazen (nebo má být nasazen). |

Vyhledávací pole na panelu nástrojů filtruje podle těchto tří hodnot současně. Dokud neexistuje žádný agent, tabulka zobrazuje **No agents**.

### Akce panelu nástrojů

Akce pracující s existujícím agentem zůstávají neaktivní, dokud je výběr nepovolí.

| Akce | Dostupnost | Účinek |
|---|---|---|
| **+** — popis **Add** | Vždy | Otevře formulář pro vytvoření (viz kapitola [Přidání agenta](#add-an-agent)). |
| Ikona úprav — popis **Properties** | Výběr = 1 | Otevře stejný formulář, předvyplněný. |
| **×** — popis **Delete** | Výběr ≥ 1 | Vyžádá si potvrzení (viz kapitola [Odstranění agenta](#delete-an-agent)). |
| **Deploy Agent** | Výběr ≥ 1 | Nainstaluje službu na počítače vybraných agentů (viz kapitola [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Výběr ≥ 1 | Vzdáleně odinstaluje službu (viz kapitola [Remove Agent](#remove-agent)). |
| **Download configuration** | Výběr = 1 | Vytvoří archiv konfigurace agenta (viz kapitola [Download configuration](#download-configuration)). |

Dvojité kliknutí na řádek odpovídá **Properties**.

## Přidání agenta

Klikněte na **+**. Otevře se okno **Add ACM agent**. Všechna pole jsou povinná kromě popisu.

| Pole | Popis |
|---|---|
| **Name** | Jedinečné. Nejvýše 1024 znaků. |
| **Description** | Volitelné. Nejvýše 256 znaků. |
| **Host** | Název cílového počítače. Nejvýše 1024 znaků. |

Klikněte na **Validate**. Deklarace agenta **nic nenasazuje**: pouze zaznamená položku.

> **Název se již používá**
>
> Pokud název již existuje, server přidání odmítne se zprávou **An ACM agent already has this name.**

## Úprava agenta

Vyberte řádek a klikněte na ikonu **Properties** (nebo dvakrát klikněte). Okno **Edit ACM agent** zobrazí stejná pole.

## Odstranění agenta

Vyberte jeden nebo několik řádků a klikněte na **×**. Zobrazí se žádost o potvrzení.

> **Agent používaný smlouvou ACM**
>
> Agenta, který je uveden v **ACM contract**, nelze odstranit. Operace však není zrušena celá: nepoužívaní agenti **jsou odstraněni** a chybová zpráva vypíše **agenty, kteří byli zachováni** — „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:“ a za ní jejich názvy. Chcete-li je odstranit, nejprve je z těchto smluv odeberte.

## Deploy Agent

Vyberte jednoho nebo několik agentů a klikněte na **Deploy Agent**. Stejnojmenné okno si vyžádá parametry nasazení. Všechna pole jsou povinná.

| Pole | Popis |
|---|---|
| **Host** | Pouze pro čtení. Počítače vybraných agentů oddělené čárkami. |
| **Gateway** | Server Edge Gateway, který řídí nasazení. Nabízejí se pouze servery Edge Gateway **s nahráváním**. |
| **Domain** | Doména účtu použitého k otevření vzdálené relace. |
| **Username** | Účet oprávněný instalovat software na počítač. |
| **Password** | Odpovídající heslo (maskované). |
| **Target drive** | Písmeno instalační jednotky. Výchozí hodnota: `c`. |
| **Target directory** | Cesta na této jednotce. Výchozí hodnota: `Program Files (x86)\Systancia\ACMAgent`. Nejvýše 1024 znaků. |

Po odeslání se tabulka zablokuje se zprávou **Deployment in progress...**.

| Výsledek | Zpětná vazba |
|---|---|
| Jediný agent | Jedna zpráva: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** nebo odmítnutí z důvodu oprávnění. |
| Několik agentů | Okno **Agent deployment log**, jeden řádek na agenta ve tvaru `name (host)`, se stavem **Success**, **Failure** nebo **Agent already present**. |

## Remove Agent

Vyberte jednoho nebo několik agentů a klikněte na **Remove Agent**. Formulář zobrazí **Host**, **Gateway**, **Domain**, **Username** a **Password** — dvě pole specifická pro instalaci se nevyžadují. Tabulka zobrazí **Deletion in progress...** a výsledek se poté zobrazí stejným způsobem: zpráva (**The agent is not present on the server.** nebo **The agent is in use and can not be deleted.**) pro jediného agenta, jinak okno **Agent removal log**, ve kterém stav **Agent not present** nahrazuje **Agent already present**.

> **Záznam zůstává deklarovaný**
>
> Odebrání služby neodebere agenta ze seznamu: záznam zůstane a může posloužit pro nové nasazení. Chcete-li ho vymazat, použijte **×** (kapitola [Odstranění agenta](#delete-an-agent)).

## Download configuration

Vyberte **přesně jednoho** agenta a klikněte na **Download configuration**. Okno požaduje pouze pole **Host** (pouze pro čtení) a **Gateway**. Po odeslání prohlížeč stáhne archiv `<agent name>.zip`, který obsahuje:

| Soubor | Obsah |
|---|---|
| `<agent name>.p12` | Klientský certifikát agenta, generovaný na vyžádání. |
| `ca.crt` | Certifikát certifikační autority, která podepisuje službu ACM. |
| `configuration.xml` | Cesta ke klientskému certifikátu a adresy `fqdn:port` služby ACM publikované vybraným serverem Edge Gateway. |
| `readme.txt` | Tři operace, které je třeba provést na počítači. |

Tento režim slouží k **ručnímu** nasazení agenta, když vzdálená instalace není možná. Soubor `readme.txt` popisuje postup: importujte `ca.crt` do důvěryhodných kořenových certifikačních autorit **místního počítače**, zkopírujte soubory do instalační složky agenta a poté restartujte službu **Cleanroom Credentials Manager**.

> **Selhání generování**
>
> Pokud archiv nelze vytvořit, zobrazí se zpráva **An error occured while generating configuration**. Server Edge Gateway musí být **online**: právě server Edge Gateway poskytuje port služby ACM.
