ACM agents¶

De module ACM agents declareert en beheert de ACM-agenten die op externe machines zijn geïmplementeerd. Een ACM-agent loopt als Windows-service op de machine en bereikt de ACM-service die wordt gepubliceerd door een CyberElements Edge Gateway om de wachtwoorden te verkrijgen die de lokale applicaties nodig hebben. Een beheerder gebruikt hem om een agentrecord aan te maken, de service op afstand te implementeren of te verwijderen, en het configuratiemateriaal te genereren dat op de machine moet worden ingebed.

Beschikbaarheid van ACM

Het scherm ACM en de vijf modules ervan verschijnen alleen in de console wanneer ACM is toegestaan: zowel een licentie die ACM dekt als de optie Allow ACM usage die voor uw tenant is ingeschakeld zijn vereist. Als een van beide ontbreekt, blijft het scherm verborgen en wordt elke ACM-bewerking geweigerd.

Lijst van agenten¶

Kolom	Beschrijving
Name	Unieke identificatie van de agent.
Description	Vrije tekst.
Host	Naam van de machine waarop de agent is (of wordt) geïmplementeerd.

Het zoekveld van de werkbalk filtert gelijktijdig op die drie waarden. Zolang er geen agent bestaat, geeft de tabel No agents weer.

Acties van de werkbalk¶

Acties die op een bestaande agent werken, blijven uitgeschakeld totdat de selectie ze toestaat.

Actie	Beschikbaarheid	Effect
+ — tooltip Add	Altijd	Opent het aanmaakformulier (zie hoofdstuk Een agent toevoegen).
Wijzigingspictogram — tooltip Properties	Selectie = 1	Opent hetzelfde formulier, voorgevuld.
× — tooltip Delete	Selectie ≥ 1	Vraagt om een bevestiging (zie hoofdstuk Een agent verwijderen).
Deploy Agent	Selectie ≥ 1	Installeert de service op de machines van de geselecteerde agenten (zie hoofdstuk Deploy Agent).
Remove Agent	Selectie ≥ 1	Deïnstalleert de service op afstand (zie hoofdstuk Remove Agent).
Download configuration	Selectie = 1	Genereert het configuratiearchief van de agent (zie hoofdstuk Download configuration).

Dubbelklikken op een rij is gelijkwaardig aan Properties.

Een agent toevoegen¶

Klik op +. Het venster Add ACM agent wordt geopend. Alle velden zijn verplicht, behalve de beschrijving.

Veld	Beschrijving
Name	Uniek. Maximaal 1024 tekens.
Description	Optioneel. Maximaal 256 tekens.
Host	Naam van de doelmachine. Maximaal 1024 tekens.

Klik op Validate. Een agent declareren rolt niets uit: het legt alleen de vermelding vast.

Naam al in gebruik

Als de naam al bestaat, weigert de server de toevoeging met de melding An ACM agent already has this name.

Een agent wijzigen¶

Selecteer een rij en klik op het pictogram Properties (of dubbelklik). Het venster Edit ACM agent toont dezelfde velden.

Een agent verwijderen¶

Selecteer een of meer rijen en klik op ×. Er wordt om een bevestiging gevraagd.

Agent die door een ACM-contract wordt gebruikt

Een agent die in een ACM contract voorkomt, kan niet worden verwijderd. De bewerking wordt niet volledig geannuleerd: niet-gebruikte agenten worden verwijderd en een foutmelding somt de behouden agenten op — ”The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” gevolgd door hun namen. Om ze te verwijderen, verwijdert u ze eerst uit die contracten.

Deploy Agent¶

Selecteer een of meer agenten en klik op Deploy Agent. Het venster met dezelfde naam vraagt om de implementatieparameters. Alle velden zijn verplicht.

Veld	Beschrijving
Host	Alleen lezen. Machines van de geselecteerde agenten, gescheiden door komma's.
Gateway	Edge Gateway die de implementatie stuurt. Alleen Edge Gateways met opname worden aangeboden.
Domain	Domein van het account dat wordt gebruikt om de sessie op afstand te openen.
Username	Account dat gemachtigd is om software op de machine te installeren.
Password	Bijbehorend wachtwoord (verborgen).
Target drive	Letter van het installatiestation. Standaardwaarde: `c`.
Target directory	Pad op dat station. Standaardwaarde: `Program Files (x86)\Systancia\ACMAgent`. Maximaal 1024 tekens.

Bij het verzenden wordt de tabel vergrendeld met de melding Deployment in progress....

Uitkomst	Terugkoppeling
Eén enkele agent	Eén melding: Agent deployment succeeded, Deployment failed, Agent already present, of de weigering wegens ontbrekende rechten.
Meerdere agenten	Het venster Agent deployment log, met één rij per agent in de vorm `name (host)`, met de status Success, Failure of Agent already present.

Remove Agent¶

Selecteer een of meer agenten en klik op Remove Agent. Het formulier toont Host, Gateway, Domain, Username en Password — de twee velden die eigen zijn aan de installatie worden niet gevraagd. De tabel toont Deletion in progress..., waarna de uitkomst op dezelfde manier wordt weergegeven: een melding (The agent is not present on the server., of The agent is in use and can not be deleted.) bij één enkele agent, en daarboven het venster Agent removal log, waarin de status Agent not present in de plaats komt van Agent already present.

De vermelding blijft gedeclareerd

De service verwijderen verwijdert de agent niet uit de lijst: de vermelding blijft bestaan en kan voor een nieuwe implementatie dienen. Gebruik × om de vermelding te wissen (hoofdstuk Een agent verwijderen).

Download configuration¶

Selecteer precies één agent en klik op Download configuration. Het venster vraagt alleen om de Host (alleen lezen) en de Gateway. Bij het verzenden downloadt de browser een archief <agent name>.zip met de volgende inhoud:

Bestand	Inhoud
`<agent name>.p12`	Clientcertificaat van de agent, op aanvraag gegenereerd.
`ca.crt`	Certificaat van de autoriteit die de ACM-service ondertekent.
`configuration.xml`	Pad van het clientcertificaat en adressen `fqdn:port` van de ACM-service die door de gekozen Edge Gateway wordt gepubliceerd.
`readme.txt`	De drie bewerkingen die op de machine moeten worden uitgevoerd.

Deze modus dient voor het handmatig implementeren van de agent, wanneer installatie op afstand niet mogelijk is. Het bestand readme.txt beschrijft de procedure: importeer ca.crt in de vertrouwde basiscertificeringsinstanties van de lokale computer, kopieer de bestanden naar de installatiemap van de agent en start daarna de service Cleanroom Credentials Manager opnieuw.

Mislukte generatie

Als het archief niet kan worden gegenereerd, verschijnt de melding An error occured while generating configuration. De Edge Gateway moet online zijn: het is de Edge Gateway die de poort van de ACM-service levert.