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

# ACM contracts

Modul **ACM contracts** vsebuje avtorizacije, brez katerih nobena zahteva ACM nikoli ne uspe. Pogodba povezuje **ACM agents**, **ACM users**, **vzdevke** iz Vault in – po izbiri – bodisi vse aplikacije bodisi seznam **ACM applications**, na enem ali več **site**. Poleg tega lahko velja le v določenih obdobjih.

> **Razpoložljivost ACM**
>
> Zaslon **ACM** in njegovih pet modulov se v konzoli prikažejo le, če je ACM dovoljen: sta potrebni tako **licenca**, ki zajema ACM, kot možnost **Allow ACM usage**, označena za organizacijo v sistemski konzoli.

## Seznam pogodb

Vsaka vrstica prikazuje ime pogodbe, pred katerim je ikona ključavnice, nato pa **število** povezanih elementov v vsaki razsežnosti.

| Stolpec | Vsebina |
|---|---|
| **Name** | Ime pogodbe. |
| **ACM users** | Število zajetih uporabnikov ACM. |
| **ACM agents** | Število zajetih agentov ACM. |
| **Sites** | Število site, na katerih velja pogodba. |
| **ACM applications** | Število dovoljenih aplikacij ali **All** v ležečem tisku, kadar pogodba ni omejena na seznam. |
| **Alias** | Število dosegljivih vzdevkov iz Vault. |

Iskalno polje filtrira po imenu pogodbe, pa tudi po **imenu izvršljive datoteke** aplikacij, **identifikatorju** uporabnikov ter **imenu** in **gostitelju** agentov. Dokler ne obstaja nobena pogodba, tabela prikazuje **No available ACM contracts**.

> **Razširite vrstico, da vidite podrobnosti**
>
> Puščica na začetku vrstice razširi pogodbo in navede, po eno vrstico za vsako razsežnost, dejansko povezane elemente – uporabnike, agente, site, aplikacije in nato vzdevke. Opis orodja ponovi iste informacije v obliki z oznakami („User: “ / „Users: “, „ACM agent: “ / „ACM agents: “, „Site: “ / „Sites: “, „Application: “ / „Applications: “, „Alias: “ / „Aliases: “). Oznaka je odvisna od števila elementov.

### Dejanja v orodni vrstici

