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

# ACM contracts

Модулът **ACM contracts** съдържа упълномощаванията, без които никоя заявка на ACM никога не е успешна. Договорът свързва **ACM agents**, **ACM users**, **псевдоними** от модула Vault и — по избор — или всички приложения, или списък с **ACM applications**, в един или няколко **сайта**. Освен това той може да е валиден само през определени периоди.

> **Наличност на ACM**
>
> Екранът **ACM** и петте му модула се показват в конзолата само когато ACM е разрешен: са необходими както **лиценз**, който покрива ACM, така и отметната за организацията опция **Allow ACM usage** в системната конзола.

## Списък с договори

Всеки ред показва името на договора, предшествано от икона на катинар, след което **броя** на асоциираните елементи във всяко измерение.

| Колона | Съдържание |
|---|---|
| **Name** | Име на договора. |
| **ACM users** | Брой на обхванатите потребители на ACM. |
| **ACM agents** | Брой на обхванатите агенти ACM. |
| **Sites** | Брой на сайтовете, в които се прилага договорът. |
| **ACM applications** | Брой на разрешените приложения или **All** в курсив, когато договорът не е ограничен до списък. |
| **Alias** | Брой на достъпните псевдоними от модула Vault. |

Полето за търсене филтрира по името на договора, но също и по **името на изпълнимия файл** на приложенията, **идентификатора** на потребителите и **името** и **хоста** на агентите. Докато не съществува нито един договор, таблицата показва **No available ACM contracts**.

> **Разгънете ред, за да видите подробностите**
>
> Стрелката в началото на реда разгъва договора и изброява, по един ред за всяко измерение, действително асоциираните елементи — потребители, агенти, сайтове, приложения, след това псевдоними. Подсказка повтаря същата информация с надписи („User: “ / „Users: “, „ACM agent: “ / „ACM agents: “, „Site: “ / „Sites: “, „Application: “ / „Applications: “, „Alias: “ / „Aliases: “). Надписът зависи от броя на елементите.

### Действия в лентата с инструменти

