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

# ACM agents

Az **ACM agents** modul a távoli számítógépeken üzembe helyezett ACM-ügynökök deklarálására és vezérlésére szolgál. Az ACM-ügynök Windows-szolgáltatásként fut a számítógépen, és ahhoz az ACM-szolgáltatáshoz csatlakozik, amelyet egy Bastion Edge Gateway komponens tesz közzé; így szerzi be a helyi alkalmazások által igényelt jelszavakat. A rendszergazda ezzel a modullal hozza létre az ügynökrekordot, telepíti vagy távolítja el távolról a szolgáltatást, és állítja elő a számítógépre beágyazandó konfigurációs anyagot.

> **Az ACM elérhetősége**
>
> Az **ACM** képernyő és annak öt modulja csak akkor jelenik meg a konzolon, ha az ACM megengedett: az ACM-et lefedő **licencre**, és a rendszerkonzolban a szervezethez bejelölt **Allow ACM usage** beállításra is szükség van. Ha bármelyik hiányzik, a képernyő rejtve marad, és a rendszer minden ACM-műveletet elutasít.

## Ügynökök listája

| Oszlop | Leírás |
|---|---|
| **Name** | Egyedi ügynökazonosító. |
| **Description** | Szabad szöveg. |
| **Host** | Annak a számítógépnek a neve, amelyen az ügynök üzembe van helyezve (vagy üzembe lesz helyezve). |

Az eszköztár keresőmezője egyszerre e három érték alapján szűr. Amíg egyetlen ügynök sem létezik, a táblázatban a **No agents** felirat látható.

### Az eszköztár műveletei

A meglévő ügynökön végrehajtható műveletek mindaddig letiltva maradnak, amíg a kijelölés lehetővé nem teszi őket.

