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

# ACM contracts

Az **ACM contracts** modul azokat az engedélyezéseket tartalmazza, amelyek nélkül egyetlen ACM-kérés sem lehet sikeres. Egy szerződés **ACM-ügynököket**, **ACM-felhasználókat**, a Vault modul **aliasait**, valamint – választás szerint – vagy az összes alkalmazást, vagy **ACM-alkalmazások** listáját kapcsolja össze egy vagy több **site-on**. Emellett érvényessége meghatározott időszakokra is korlátozható.

> **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.

## A szerződések listája

Minden sor a szerződés nevét mutatja egy lakat ikonnal az elején, majd a társított elemek **számát** dimenziónként.

| Oszlop | Tartalom |
|---|---|
| **Name** | A szerződés neve. |
| **ACM users** | A lefedett ACM-felhasználók száma. |
| **ACM agents** | A lefedett ACM-ügynökök száma. |
| **Sites** | Azon site-ok száma, ahol a szerződés érvényes. |
| **ACM applications** | A megengedett alkalmazások száma, vagy dőlt betűs **All**, ha a szerződés nincs listára korlátozva. |
| **Alias** | A Vault modulban elérhető aliasok száma. |

A keresőmező nemcsak a szerződés nevére szűr, hanem az alkalmazások **végrehajtható fájljának nevére**, a felhasználók **azonosítójára**, valamint az ügynökök **nevére** és **gazdagépére** is. Amíg egyetlen szerződés sem létezik, a táblázatban a **No available ACM contracts** felirat látható.

> **Bontson ki egy sort a részletek megtekintéséhez**
>
> A sor elején lévő nyíl kibontja a szerződést, és dimenziónként egy sorban felsorolja a ténylegesen társított elemeket – felhasználókat, ügynököket, site-okat, alkalmazásokat, majd aliasokat. Egy elemleírás feliratozott formában ismétli meg ugyanezeket az információkat („User: ” / „Users: ”, „ACM agent: ” / „ACM agents: ”, „Site: ” / „Sites: ”, „Application: ” / „Applications: ”, „Alias: ” / „Aliases: ”). A felirat az elemek számához igazodik.

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

