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 platformy CyberElements, aby získal hesla, která potřebují místní aplikace. Správce jej 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: vyžaduje se jak licence zahrnující ACM, tak možnost Allow ACM usage povolená pro váš tenant. 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).
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).
Deploy Agent	Výběr ≥ 1	Nainstaluje službu na počítače vybraných agentů (viz kapitola Deploy Agent).
Remove Agent	Výběr ≥ 1	Vzdáleně odinstaluje službu (viz kapitola Remove Agent).
Download configuration	Výběr = 1	Vytvoří archiv konfigurace agenta (viz kapitola 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).

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.