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

# ACM agents

Fógraíonn agus stiúrann an modúl **ACM agents** na gníomhairí ACM atá imscartha ar ríomhairí cianda. Ritheann gníomhaire ACM mar sheirbhís Windows ar an ríomhaire agus sroicheann sé an tseirbhís ACM a fhoilsíonn comhpháirt Edge Gateway de chuid Bastion chun na pasfhocail a theastaíonn ó na feidhmchláir áitiúla a fháil. Úsáideann riarthóir an modúl chun taifead gníomhaire a chruthú, chun an tseirbhís a imscaradh nó a bhaint go cianda, agus chun an t-ábhar cumraíochta atá le leabú ar an ríomhaire a ghiniúint.

> **Infhaighteacht ACM**
>
> Ní thaispeántar an scáileán **ACM** agus a chúig mhodúl sa chonsól ach nuair atá ACM ceadaithe: tá gá le **ceadúnas** a chumhdaíonn ACM agus leis an rogha **Allow ACM usage** a bheith ticeáilte don eagraíocht sa chonsól córais. Má tá ceachtar acu in easnamh, bíonn an scáileán folaithe agus diúltaítear do gach oibríocht ACM.

## Liosta na ngníomhairí

| Colún | Cur síos |
|---|---|
| **Name** | Aitheantóir uathúil an ghníomhaire. |
| **Description** | Téacs saor. |
| **Host** | Ainm an ríomhaire ar a bhfuil an gníomhaire imscartha (nó ar a mbeidh sé imscartha). |

Scagann réimse cuardaigh an bharra uirlisí ar na trí luach sin ag an am céanna. Fad nach bhfuil aon ghníomhaire ann, taispeánann an ghreille **No agents**.

### Gníomhartha an bharra uirlisí

Fanann na gníomhartha a oibríonn ar ghníomhaire atá ann díchumasaithe go dtí go gceadaíonn an roghnúchán iad.

