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

# ACM agents

Moduuli **ACM agents** ilmoittaa etäkoneille käyttöön otetut ACM-agentit ja ohjaa niitä. ACM-agentti toimii koneella Windows-palveluna ja tavoittaa ACM-palvelun, jonka julkaisee Bastion Edge Gateway -palvelinta saadakseen salasanat, joita paikalliset sovellukset tarvitsevat. Järjestelmänvalvoja käyttää agenttitietueen luomiseen, palvelun etäkäyttöönottoon tai sen poistamiseen etänä sekä sen määritysmateriaalin luomiseen, joka koneelle upotetaan.

> **ACM:n saatavuus**
>
> Näyttö **ACM** ja sen viisi moduulia näkyvät konsolissa vain, kun ACM on sallittu: sekä ACM:n kattava **lisenssi** että organisaatiolle valittu asetus **Allow ACM usage** järjestelmäkonsolissa vaaditaan. Jos jompikumpi puuttuu, näyttö pysyy piilossa ja jokainen ACM-toiminto hylätään.

## Agenttien luettelo

| Sarake | Kuvaus |
|---|---|
| **Name** | Agentin yksilöivä tunniste. |
| **Description** | Vapaa teksti. |
| **Host** | Sen koneen nimi, jolle agentti on otettu (tai otetaan) käyttöön. |

Työkalurivin hakukenttä suodattaa näiden kolmen arvon perusteella yhtä aikaa. Niin kauan kuin agentteja ei ole, taulukossa näkyy **No agents**.

### Työkalupalkin toiminnot

Olemassa olevaan agenttiin vaikuttavat toiminnot pysyvät poissa käytöstä, kunnes valinta sallii ne.

