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

# ACM contracts

Modul **ACM contracts** obsahuje autorizace, bez kterých žádný požadavek ACM nikdy neuspěje. Smlouva propojuje **ACM agents**, **ACM users**, **aliasy** Vault a — podle volby — buď všechny aplikace, nebo seznam **ACM applications**, v jednom nebo několika **site**. Navíc může platit pouze v určených obdobích.

> **Dostupnost ACM**
>
> Obrazovka **ACM** a jejích pět modulů se v konzole zobrazí pouze tehdy, když je používání ACM povoleno: jsou vyžadovány jak **licence** zahrnující ACM, tak možnost **Allow ACM usage** zaškrtnutá pro organizaci v systémové konzole.

## Seznam smluv

Každý řádek zobrazuje název smlouvy, před kterým je ikona visacího zámku, a poté **počet** přidružených prvků v každé dimenzi.

| Sloupec | Obsah |
|---|---|
| **Name** | Název smlouvy. |
| **ACM users** | Počet zahrnutých uživatelů ACM. |
| **ACM agents** | Počet zahrnutých agentů ACM. |
| **Sites** | Počet site, ve kterých smlouva platí. |
| **ACM applications** | Počet povolených aplikací, nebo **All** kurzívou, pokud smlouva není omezena na seznam. |
| **Alias** | Počet dostupných aliasů Vault. |

Vyhledávací pole filtruje podle názvu smlouvy, ale také podle **názvu spustitelného souboru** aplikací, **identifikátoru** uživatelů a **názvu** a **hostitele** agentů. Dokud neexistuje žádná smlouva, tabulka zobrazuje **No available ACM contracts**.

> **Rozbalením řádku zobrazíte podrobnosti**
>
> Šipka na začátku řádku rozbalí smlouvu a vypíše, po jednom řádku pro každou dimenzi, skutečně přidružené prvky — uživatele, agenty, site, aplikace a nakonec aliasy. Popis zopakuje tytéž informace ve formě s popisky („User: “ / „Users: “, „ACM agent: “ / „ACM agents: “, „Site: “ / „Sites: “, „Application: “ / „Applications: “, „Alias: “ / „Aliases: “). Popisek se řídí počtem prvků.

### Akce panelu nástrojů

