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

# ACM contracts

Modul **ACM contracts** obsahuje autorizácie, bez ktorých žiadna požiadavka ACM nikdy neuspeje. Zmluva spája **ACM agents**, **ACM users**, **aliasy** z Vault a — podľa výberu — buď všetky aplikácie, alebo zoznam **ACM applications**, v jednom alebo viacerých **site**. Okrem toho môže platiť iba v určených obdobiach.

> **Dostupnosť ACM**
>
> Obrazovka **ACM** a jej päť modulov sa v konzole zobrazujú iba vtedy, keď je používanie ACM povolené: je potrebná **licencia** pokrývajúca ACM aj začiarknutá možnosť **Allow ACM usage** pre organizáciu v systémovej konzole.

## Zoznam zmlúv

Každý riadok zobrazuje názov zmluvy, pred ktorým je ikona visiaceho zámku, a potom **počet** priradených prvkov v každej dimenzii.

| Stĺpec | Obsah |
|---|---|
| **Name** | Názov zmluvy. |
| **ACM users** | Počet zahrnutých používateľov ACM. |
| **ACM agents** | Počet zahrnutých agentov ACM. |
| **Sites** | Počet site, v ktorých sa zmluva uplatňuje. |
| **ACM applications** | Počet povolených aplikácií alebo **All** kurzívou, ak zmluva nie je obmedzená na zoznam. |
| **Alias** | Počet dostupných aliasov z Vault. |

Pole vyhľadávania filtruje podľa názvu zmluvy, ale aj podľa **názvu spustiteľného súboru** aplikácií, **identifikátora** používateľov a **názvu** a **hostiteľa** agentov. Kým neexistuje žiadna zmluva, tabuľka zobrazuje **No available ACM contracts**.

> **Rozbaľte riadok a zobrazte podrobnosti**
>
> Šípka na začiatku riadka rozbalí zmluvu a uvedie, po jednom riadku na dimenziu, skutočne priradené prvky — používateľov, agentov, site, aplikácie a potom aliasy. Popis zopakuje tie isté informácie vo forme s označeniami („User: “ / „Users: “, „ACM agent: “ / „ACM agents: “, „Site: “ / „Sites: “, „Application: “ / „Applications: “, „Alias: “ / „Aliases: “). Označenie závisí od počtu prvkov.

### Akcie panela s nástrojmi