| Toiminto | Saatavuus | Vaikutus |
|---|---|---|
| **+** — työkaluvihje **Add** | Aina | Avaa luontilomakkeen (katso luku [Agentin lisääminen](#add-an-agent)). |
| Muokkauskuvake — työkaluvihje **Properties** | Valinta = 1 | Avaa saman lomakkeen valmiiksi täytettynä. |
| **×** — työkaluvihje **Delete** | Valinta ≥ 1 | Pyytää vahvistusta (katso luku [Agentin poistaminen](#delete-an-agent)). |
| **Deploy Agent** | Valinta ≥ 1 | Asentaa palvelun valittujen agenttien koneille (katso luku [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Valinta ≥ 1 | Poistaa palvelun asennuksen etäyhteydellä (katso luku [Remove Agent](#remove-agent)). |
| **Download configuration** | Valinta = 1 | Tuottaa agentin määritysarkiston (katso luku [Download configuration](#download-configuration)). |

Rivin kaksoisnapsautus vastaa toimintoa **Properties**.

## Agentin lisääminen

Napsauta **+**. Ikkuna **Add ACM agent** avautuu. Kaikki kentät ovat pakollisia paitsi kuvaus.

| Kenttä | Kuvaus |
|---|---|
| **Name** | Yksilöllinen. Enintään 1024 merkkiä. |
| **Description** | Valinnainen. Enintään 256 merkkiä. |
| **Host** | Kohdekoneen nimi. Enintään 1024 merkkiä. |

Napsauta **Validate**. Agentin määrittely **ei ota mitään käyttöön**: se vain tallentaa merkinnän.

> **Nimi on jo käytössä**
>
> Jos nimi on jo olemassa, palvelin hylkää lisäyksen ja antaa viestin **An ACM agent already has this name.**

## Agentin muokkaaminen

Valitse rivi ja napsauta kuvaketta **Properties** (tai kaksoisnapsauta). Ikkuna **Edit ACM agent** näyttää samat kentät.

## Agentin poistaminen

Valitse yksi tai useampi rivi ja napsauta **×**. Vahvistusta pyydetään.

> **ACM-sopimuksen käyttämä agentti**
>
> Agenttia, joka esiintyy **ACM contract** -sopimuksessa, ei voi poistaa. Toimintoa ei peruuteta kokonaan: käyttämättömät agentit **poistetaan**, ja virheilmoitus luettelee **säilytetyt agentit** — ”The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” ja sen jälkeen niiden nimet. Jos haluat poistaa ne, irrota ne ensin näistä sopimuksista.

## Deploy Agent

Valitse yksi tai useampi agentti ja napsauta **Deploy Agent**. Samanniminen ikkuna pyytää käyttöönoton parametreja. Kaikki kentät ovat pakollisia.

| Kenttä | Kuvaus |
|---|---|
| **Host** | Vain luku. Valittujen agenttien koneet pilkuilla erotettuina. |
| **Gateway** | Käyttöönottoa ohjaava Edge Gateway -palvelin. Tarjolla ovat vain Edge Gateway -palvelimet, joissa on **tallennus**. |
| **Domain** | Sen tilin toimialue, jolla etäistunto avataan. |
| **Username** | Tili, jolla on oikeus asentaa ohjelmistoja koneelle. |
| **Password** | Vastaava salasana (peitettynä). |
| **Target drive** | Asennusaseman kirjain. Oletusarvo: `c`. |
| **Target directory** | Polku kyseisellä asemalla. Oletusarvo: `Program Files (x86)\Systancia\ACMAgent`. Enintään 1024 merkkiä. |

Lähetettäessä taulukko lukittuu viestiin **Deployment in progress...**.

| Tulos | Palaute |
|---|---|
| Yksi agentti | Yksi viesti: **Agent deployment succeeded**, **Deployment failed**, **Agent already present**, tai hylkäys puuttuvan käyttöoikeuden vuoksi. |
| Useita agentteja | Ikkuna **Agent deployment log**, jossa on yksi rivi agenttia kohden muodossa `name (host)` ja tila **Success**, **Failure** tai **Agent already present**. |

## Remove Agent

Valitse yksi tai useampi agentti ja napsauta **Remove Agent**. Lomake näyttää kentät **Host**, **Gateway**, **Domain**, **Username** ja **Password** — kahta asennukseen liittyvää kenttää ei pyydetä. Taulukko näyttää **Deletion in progress...**, ja tulos esitetään samalla tavalla: viesti (**The agent is not present on the server.** tai **The agent is in use and can not be deleted.**) yhdelle agentille, ja sitä laajemmin ikkuna **Agent removal log**, jossa tila **Agent not present** korvaa tilan **Agent already present**.

> **Merkintä säilyy määriteltynä**
>
> Palvelun poistaminen ei poista agenttia luettelosta: merkintä säilyy ja voi palvella uutta käyttöönottoa. Jos haluat pyyhkiä sen, käytä **×** (luku [Agentin poistaminen](#delete-an-agent)).

## Download configuration

Valitse **tarkalleen yksi** agentti ja napsauta **Download configuration**. Ikkuna pyytää vain kentät **Host** (vain luku) ja **Gateway**. Lähetettäessä selain lataa arkiston `<agent name>.zip`, joka sisältää:

| Tiedosto | Sisältö |
|---|---|
| `<agent name>.p12` | Agentin asiakassertifikaatti, luodaan pyynnöstä. |
| `ca.crt` | ACM-palvelun allekirjoittavan varmentajan sertifikaatti. |
| `configuration.xml` | Asiakassertifikaatin polku ja valitun Edge Gateway -palvelimen julkaiseman ACM-palvelun `fqdn:port`-osoitteet. |
| `readme.txt` | Kolme koneella suoritettavaa toimenpidettä. |

Tämä tila palvelee agentin **manuaalista** käyttöönottoa, kun etäasennus ei ole mahdollista. Tiedosto `readme.txt` kertoo menettelyn: tuo `ca.crt` luotettujen juurivarmentajien säilöön **paikallisella tietokoneella**, kopioi tiedostot agentin asennuskansioon, ja käynnistä sitten palvelu **Cleanroom Credentials Manager** uudelleen.

> **Luonti epäonnistui**
>
> Jos arkistoa ei voida tuottaa, näytetään viesti **An error occured while generating configuration**. Edge Gateway -palvelimen on oltava **online**: Edge Gateway -palvelin tarjoaa ACM-palvelun portin.