| Művelet | Elérhetőség | Hatás |
|---|---|---|
| **+** – elemleírás: **Add** | Mindig | Megnyitja a létrehozási űrlapot (lásd a [Szerződés hozzáadása](#add-a-contract) 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 a [Szerződés törlése](#delete-a-contract) fejezetet). |
| **Export** | Mindig | CSV formátumban letölti a szerződéseket (lásd a [Szerződések exportálása](#export-the-contracts) fejezetet). |
| **Import** | Mindig | Megnyitja a CSV-importálási varázslót (lásd a [Szerződések importálása](#import-contracts) fejezetet). |

## Szerződés hozzáadása

Kattintson a **+** gombra. Megnyílik az **Add ACM contract** ablak. Egy közös fejlécből és egy **hat lapból** álló navigációból áll, amelyen létrehozáskor sorban kell végighaladni: az elküldés gombja csak akkor válik aktívvá, ha minden lap érvényes.

### Fejléc

| Mező | Leírás |
|---|---|
| **Name** | Kötelező, egyedi. Legfeljebb 256 karakter. A csak szóközökből álló értéket a rendszer elutasítja. |
| **Description** | Nem kötelező. Legfeljebb 256 karakter. |

### Lapok

Az első öt lap ugyanúgy működik: egy **kettős lista**, bal oldalon az elérhető elemekkel, jobb oldalon a kiválasztott elemekkel, valamint egy összes kijelölése gombbal.

**ACM agents**

> Az [ACM agents](https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/AcmAgents/) modulban deklarált ACM-ügynökök. **Legalább egy ügynök** megadása kötelező. Ha egyetlen ügynök sincs deklarálva, a listában a **No agents** felirat látható.

**Sites**

> Azok a site-ok, ahol a szerződés érvényes. **Legalább egy site** megadása kötelező. Ha egyetlen site sem létezik, a listában a **No Sites** felirat látható.

**ACM applications**

> A lap tartalmát az **Only allow specific applications** jelölőnégyzet fogja közre.
>
> | A jelölőnégyzet állapota | Hatás |
> |---|---|
> | **Bejelölve** *(kezdeti állapot létrehozáskor)* | A szerződés csak a listában kiválasztott alkalmazásokra vonatkozik. Ekkor **legalább egy alkalmazás** megadása kötelező, különben a lap érvénytelen marad. |
> | **Nincs bejelölve** | A szerződés **minden** alkalmazásra vonatkozik, és a lista tartalmát a rendszer figyelmen kívül hagyja. A táblázat **ACM applications** oszlopában ekkor **All** látható. |
>
> A felkínált alkalmazások az [ACM applications](https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/AcmApplications/) modulból származnak; ha egy sincs deklarálva, a listában a **No applications** felirat látható.

**ACM users**

> Az [ACM users](https://docs.cyberelements.io/bastion/4.6/hu/Usage/AdminConsoleReference/AcmUsers/) modulban deklarált ACM-felhasználók. **Legalább egy felhasználó** megadása kötelező. Ha egy sincs deklarálva, a listában a **No users** felirat látható.

**Alias**

> A Vault modul aliasai. Minden alias után zárójelben az általa tárolt fiók áll, `domain\name` formában (vagy csak a fiók neve, ha nincs tartománya). **Legalább egy alias** megadása kötelező. Ha a Vault modul egyet sem tesz elérhetővé, a listában a **No alias** felirat látható.

**Restrictions**

> Négy független, halmozódó korlátozás. Mindegyik a saját jelölőnégyzetével kapcsolható be; a hozzá tartozó mezők mindaddig **letiltva** maradnak, amíg a jelölőnégyzet nincs bejelölve.
>
> | Jelölőnégyzet | Bekapcsolt mezők |
> |---|---|
> | **Date:** | **Beginning date** és **End Date**, `dd/mm/yyyy` formátumban. Ha a záró dátum megelőzi a kezdő dátumot, a rendszer visszaállítja a kezdő dátumra. |
> | **Hour** | **Starting hour** és **Ending hour**. Az időpontok a konzol időzónájában jelennek meg. A két értéknek különböznie kell, ellenkező esetben az **Ending hour** mező a következő hibát jelzi: „Ending hour cannot be equal to starting hour”. |
> | **Month:** | Tizenkét jelölőnégyzet, havonta egy, a hónap **kezdőbetűjével** feliratozva. A korlátozás bekapcsolásakor mind be van jelölve, és legalább egynek bejelölve kell maradnia. |
> | **Day of the week** | Hét jelölőnégyzet, naponta egy, a nap **kezdőbetűjével** feliratozva. A korlátozás bekapcsolásakor mind be van jelölve, és legalább egynek bejelölve kell maradnia. |
>
> Az űrlap alatt egy szöveg közérthetően összefoglalja a korlátozások hatását, és minden módosításkor frissül: vagy **The current contract allows connections without restriction.**, vagy **The current contract allows connections with following restrictions:**, amelyet aktív korlátozásonként egy felsoráspont követ – „Connections are allowed from … to …”, „… from … to …”, „… in ”, „… on ”.

A mentéshez kattintson a **Validate** gombra.

> **A név már foglalt**
>
> Ha a nevet már egy másik szerződés viseli, a rendszer a következő üzenettel utasítja el a mentést: **An ACM contract already has this name.**

## Szerződés módosítása

Jelöljön ki egy sort, majd kattintson a **Properties** ikonra (vagy kattintson duplán). Az **Edit ACM contract** ablak ugyanazt az űrlapot jeleníti meg, minden lapon az aktuális kijelölésekkel előre betöltve, a korlátozásokat is beleértve. A minden alkalmazásra kiterjedő szerződés úgy nyílik meg, hogy az **ACM applications** lap jelölőnégyzete nincs bejelölve.

## Szerződés törlése

Jelöljön ki egy vagy több sort, majd kattintson a **×** gombra. A rendszer megerősítést kér. A törlés csak a szerződést érinti: az abban megnevezett ügynökök, alkalmazások, felhasználók és aliasok megmaradnak – és ismét törölhetővé válnak, ha más szerződés nem hivatkozik rájuk.

## Szerződések exportálása

Az **Export** gomb letölt egy pontosvesszővel tagolt `acm_contracts.csv` fájlt, amely a megjelenített szerződéseket írja le. A szerződés minden dimenziójához egy oszlop tartozik:

| Oszlop | Tartalom |
|---|---|
| **Name**, **Description** | A szerződés fejléce. |
| **Allow any application** | Logikai érték: igaz, ha a szerződés nincs alkalmazáslistára korlátozva. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | A társított elemek listái, a nevükkel megjelölve (alkalmazásoknál a végrehajtható fájl neve, felhasználóknál az azonosító). |
| **Beginning date**, **End Date** | Az érvényesség határai, ha a dátumkorlátozás aktív. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Időszakos korlátozások. ⚠ Az időtartományok exportálása **GMT** szerint történik, míg a képernyő a konzol időzónájában jeleníti meg őket. |

## Szerződések importálása

Az **Import** gomb megnyitja a konzol importálási varázslóját, amely a fenti oszlopokat tartalmazó CSV-fájlt vár – egy exportált fájl tehát sablonként szolgálhat. Csak a **Name** oszlop kötelező; azt a szerződést, amelynek neve már foglalt, a rendszer ismétlődőként jelzi.

> **Az importálás alkalmazásokat és felhasználókat is létrehozhat**
>
> A fájlban megnevezett, még nem létező **ACM applications** és **ACM users** elemeket a rendszer menet közben **létrehozza**, feltéve, hogy az értékük érvényes (végrehajtható fájl elérési útja, fiók azonosítója). Az **ACM agents** elemeknek és a **site-oknak** viszont előzetesen létezniük kell: az importálás nem hozza létre őket.