| Dejanje | Razpoložljivost | Učinek |
|---|---|---|
| **+** – opis orodja **Add** | Vedno | Odpre obrazec za ustvarjanje (glejte poglavje [Dodajanje pogodbe](#add-a-contract)). |
| Ikona za urejanje – opis orodja **Properties** | Izbor = 1 | Odpre isti obrazec, vnaprej izpolnjen. |
| **×** – opis orodja **Delete** | Izbor ≥ 1 | Zahteva potrditev (glejte poglavje [Brisanje pogodbe](#delete-a-contract)). |
| **Export** | Vedno | Prenese pogodbe v obliki CSV (glejte poglavje [Izvoz pogodb](#export-the-contracts)). |
| **Import** | Vedno | Odpre čarovnika za uvoz CSV (glejte poglavje [Uvoz pogodb](#import-contracts)). |

## Dodajanje pogodbe

Kliknite **+**. Odpre se okno **Add ACM contract**. Sestavljeno je iz skupne glave in navigacije s **šestimi zavihki**, ki jih je treba pri ustvarjanju prehoditi po vrsti: gumb za oddajo postane aktiven šele, ko so vsi zavihki veljavni.

### Glava

| Polje | Opis |
|---|---|
| **Name** | Obvezno, enolično. Največ 256 znakov. Vrednost, ki jo sestavljajo samo presledni znaki, je zavrnjena. |
| **Description** | Izbirno. Največ 256 znakov. |

### Zavihki

Prvih pet zavihkov deluje na enak način: **dvojni seznam**, razpoložljivi elementi na levi, izbrani elementi na desni, z gumbom za izbiro vseh.

**ACM agents**

> Agenti ACM, deklarirani v modulu [ACM agents](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AcmAgents/). **Vsaj en agent** je obvezen. Če ni deklariran noben agent, seznam prikazuje **No agents**.

**Sites**

> Site, na katerih velja pogodba. **Vsaj en site** je obvezen. Če ne obstaja noben site, seznam prikazuje **No Sites**.

**ACM applications**

> Vsebino zavihka obdaja okvir s potrditvenim poljem **Only allow specific applications**.
>
> | Stanje potrditvenega polja | Učinek |
> |---|---|
> | **Označeno** *(začetno stanje pri ustvarjanju)* | Pogodba zajema le aplikacije, izbrane na seznamu. Takrat je obvezna **vsaj ena aplikacija**, sicer zavihek ostane neveljaven. |
> | **Neoznačeno** | Pogodba zajema **vse** aplikacije, vsebina seznama pa se prezre. Stolpec **ACM applications** v tabeli takrat prikazuje **All**. |
>
> Ponujene aplikacije so tiste iz modula [ACM applications](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AcmApplications/); če ni deklarirana nobena, seznam prikazuje **No applications**.

**ACM users**

> Uporabniki ACM, deklarirani v modulu [ACM users](https://docs.cyberelements.io/bastion/4.6/sl/Usage/AdminConsoleReference/AcmUsers/). **Vsaj en uporabnik** je obvezen. Če ni deklariran noben, seznam prikazuje **No users**.

**Alias**

> Vzdevki iz Vault. Za vsakim vzdevkom je v oklepaju naveden račun, ki ga hrani, v obliki `domain\name` (ali samo ime računa, kadar nima domene). **Vsaj en vzdevek** je obvezen. Če Vault ne ponuja nobenega, seznam prikazuje **No alias**.

**Restrictions**

> Štiri neodvisne, kumulativne omejitve. Vsako omogočite z lastnim potrditvenim poljem; ustrezna polja ostanejo **onemogočena**, dokler potrditveno polje ni označeno.
>
> | Potrditveno polje | Omogočena polja |
> |---|---|
> | **Date:** | **Beginning date** in **End Date** v obliki `dd/mm/yyyy`. Končni datum se pomakne nazaj na začetni datum, kadar je pred njim. |
> | **Hour** | **Starting hour** in **Ending hour**. Ure so prikazane v časovnem pasu konzole. Obe vrednosti se morata razlikovati, sicer polje **Ending hour** javi „Ending hour cannot be equal to starting hour“. |
> | **Month:** | Dvanajst potrditvenih polj, po eno za vsak mesec, poimenovanih z **začetnico** meseca. Ko je omejitev omogočena, so vsa označena, vsaj eno pa mora ostati označeno. |
> | **Day of the week** | Sedem potrditvenih polj, po eno za vsak dan, poimenovanih z **začetnico** dneva. Ko je omejitev omogočena, so vsa označena, vsaj eno pa mora ostati označeno. |
>
> Pod obrazcem besedilo z navadnimi besedami povzame učinek omejitev in se osveži ob vsaki spremembi: bodisi **The current contract allows connections without restriction.** bodisi **The current contract allows connections with following restrictions:**, nato pa po ena alineja za vsako aktivno omejitev – „Connections are allowed from … to …“, „… from … to …“, „… in “, „… on “.

Kliknite **Validate**, da shranite.

> **Ime je že uporabljeno**
>
> Če ime že nosi druga pogodba, je shranjevanje zavrnjeno s sporočilom **An ACM contract already has this name.**

## Urejanje pogodbe

Izberite vrstico in nato kliknite ikono **Properties** (ali dvokliknite). Okno **Edit ACM contract** prikaže isti obrazec s trenutnimi izbirami, vnaprej naloženimi v vseh zavihkih, vključno z omejitvami. Pogodba, ki zajema vse aplikacije, se odpre z neoznačenim potrditvenim poljem zavihka **ACM applications**.

## Brisanje pogodbe

Izberite eno ali več vrstic in nato kliknite **×**. Zahtevana je potrditev. Brisanje vpliva le na pogodbo: agenti, aplikacije, uporabniki in vzdevki, ki jih je navajala, ostanejo – in jih je znova mogoče izbrisati, če se nanje ne sklicuje nobena druga pogodba.

## Izvoz pogodb

Gumb **Export** prenese datoteko `acm_contracts.csv` z vrednostmi, ločenimi s podpičji, ki opisuje prikazane pogodbe. Po en stolpec za vsako razsežnost pogodbe:

| Stolpec | Vsebina |
|---|---|
| **Name**, **Description** | Glava pogodbe. |
| **Allow any application** | Logična vrednost, ki je resnična, kadar pogodba ni omejena na seznam aplikacij. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Seznami povezanih elementov, navedenih z imenom (ime izvršljive datoteke za aplikacije, identifikator za uporabnike). |
| **Beginning date**, **End Date** | Meji obdobja veljavnosti, kadar je omejitev po datumu aktivna. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Periodične omejitve. ⚠ Časovni razponi se izvozijo v **GMT**, zaslon pa jih prikazuje v časovnem pasu konzole. |

## Uvoz pogodb

Gumb **Import** odpre čarovnika za uvoz v konzoli, ki pričakuje datoteko CSV z zgornjimi stolpci – izvoz torej služi kot predloga. Le stolpec **Name** je obvezen; pogodba z že zasedenim imenom je javljena kot dvojnik.

> **Uvoz lahko ustvari aplikacije in uporabnike**
>
> Elementi **ACM applications** in **ACM users**, ki jih navaja datoteka in še ne obstajajo, se **ustvarijo** sproti, če je njihova vrednost veljavna (pot do izvršljive datoteke, identifikator računa). **ACM agents** in **site** pa morajo obstajati že prej: uvoz jih ne ustvari.