| Akce | Dostupnost | Účinek |
|---|---|---|
| **+** — popis **Add** | Vždy | Otevře formulář pro vytvoření (viz kapitola [Přidání smlouvy](#add-a-contract)). |
| Ikona úprav — popis **Properties** | Výběr = 1 | Otevře stejný formulář, předvyplněný. |
| **×** — popis **Delete** | Výběr ≥ 1 | Vyžádá si potvrzení (viz kapitola [Odstranění smlouvy](#delete-a-contract)). |
| **Export** | Vždy | Stáhne smlouvy ve formátu CSV (viz kapitola [Export smluv](#export-the-contracts)). |
| **Import** | Vždy | Otevře průvodce importem CSV (viz kapitola [Import smluv](#import-contracts)). |

## Přidání smlouvy

Klikněte na **+**. Otevře se okno **Add ACM contract**. Skládá se ze společného záhlaví a navigace o **šesti kartách**, kterými se při vytváření prochází postupně: tlačítko pro odeslání se aktivuje teprve tehdy, když jsou všechny karty platné.

### Záhlaví

| Pole | Popis |
|---|---|
| **Name** | Povinné, jedinečné. Nejvýše 256 znaků. Hodnota tvořená pouze prázdnými znaky je odmítnuta. |
| **Description** | Volitelné. Nejvýše 256 znaků. |

### Karty

Prvních pět karet funguje stejně: **duální seznam**, dostupné prvky vlevo, vybrané prvky vpravo, s tlačítkem pro výběr všech.

**ACM agents**

> Agenti ACM deklarovaní v modulu [ACM agents](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AcmAgents/). **Alespoň jeden agent** je vyžadován. Pokud není deklarován žádný agent, seznam zobrazuje **No agents**.

**Sites**

> Site, ve kterých smlouva platí. Je vyžadován **alespoň jeden site**. Pokud žádný site neexistuje, seznam zobrazuje **No Sites**.

**ACM applications**

> Obsah karty je ohraničen zaškrtávacím políčkem **Only allow specific applications**.
>
> | Stav zaškrtávacího políčka | Účinek |
> |---|---|
> | **Zaškrtnuto** *(výchozí stav při vytváření)* | Smlouva zahrnuje pouze aplikace vybrané v seznamu. Pak se vyžaduje **alespoň jedna aplikace**, jinak karta zůstane neplatná. |
> | **Nezaškrtnuto** | Smlouva zahrnuje **všechny** aplikace a obsah seznamu se ignoruje. Sloupec **ACM applications** v tabulce pak zobrazuje **All**. |
>
> Nabízené aplikace jsou ty z modulu [ACM applications](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AcmApplications/); pokud žádná není deklarována, seznam zobrazuje **No applications**.

**ACM users**

> Uživatelé ACM deklarovaní v modulu [ACM users](https://docs.cyberelements.io/bastion/4.6/cs/Usage/AdminConsoleReference/AcmUsers/). **Alespoň jeden uživatel** je vyžadován. Pokud není deklarován žádný, seznam zobrazuje **No users**.

**Alias**

> Aliasy Vault. Za každým aliasem je v závorce uveden účet, který obsahuje, ve tvaru `domain\name` (nebo samotný název účtu, pokud nemá doménu). **Alespoň jeden alias** je vyžadován. Pokud Vault žádný nezpřístupňuje, seznam zobrazuje **No alias**.

**Restrictions**

> Čtyři nezávislá, kumulativní omezení. Každé se povoluje vlastním zaškrtávacím políčkem; odpovídající pole zůstávají **neaktivní**, dokud není zaškrtnuto.
>
> | Zaškrtávací políčko | Aktivovaná pole |
> |---|---|
> | **Date:** | **Beginning date** a **End Date** ve formátu `dd/mm/yyyy`. Datum konce se posune zpět na datum začátku, pokud mu předchází. |
> | **Hour** | **Starting hour** a **Ending hour**. Časy se zobrazují v časovém pásmu konzoly. Obě hodnoty se musí lišit, jinak pole **Ending hour** ohlásí „Ending hour cannot be equal to starting hour“. |
> | **Month:** | Dvanáct zaškrtávacích políček, jedno pro každý měsíc, označených jeho **počátečním písmenem**. Při povolení omezení jsou všechna zaškrtnuta a alespoň jedno musí zůstat zaškrtnuté. |
> | **Day of the week** | Sedm zaškrtávacích políček, jedno pro každý den, označených jeho **počátečním písmenem**. Při povolení omezení jsou všechna zaškrtnuta a alespoň jedno musí zůstat zaškrtnuté. |
>
> Pod formulářem text srozumitelně shrnuje účinek omezení a aktualizuje se při každé změně: buď **The current contract allows connections without restriction.**, nebo **The current contract allows connections with following restrictions:** a za tím jedna odrážka pro každé aktivní omezení — „Connections are allowed from … to …“, „… from … to …“, „… in “, „… on “.

Kliknutím na **Validate** uložte.

> **Název se již používá**
>
> Pokud název již nese jiná smlouva, uložení se odmítne se zprávou **An ACM contract already has this name.**

## Úprava smlouvy

Vyberte řádek a klikněte na ikonu **Properties** (nebo dvakrát klikněte). Okno **Edit ACM contract** zobrazí stejný formulář s aktuálními výběry předem načtenými na každé kartě, včetně omezení. Smlouva zahrnující všechny aplikace se otevře se zaškrtávacím políčkem karty **ACM applications** v nezaškrtnutém stavu.

## Odstranění smlouvy

Vyberte jeden nebo několik řádků a klikněte na **×**. Zobrazí se žádost o potvrzení. Odstranění se týká pouze smlouvy: agenti, aplikace, uživatelé a aliasy, které v ní byly uvedeny, zůstanou — a znovu je lze odstranit, pokud na ně neodkazuje žádná jiná smlouva.

## Export smluv

Tlačítko **Export** stáhne soubor `acm_contracts.csv` s hodnotami oddělenými středníky, který popisuje zobrazené smlouvy. Jeden sloupec pro každou dimenzi smlouvy:

| Sloupec | Obsah |
|---|---|
| **Name**, **Description** | Záhlaví smlouvy. |
| **Allow any application** | Logická hodnota: true, pokud smlouva není omezena na seznam aplikací. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Seznamy přidružených prvků označených svým názvem (název spustitelného souboru u aplikací, identifikátor u uživatelů). |
| **Beginning date**, **End Date** | Hranice platnosti, pokud je aktivní omezení podle data. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Periodická omezení. ⚠ Časové rozsahy se exportují v **GMT**, zatímco obrazovka je zobrazuje v časovém pásmu konzoly. |

## Import smluv

Tlačítko **Import** otevře průvodce importem konzoly, který očekává soubor CSV s výše uvedenými sloupci — export tedy slouží jako šablona. Povinný je pouze sloupec **Name**; smlouva, jejíž název je již obsazen, se ohlásí jako duplikát.

> **Import může vytvořit aplikace a uživatele**
>
> **ACM applications** a **ACM users** uvedené v souboru, které ještě neexistují, se průběžně **vytvoří**, pokud je jejich hodnota platná (cesta ke spustitelnému souboru, identifikátor účtu). Naopak **ACM agents** a **site** musí existovat předem: import je nevytváří.
