ACM agents¶

Modulen ACM agents deklarerar och styr de ACM-agenter som rullats ut på fjärrmaskiner. En ACM-agent körs som en Windows-tjänst på maskinen och når den ACM-tjänst som publiceras av en Edge Gateway från CyberElements för att hämta de lösenord som de lokala applikationerna behöver. En administratör använder den för att skapa en agentpost, rulla ut eller ta bort tjänsten på distans och generera det konfigurationsmaterial som ska bäddas in på maskinen.

Tillgänglighet för ACM

Skärmen ACM och dess fem moduler visas i konsolen endast när ACM är tillåtet: både en licens som täcker ACM och alternativet Allow ACM usage aktiverat för din tenant krävs. Om något av dem saknas är skärmen dold och varje ACM-åtgärd avvisas.

Lista över agenter¶

Kolumn	Beskrivning
Name	Unik identifierare för agenten.
Description	Fri text.
Host	Namn på maskinen där agenten är (eller ska bli) utrullad.

Sökfältet i verktygsraden filtrerar på dessa tre värden samtidigt. Så länge ingen agent finns, visar tabellen No agents.

Åtgärder i verktygsfältet¶

Åtgärder som verkar på en befintlig agent förblir inaktiverade tills urvalet tillåter dem.

Åtgärd	Tillgänglighet	Effekt
+ — verktygstips Add	Alltid	Öppnar formuläret för att skapa (se kapitlet Lägg till en agent).
Ändringsikon — verktygstips Properties	Urval = 1	Öppnar samma formulär, förifyllt.
× — verktygstips Delete	Urval ≥ 1	Begär en bekräftelse (se kapitlet Ta bort en agent).
Deploy Agent	Urval ≥ 1	Installerar tjänsten på maskinerna för de valda agenterna (se kapitlet Deploy Agent).
Remove Agent	Urval ≥ 1	Avinstallerar tjänsten på distans (se kapitlet Remove Agent).
Download configuration	Urval = 1	Skapar konfigurationsarkivet för agenten (se kapitlet Download configuration).

Att dubbelklicka på en rad motsvarar Properties.

Lägg till en agent¶

Klicka på +. Fönstret Add ACM agent öppnas. Alla fält är obligatoriska utom beskrivningen.

Fält	Beskrivning
Name	Unikt. Upp till 1024 tecken.
Description	Valfritt. Upp till 256 tecken.
Host	Namn på målmaskinen. Upp till 1024 tecken.

Klicka på Validate. Att deklarera en agent rullar inte ut något: den registrerar bara posten.

Namnet används redan

Om namnet redan finns nekar servern tillägget med meddelandet An ACM agent already has this name.

Ändra en agent¶

Välj en rad och klicka sedan på ikonen Properties (eller dubbelklicka). Fönstret Edit ACM agent visar samma fält.

Ta bort en agent¶

Välj en eller flera rader och klicka sedan på ×. En bekräftelse begärs.

Agent som används av ett ACM-kontrakt

En agent som förekommer i ett ACM contract kan inte tas bort. Åtgärden avbryts inte helt och hållet: agenter som inte används tas bort, och ett felmeddelande listar de agenter som behölls — ”The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” följt av deras namn. För att ta bort dem, koppla först bort dem från dessa kontrakt.

Deploy Agent¶

Välj en eller flera agenter och klicka sedan på Deploy Agent. Fönstret med samma namn ber om utrullningsparametrarna. Alla fält är obligatoriska.

Fält	Beskrivning
Host	Skrivskyddat. Maskiner för de valda agenterna, kommaseparerade.
Gateway	Edge Gateway som styr utrullningen. Endast Edge Gateways med inspelning erbjuds.
Domain	Domän för kontot som används för att öppna fjärrsessionen.
Username	Konto som har behörighet att installera programvara på maskinen.
Password	Motsvarande lösenord (maskerat).
Target drive	Bokstav för installationsenheten. Standardvärde: `c`.
Target directory	Sökväg på den enheten. Standardvärde: `Program Files (x86)\Systancia\ACMAgent`. Upp till 1024 tecken.

Vid inskickning låses tabellen med meddelandet Deployment in progress....

Utfall	Återkoppling
En enda agent	Ett meddelande: Agent deployment succeeded, Deployment failed, Agent already present, eller nekandet på grund av bristande behörighet.
Flera agenter	Fönstret Agent deployment log, med en rad per agent i formen `name (host)` och statusen Success, Failure eller Agent already present.

Remove Agent¶

Välj en eller flera agenter och klicka sedan på Remove Agent. Formuläret visar Host, Gateway, Domain, Username och Password — de två fält som är specifika för installationen begärs inte. Tabellen visar Deletion in progress..., och därefter presenteras utfallet på samma sätt: ett meddelande (The agent is not present on the server. eller The agent is in use and can not be deleted.) för en enda agent, och därutöver fönstret Agent removal log, där statusen Agent not present ersätter Agent already present.

Posten förblir deklarerad

Att ta bort tjänsten tar inte bort agenten från listan: posten kvarstår och kan tjäna en ny utrullning. För att radera den, använd × (kapitlet Ta bort en agent).

Download configuration¶

Välj exakt en agent och klicka sedan på Download configuration. Fönstret ber bara om Host (skrivskyddat) och Gateway. Vid inskickning laddar webbläsaren ner ett arkiv <agent name>.zip som innehåller:

Fil	Innehåll
`<agent name>.p12`	Klientcertifikat för agenten, genererat på begäran.
`ca.crt`	Certifikat för den utfärdare som signerar ACM-tjänsten.
`configuration.xml`	Sökväg till klientcertifikatet och adresserna `fqdn:port` för den ACM-tjänst som den valda Edge Gateway publicerar.
`readme.txt`	De tre åtgärder som ska utföras på maskinen.

Detta läge tjänar manuell utrullning av agenten, när fjärrinstallation inte är möjlig. readme.txt anger förfarandet: importera ca.crt till de betrodda rotcertifikatutfärdarna för den lokala datorn, kopiera filerna till agentens installationsmapp, och starta sedan om tjänsten Cleanroom Credentials Manager.

Misslyckad generering

Om arkivet inte kan skapas visas meddelandet An error occured while generating configuration. Edge Gateway måste vara online: det är Edge Gateway som tillhandahåller porten för ACM-tjänsten.