| Gníomh | Infhaighteacht | Éifeacht |
|---|---|---|
| **+** — leid uirlise **Add** | I gcónaí | Osclaíonn sé an fhoirm chruthaithe (féach an chaibidil [Gníomhaire a chur leis](#add-an-agent)). |
| Deilbhín eagarthóireachta — leid uirlise **Properties** | Roghnúchán = 1 | Osclaíonn sé an fhoirm chéanna, réamhlíonta. |
| **×** — leid uirlise **Delete** | Roghnúchán ≥ 1 | Iarrann sé daingniú (féach an chaibidil [Gníomhaire a scriosadh](#delete-an-agent)). |
| **Deploy Agent** | Roghnúchán ≥ 1 | Suiteálann sé an tseirbhís ar ríomhairí na ngníomhairí roghnaithe (féach an chaibidil [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Roghnúchán ≥ 1 | Díshuiteálann sé an tseirbhís go cianda (féach an chaibidil [Remove Agent](#remove-agent)). |
| **Download configuration** | Roghnúchán = 1 | Gineann sé cartlann cumraíochta an ghníomhaire (féach an chaibidil [Download configuration](#download-configuration)). |

Is ionann déchliceáil ar ró agus **Properties**.

## Gníomhaire a chur leis

Cliceáil **+**. Osclaítear an fhuinneog **Add ACM agent**. Tá gach réimse éigeantach seachas an cur síos.

| Réimse | Cur síos |
|---|---|
| **Name** | Uathúil. Suas le 1024 carachtar. |
| **Description** | Roghnach. Suas le 256 carachtar. |
| **Host** | Ainm an spriocríomhaire. Suas le 1024 carachtar. |

Cliceáil **Validate**. **Ní imscartar aon rud** nuair a fhógraítear gníomhaire: ní dhéantar ach an iontráil a thaifeadadh.

> **Ainm in úsáid cheana**
>
> Má tá an t-ainm ann cheana, diúltaíonn an freastalaí don chur leis leis an teachtaireacht **An ACM agent already has this name.**

## Gníomhaire a chur in eagar

Roghnaigh ró agus cliceáil an deilbhín **Properties** (nó déchliceáil). Taispeánann an fhuinneog **Edit ACM agent** na réimsí céanna.

## Gníomhaire a scriosadh

Roghnaigh ró amháin nó níos mó agus cliceáil **×**. Iarrtar daingniú.

> **Gníomhaire atá in úsáid ag conradh ACM**
>
> Ní féidir gníomhaire atá luaite in **ACM contract** a scriosadh. Ní chealaítear an oibríocht ina hiomláine: **scriostar** na gníomhairí nach bhfuil in úsáid, agus liostaíonn teachtaireacht earráide na **gníomhairí a coinníodh** — “The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:” agus a n-ainmneacha ina dhiaidh. Chun iad a scriosadh, bain as na conarthaí sin iad ar dtús.

## Deploy Agent

Roghnaigh gníomhaire amháin nó níos mó agus cliceáil **Deploy Agent**. Iarrann an fhuinneog den ainm céanna na paraiméadair imscartha. Tá gach réimse éigeantach.

| Réimse | Cur síos |
|---|---|
| **Host** | Inléite amháin. Ríomhairí na ngníomhairí roghnaithe, scartha le camóga. |
| **Gateway** | An chomhpháirt Edge Gateway a stiúrann an t-imscaradh. Ní thairgtear ach comhpháirteanna Edge Gateway **le taifeadadh**. |
| **Domain** | Fearann an chuntais a úsáidtear chun an cianseisiún a oscailt. |
| **Username** | Cuntas a bhfuil cead aige bogearraí a shuiteáil ar an ríomhaire. |
| **Password** | An pasfhocal comhfhreagrach (folaithe). |
| **Target drive** | Litir an tiomántáin suiteála. Luach réamhshocraithe: `c`. |
| **Target directory** | Conair faoin tiomántán sin. Luach réamhshocraithe: `Program Files (x86)\Systancia\ACMAgent`. Suas le 1024 carachtar. |

Nuair a sheoltar an fhoirm, cuirtear glas ar an ngreille leis an teachtaireacht **Deployment in progress...**.

| Toradh | Aiseolas |
|---|---|
| Gníomhaire amháin | Teachtaireacht amháin: **Agent deployment succeeded**, **Deployment failed**, **Agent already present**, nó an diúltú mar gheall ar easpa ceada. |
| Roinnt gníomhairí | An fhuinneog **Agent deployment log**, ró amháin in aghaidh an ghníomhaire san fhoirm `name (host)`, leis an stádas **Success**, **Failure** nó **Agent already present**. |

## Remove Agent

Roghnaigh gníomhaire amháin nó níos mó agus cliceáil **Remove Agent**. Taispeánann an fhoirm **Host**, **Gateway**, **Domain**, **Username** agus **Password** — ní iarrtar an dá réimse a bhaineann leis an suiteáil amháin. Taispeánann an ghreille **Deletion in progress...**, ansin cuirtear an toradh i láthair ar an mbealach céanna: teachtaireacht (**The agent is not present on the server.**, nó **The agent is in use and can not be deleted.**) i gcás gníomhaire amháin, an fhuinneog **Agent removal log** i gcás níos mó, ina gcuirtear an stádas **Agent not present** in ionad **Agent already present**.

> **Fanann an taifead fógartha**
>
> Ní bhaintear an gníomhaire den liosta nuair a bhaintear an tseirbhís: fanann an taifead agus is féidir é a úsáid d'imscaradh nua. Chun é a scriosadh, úsáid **×** (caibidil [Gníomhaire a scriosadh](#delete-an-agent)).

## Download configuration

Roghnaigh gníomhaire **amháin go díreach** agus cliceáil **Download configuration**. Ní iarrann an fhuinneog ach an **Host** (inléite amháin) agus an **Gateway**. Nuair a sheoltar an fhoirm, íoslódálann an brabhsálaí cartlann `<agent name>.zip` ina bhfuil:

| Comhad | Ábhar |
|---|---|
| `<agent name>.p12` | Deimhniú cliaint an ghníomhaire, ginte nuair a iarrtar é. |
| `ca.crt` | Deimhniú an údaráis a shíníonn an tseirbhís ACM. |
| `configuration.xml` | Conair dheimhniú an chliaint agus seoltaí `fqdn:port` na seirbhíse ACM a fhoilsíonn an chomhpháirt Edge Gateway roghnaithe. |
| `readme.txt` | Na trí oibríocht atá le déanamh ar an ríomhaire. |

Freastalaíonn an mód seo ar imscaradh **láimhe** an ghníomhaire, nuair nach féidir suiteáil chianda a dhéanamh. Sonraíonn an comhad `readme.txt` an nós imeachta: allmhairigh `ca.crt` isteach sna húdaráis deimhniúcháin fhréimhe iontaofa **an ríomhaire áitiúil**, cóipeáil na comhaid isteach i bhfillteán suiteála an ghníomhaire, ansin atosaigh an tseirbhís **Cleanroom Credentials Manager**.

> **Teip ghiniúna**
>
> Murar féidir an chartlann a ghiniúint, taispeántar an teachtaireacht **An error occured while generating configuration**. Caithfidh an chomhpháirt Edge Gateway a bheith **ar líne**: is í an chomhpháirt Edge Gateway a sholáthraíonn port na seirbhíse ACM.