| Действие | Наличност | Ефект |
|---|---|---|
| **+** — подсказка **Add** | Винаги | Отваря формуляра за създаване (вижте частта [Добавяне на договор](#add-a-contract)). |
| Икона за редактиране — подсказка **Properties** | Избор = 1 | Отваря същия формуляр, предварително попълнен. |
| **×** — подсказка **Delete** | Избор ≥ 1 | Изисква потвърждение (вижте частта [Изтриване на договор](#delete-a-contract)). |
| **Export** | Винаги | Изтегля договорите във формат CSV (вижте частта [Експортиране на договорите](#export-the-contracts)). |
| **Import** | Винаги | Отваря съветника за импортиране на CSV (вижте частта [Импортиране на договори](#import-contracts)). |

## Добавяне на договор

Щракнете върху **+**. Отваря се прозорецът **Add ACM contract**. Той се състои от обща заглавна част и навигация с **шест раздела**, които при създаване се преминават поред: бутонът за изпращане става активен едва когато всички раздели са валидни.

### Заглавна част

| Поле | Описание |
|---|---|
| **Name** | Задължително, уникално. До 256 знака. Стойност, съставена само от интервали, се отхвърля. |
| **Description** | Незадължително. До 256 знака. |

### Раздели

Първите пет раздела работят по един и същ начин: **двоен списък** с наличните елементи вляво и избраните елементи вдясно, с бутон за избиране на всички.

**ACM agents**

> Агентите ACM, декларирани в модула [ACM agents](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/AcmAgents/). **Поне един агент** е задължителен. Ако не е деклариран нито един агент, списъкът показва **No agents**.

**Sites**

> Сайтовете, в които се прилага договорът. Изисква се **поне един сайт**. Ако не съществува нито един сайт, списъкът показва **No Sites**.

**ACM applications**

> Съдържанието на раздела зависи от квадратчето за отметка **Only allow specific applications**.
>
> | Състояние на квадратчето | Ефект |
> |---|---|
> | **Отметнато** *(първоначално състояние при създаване)* | Договорът обхваща само приложенията, избрани в списъка. Тогава се изисква **поне едно приложение**, в противен случай разделът остава невалиден. |
> | **Неотметнато** | Договорът обхваща **всички** приложения, а съдържанието на списъка се игнорира. Тогава колоната **ACM applications** в таблицата показва **All**. |
>
> Предлаганите приложения са тези от модула [ACM applications](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/AcmApplications/); ако не е декларирано нито едно, списъкът показва **No applications**.

**ACM users**

> Потребителите на ACM, декларирани в модула [ACM users](https://docs.cyberelements.io/bastion/4.6/bg/Usage/AdminConsoleReference/AcmUsers/). **Поне един потребител** е задължителен. Ако не е деклариран нито един, списъкът показва **No users**.

**Alias**

> Псевдоними от модула Vault. След всеки псевдоним в скоби е посочен акаунтът, който той съдържа, във вида `domain\name` (или само името на акаунта, когато той няма домейн). **Поне един псевдоним** е задължителен. Ако модулът Vault не предоставя нито един, списъкът показва **No alias**.

**Restrictions**

> Четири независими ограничения, които се натрупват. Всяко се активира със собствено квадратче за отметка; съответните полета остават **деактивирани**, докато то не бъде отметнато.
>
> | Квадратче за отметка | Активирани полета |
> |---|---|
> | **Date:** | **Beginning date** и **End Date** във формат `dd/mm/yyyy`. Крайната дата се връща към началната, когато я предшества. |
> | **Hour** | **Starting hour** и **Ending hour**. Часовете се показват в часовата зона на конзолата. Двете стойности трябва да се различават, в противен случай полето **Ending hour** съобщава „Ending hour cannot be equal to starting hour“. |
> | **Month:** | Дванадесет квадратчета за отметка, по едно за всеки месец, обозначени с **началната му буква**. Всички са отметнати, когато ограничението е активирано, и поне едно трябва да остане отметнато. |
> | **Day of the week** | Седем квадратчета за отметка, по едно за всеки ден, обозначени с **началната му буква**. Всички са отметнати, когато ограничението е активирано, и поне едно трябва да остане отметнато. |
>
> Под формуляра текст обобщава ефекта от ограниченията с прости думи и се опреснява при всяка промяна: или **The current contract allows connections without restriction.**, или **The current contract allows connections with following restrictions:**, последвано от по една точка за всяко активно ограничение — „Connections are allowed from … to …“, „… from … to …“, „… in “, „… on “.

Щракнете върху **Validate**, за да запишете.

> **Името вече се използва**
>
> Ако името вече е заето от друг договор, записването се отказва със съобщението **An ACM contract already has this name.**

## Редактиране на договор

Изберете ред, след което щракнете върху иконата **Properties** (или щракнете двукратно). Прозорецът **Edit ACM contract** показва същия формуляр с текущите избори, предварително заредени във всеки раздел, включително ограниченията. Договор, който обхваща всички приложения, се отваря с квадратчето за отметка на раздела **ACM applications** неотметнато.

## Изтриване на договор

Изберете един или няколко реда, след което щракнете върху **×**. Изисква се потвърждение. Изтриването засяга само договора: агентите, приложенията, потребителите и псевдонимите, посочени в него, остават — и отново могат да бъдат изтрити, ако никой друг договор не препраща към тях.

## Експортиране на договорите

Бутонът **Export** изтегля файл `acm_contracts.csv` с разделител точка и запетая, който описва показаните договори. По една колона за всяко измерение на договора:

| Колона | Съдържание |
|---|---|
| **Name**, **Description** | Заглавна част на договора. |
| **Allow any application** | Булева стойност: true, когато договорът не е ограничен до списък с приложения. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Списъци с асоциираните елементи, посочени с името им (име на изпълнимия файл за приложенията, идентификатор за потребителите). |
| **Beginning date**, **End Date** | Граници на валидност, когато ограничението по дата е активно. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Периодични ограничения. ⚠ Часовите диапазони се експортират в **GMT**, докато екранът ги показва в часовата зона на конзолата. |

## Импортиране на договори

Бутонът **Import** отваря съветника за импортиране на конзолата, който очаква файл CSV с колоните по-горе — следователно експортиран файл служи като шаблон. Само колоната **Name** е задължителна; договор, чието име вече е заето, се отчита като дубликат.

> **Импортирането може да създаде приложения и потребители**
>
> **ACM applications** и **ACM users**, посочени във файла, които все още не съществуват, се **създават** в процеса, при условие че стойността им е валидна (път до изпълним файл, идентификатор на акаунт). **ACM agents** и **сайтовете**, от своя страна, трябва да съществуват предварително: импортирането не ги създава.