| Művelet | Elérhetőség | Hatás |
|---|---|---|
| **+** – elemleírás: **Add** | Mindig | Megnyitja a létrehozási űrlapot (lásd az [Ügynök hozzáadása](#add-an-agent) fejezetet). |
| Szerkesztési ikon – elemleírás: **Properties** | Kijelölés = 1 | Megnyitja ugyanazt az űrlapot, előre kitöltve. |
| **×** – elemleírás: **Delete** | Kijelölés ≥ 1 | Megerősítést kér (lásd az [Ügynök törlése](#delete-an-agent) fejezetet). |
| **Deploy Agent** | Kijelölés ≥ 1 | Telepíti a szolgáltatást a kijelölt ügynökök számítógépeire (lásd a [Deploy Agent](#deploy-agent) fejezetet). |
| **Remove Agent** | Kijelölés ≥ 1 | Távolról eltávolítja a szolgáltatást (lásd a [Remove Agent](#remove-agent) fejezetet). |
| **Download configuration** | Kijelölés = 1 | Előállítja az ügynök konfigurációs archívumát (lásd a [Download configuration](#download-configuration) fejezetet). |

Egy sorra való dupla kattintás egyenértékű a **Properties** ikonnal.

## Ügynök hozzáadása

Kattintson a **+** gombra. Megnyílik az **Add ACM agent** ablak. A leírás kivételével minden mező kötelező.

| Mező | Leírás |
|---|---|
| **Name** | Egyedi. Legfeljebb 1024 karakter. |
| **Description** | Nem kötelező. Legfeljebb 256 karakter. |
| **Host** | A célszámítógép neve. Legfeljebb 1024 karakter. |

Kattintson a **Validate** gombra. Egy ügynök deklarálása **semmit sem helyez üzembe**: csupán rögzíti a bejegyzést.

> **A név már foglalt**
>
> Ha a név már létezik, a kiszolgáló a következő üzenettel utasítja el a hozzáadást: **An ACM agent already has this name.**

## Ügynök módosítása

Jelöljön ki egy sort, majd kattintson a **Properties** ikonra (vagy kattintson duplán). Az **Edit ACM agent** ablak ugyanazokat a mezőket jeleníti meg.

## Ügynök törlése

Jelöljön ki egy vagy több sort, majd kattintson a **×** gombra. A rendszer megerősítést kér.

> **ACM-szerződés által használt ügynök**
>
> Ha egy ügynök szerepel egy **ACM contract** szerződésben, nem törölhető. A művelet azonban nem szakad meg teljesen: a nem használt ügynökök **törlődnek**, egy hibaüzenet pedig felsorolja a **megtartott ügynököket**: a „The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” szöveget a nevük követi. A törlésükhöz először távolítsa el őket ezekből a szerződésekből.

## Deploy Agent

Jelöljön ki egy vagy több ügynököt, majd kattintson a **Deploy Agent** gombra. Az azonos nevű ablak bekéri az üzembe helyezési paramétereket. Minden mező kötelező.

| Mező | Leírás |
|---|---|
| **Host** | Csak olvasható. A kijelölt ügynökök számítógépei, vesszővel elválasztva. |
| **Gateway** | Az üzembe helyezést vezérlő Edge Gateway komponens. Csak a **rögzítéssel rendelkező** Edge Gateway komponensek választhatók. |
| **Domain** | A távoli munkamenet megnyitásához használt fiók tartománya. |
| **Username** | Olyan fiók, amely szoftvert telepíthet a számítógépre. |
| **Password** | A hozzá tartozó jelszó (maszkolva). |
| **Target drive** | A telepítési meghajtó betűjele. Alapértelmezett érték: `c`. |
| **Target directory** | Elérési út az adott meghajtón. Alapértelmezett érték: `Program Files (x86)\Systancia\ACMAgent`. Legfeljebb 1024 karakter. |

Elküldéskor a táblázat zárolódik, és a **Deployment in progress...** üzenet jelenik meg.

| Eredmény | Visszajelzés |
|---|---|
| Egyetlen ügynök | Egy üzenet: **Agent deployment succeeded**, **Deployment failed**, **Agent already present** vagy az engedély hiánya miatti elutasítás. |
| Több ügynök | Az **Agent deployment log** ablak, ügynökönként egy `name (host)` formátumú sorral, **Success**, **Failure** vagy **Agent already present** állapottal. |

## Remove Agent

Jelöljön ki egy vagy több ügynököt, majd kattintson a **Remove Agent** gombra. Az űrlapon a **Host**, a **Gateway**, a **Domain**, a **Username** és a **Password** mező látható – a két telepítésspecifikus mezőt nem kéri a rendszer. A táblázatban a **Deletion in progress...** üzenet jelenik meg, majd az eredmény ugyanúgy látható: egyetlen ügynök esetén egy üzenet (**The agent is not present on the server.** vagy **The agent is in use and can not be deleted.**), több ügynök esetén az **Agent removal log** ablak, amelyben az **Agent not present** állapot lép az **Agent already present** helyébe.

> **A rekord deklarálva marad**
>
> A szolgáltatás eltávolítása nem távolítja el az ügynököt a listából: a rekord megmarad, és felhasználható egy újabb üzembe helyezéshez. Törléséhez használja a **×** gombot ([Ügynök törlése](#delete-an-agent) fejezet).

## Download configuration

Jelöljön ki **pontosan egy** ügynököt, majd kattintson a **Download configuration** gombra. Az ablak csak a **Host** (csak olvasható) és a **Gateway** mezőt kéri. Elküldéskor a böngésző letölt egy `<agent name>.zip` archívumot, amely a következőket tartalmazza:

| Fájl | Tartalom |
|---|---|
| `<agent name>.p12` | Az ügynök ügyféltanúsítványa, igény szerint előállítva. |
| `ca.crt` | Az ACM-szolgáltatást aláíró hitelesítésszolgáltató tanúsítványa. |
| `configuration.xml` | Az ügyféltanúsítvány elérési útja és a kiválasztott Edge Gateway komponens által közzétett ACM-szolgáltatás `fqdn:port` címei. |
| `readme.txt` | A számítógépen elvégzendő három művelet. |

Ez a mód az ügynök **manuális** üzembe helyezésére szolgál, ha a távoli telepítés nem lehetséges. A `readme.txt` fájl ismerteti az eljárást: importálja a `ca.crt` fájlt **a helyi számítógép** megbízható legfelső szintű hitelesítésszolgáltatói közé, másolja a fájlokat az ügynök telepítési mappájába, majd indítsa újra a **Cleanroom Credentials Manager** szolgáltatást.

> **Sikertelen előállítás**
>
> Ha az archívum nem állítható elő, az **An error occured while generating configuration** üzenet jelenik meg. Az Edge Gateway komponensnek **online** állapotban kell lennie: ez a komponens biztosítja az ACM-szolgáltatás portját.
