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

# 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 ett Bastion Edge Gateway 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: krävs både en **licens** som täcker ACM och alternativet **Allow ACM usage** markerat för organisationen i systemkonsolen. 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](#add-an-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](#delete-an-agent)). |
| **Deploy Agent** | Urval ≥ 1 | Installerar tjänsten på maskinerna för de valda agenterna (se kapitlet [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Urval ≥ 1 | Avinstallerar tjänsten på distans (se kapitlet [Remove Agent](#remove-agent)). |
| **Download configuration** | Urval = 1 | Skapar konfigurationsarkivet för agenten (se kapitlet [Download configuration](#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](#delete-an-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.