| Akcia | Dostupnosť | Účinok |
|---|---|---|
| **+** — popis **Add** | Vždy | Otvorí formulár na vytvorenie (pozrite časť [Pridanie zmluvy](#add-a-contract)). |
| Ikona úprav — popis **Properties** | Výber = 1 | Otvorí ten istý formulár, vopred vyplnený. |
| **×** — popis **Delete** | Výber ≥ 1 | Vyžiada potvrdenie (pozrite časť [Odstránenie zmluvy](#delete-a-contract)). |
| **Export** | Vždy | Stiahne zmluvy vo formáte CSV (pozrite časť [Export zmlúv](#export-the-contracts)). |
| **Import** | Vždy | Otvorí sprievodcu importom CSV (pozrite časť [Import zmlúv](#import-contracts)). |

## Pridanie zmluvy

Kliknite na **+**. Otvorí sa okno **Add ACM contract**. Skladá sa zo spoločnej hlavičky a navigácie so **šiestimi kartami**, ktoré treba pri vytváraní prejsť v poradí: tlačidlo na odoslanie sa aktivuje až vtedy, keď sú všetky karty platné.

### Hlavička

| Pole | Popis |
|---|---|
| **Name** | Povinné, jedinečné. Najviac 256 znakov. Hodnota tvorená iba prázdnymi znakmi sa zamietne. |
| **Description** | Voliteľný. Najviac 256 znakov. |

### Karty

Prvých päť kariet funguje rovnako: **dvojitý zoznam**, dostupné prvky vľavo, ponechané prvky vpravo, s tlačidlom na výber všetkých.

**ACM agents**

> Agenti ACM deklarovaní v module [ACM agents](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AcmAgents/). **Aspoň jeden agent** je povinný. Ak nie je deklarovaný žiadny agent, zoznam zobrazuje **No agents**.

**Sites**

> Site, v ktorých sa zmluva uplatňuje. Vyžaduje sa **aspoň jeden site**. Ak neexistuje žiadny site, zoznam zobrazuje **No Sites**.

**ACM applications**

> Obsah karty ovláda začiarkavacie políčko **Only allow specific applications**.
>
> | Stav začiarkavacieho políčka | Účinok |
> |---|---|
> | **Začiarknuté** *(počiatočný stav pri vytváraní)* | Zmluva pokrýva iba aplikácie ponechané v zozname. Vtedy sa vyžaduje **aspoň jedna aplikácia**, inak karta zostane neplatná. |
> | **Nezačiarknuté** | Zmluva pokrýva **všetky** aplikácie a obsah zoznamu sa ignoruje. Stĺpec **ACM applications** v tabuľke potom zobrazuje **All**. |
>
> Ponúkané aplikácie sú aplikácie z modulu [ACM applications](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AcmApplications/); ak nie je deklarovaná žiadna, zoznam zobrazuje **No applications**.

**ACM users**

> Používatelia ACM deklarovaní v module [ACM users](https://docs.cyberelements.io/bastion/4.6/sk/Usage/AdminConsoleReference/AcmUsers/). **Aspoň jeden používateľ** je povinný. Ak nie je deklarovaný žiadny, zoznam zobrazuje **No users**.

**Alias**

> Aliasy z Vault. Za každým aliasom nasleduje v zátvorkách účet, ktorý obsahuje, v tvare `domain\name` (alebo iba názov účtu, ak nemá doménu). **Aspoň jeden alias** je povinný. Ak Vault žiadny nesprístupňuje, zoznam zobrazuje **No alias**.

**Restrictions**

> Štyri nezávislé, kumulatívne obmedzenia. Každé sa povoľuje vlastným začiarkavacím políčkom; príslušné polia zostávajú **zakázané**, kým políčko nie je začiarknuté.
>
> | Začiarkavacie políčko | Povolené polia |
> |---|---|
> | **Date:** | **Beginning date** a **End Date** vo formáte `dd/mm/yyyy`. Ak dátum ukončenia predchádza dátumu začatia, posunie sa späť na dátum začatia. |
> | **Hour** | **Starting hour** a **Ending hour**. Časy sa zobrazujú v časovom pásme konzoly. Obe hodnoty sa musia líšiť, inak pole **Ending hour** ohlási „Ending hour cannot be equal to starting hour“. |
> | **Month:** | Dvanásť začiarkavacích políčok, jedno na každý mesiac, označených **začiatočným písmenom**. Po povolení obmedzenia sú všetky začiarknuté a aspoň jedno musí zostať začiarknuté. |
> | **Day of the week** | Sedem začiarkavacích políčok, jedno na každý deň, označených **začiatočným písmenom**. Po povolení obmedzenia sú všetky začiarknuté a aspoň jedno musí zostať začiarknuté. |
>
> Pod formulárom text zhŕňa účinok obmedzení jednoduchými slovami a obnovuje sa pri každej zmene: buď **The current contract allows connections without restriction.**, alebo **The current contract allows connections with following restrictions:** a za tým jedna odrážka na každé aktívne obmedzenie — „Connections are allowed from … to …“, „… from … to …“, „… in “, „… on “.

Uložte kliknutím na **Validate**.

> **Názov sa už používa**
>
> Ak tento názov už má iná zmluva, uloženie sa zamietne so správou **An ACM contract already has this name.**

## Úprava zmluvy

Vyberte riadok a potom kliknite na ikonu **Properties** (alebo dvakrát kliknite). Okno **Edit ACM contract** zobrazuje ten istý formulár s aktuálnymi výbermi vopred načítanými na každej karte vrátane obmedzení. Zmluva, ktorá pokrýva všetky aplikácie, sa otvorí tak, že políčko na karte **ACM applications** nie je začiarknuté.

## Odstránenie zmluvy

Vyberte jeden alebo viac riadkov a potom kliknite na **×**. Vyžaduje sa potvrdenie. Odstránenie sa týka iba zmluvy: agenti, aplikácie, používatelia a aliasy, ktoré v nej boli uvedené, zostávajú — a opäť ich možno odstrániť, ak na ne neodkazuje žiadna iná zmluva.

## Export zmlúv

Tlačidlo **Export** stiahne súbor `acm_contracts.csv` s hodnotami oddelenými bodkočiarkou, ktorý opisuje zobrazené zmluvy. Jeden stĺpec na každú dimenziu zmluvy:

| Stĺpec | Obsah |
|---|---|
| **Name**, **Description** | Hlavička zmluvy. |
| **Allow any application** | Booleovská hodnota: true, ak zmluva nie je obmedzená na zoznam aplikácií. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Zoznamy priradených prvkov označených názvom (názov spustiteľného súboru pre aplikácie, identifikátor pre používateľov). |
| **Beginning date**, **End Date** | Hranice platnosti, ak je aktívne obmedzenie dátumom. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Periodické obmedzenia. ⚠ Časové rozsahy sa exportujú v **GMT**, zatiaľ čo obrazovka ich zobrazuje v časovom pásme konzoly. |

## Import zmlúv

Tlačidlo **Import** otvorí sprievodcu importom konzoly, ktorý očakáva súbor CSV s vyššie uvedenými stĺpcami — export teda slúži ako šablóna. Povinný je iba stĺpec **Name**; zmluva, ktorej názov je už obsadený, sa ohlási ako duplikát.

> **Import môže vytvoriť aplikácie a používateľov**
>
> Položky **ACM applications** a **ACM users** uvedené v súbore, ktoré ešte neexistujú, sa priebežne **vytvoria**, ak je ich hodnota platná (cesta k spustiteľnému súboru, identifikátor účtu). Naopak, **ACM agents** a **site** musia existovať vopred: import ich nevytvára.
