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

# ACM contracts

Moodul **ACM contracts** sisaldab autoriseerimisi, ilma milleta ükski ACM-taotlus kunagi ei õnnestu. Leping seob omavahel **ACM agents**, **ACM users**, Vault komponendi **aliased** ja — valiku järgi — kas kõik rakendused või loendi **ACM applications** rakendustest ühel või mitmel **site'il**. Lisaks võib see kehtida ainult kindlatel perioodidel.

> **ACM-i saadavus**
>
> Kuva **ACM** ja selle viis moodulit ilmuvad konsoolis ainult siis, kui ACM on lubatud: on vaja nii ACM-i hõlmavat **litsentsi** kui ka süsteemikonsoolis organisatsiooni jaoks märgitud suvandit **Allow ACM usage**.

## Lepingute loend

Igal real kuvatakse lepingu nimi, mille ees on tabaluku ikoon, ja seejärel iga mõõtme seotud elementide **arv**.

| Veerg | Sisu |
|---|---|
| **Name** | Lepingu nimi. |
| **ACM users** | Hõlmatud ACM-kasutajate arv. |
| **ACM agents** | Hõlmatud ACM-agentide arv. |
| **Sites** | Nende site'ide arv, kus leping kehtib. |
| **ACM applications** | Lubatud rakenduste arv või kaldkirjas **All**, kui leping pole loendiga piiratud. |
| **Alias** | Juurdepääsetavate Vault komponendi aliaste arv. |

Otsinguväli filtreerib lepingu nime järgi, aga ka rakenduste **käivitatava faili nime**, kasutajate **identifikaatori** ning agentide **nime** ja **hosti** järgi. Kuni ühtegi lepingut pole, kuvatakse tabelis **No available ACM contracts**.

> **Üksikasjade nägemiseks laiendage rida**
>
> Rea alguses olev nool laiendab lepingut ja loetleb, üks rida mõõtme kohta, tegelikult seotud elemendid — kasutajad, agendid, site'id, rakendused ja seejärel aliased. Kohtspikker kordab sama teavet siltidega kujul („User: “ / „Users: “, „ACM agent: “ / „ACM agents: “, „Site: “ / „Sites: “, „Application: “ / „Applications: “, „Alias: “ / „Aliases: “). Nimetus sõltub elementide arvust.

### Tööriistariba toimingud

| Toiming | Saadavus | Mõju |
|---|---|---|
| **+** — kohtspikker **Add** | Alati | Avab loomisvormi (vt peatükki [Lepingu lisamine](#add-a-contract)). |
| Redigeerimisikoon — kohtspikker **Properties** | Valik = 1 | Avab sama vormi eeltäidetuna. |
| **×** — kohtspikker **Delete** | Valik ≥ 1 | Küsib kinnitust (vt peatükki [Lepingu kustutamine](#delete-a-contract)). |
| **Export** | Alati | Laadib lepingud alla CSV-vormingus (vt peatükki [Lepingute eksportimine](#export-the-contracts)). |
| **Import** | Alati | Avab CSV-importimise viisardi (vt peatükki [Lepingute importimine](#import-contracts)). |

## Lepingu lisamine

Klõpsake **+**. Avaneb aken **Add ACM contract**. See koosneb ühisest päisest ja **kuue vahekaardiga** navigeerimisest, mis tuleb loomisel järjest läbi käia: esitamisnupp muutub aktiivseks alles siis, kui iga vahekaart on kehtiv.

### Päis

| Väli | Kirjeldus |
|---|---|
| **Name** | Kohustuslik, kordumatu. Kuni 256 märki. Ainult tühikutest koosnev väärtus lükatakse tagasi. |
| **Description** | Valikuline. Kuni 256 märki. |

### Vahekaardid

Esimesed viis vahekaarti toimivad ühtemoodi: **topeltloend**, saadaolevad elemendid vasakul, valitud elemendid paremal ja nupp kõigi valimiseks.

**ACM agents**

> Moodulis [ACM agents](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AcmAgents/) deklareeritud ACM-agendid. **Vähemalt üks agent** on nõutav. Kui ühtegi agenti pole deklareeritud, kuvatakse loendis **No agents**.

**Sites**

> Site'id, kus leping kehtib. **Vähemalt üks site** on nõutav. Kui ühtegi site'i pole, kuvatakse loendis **No Sites**.

**ACM applications**

> Vahekaardi sisu juhib märkeruut **Only allow specific applications**.
>
> | Märkeruudu olek | Mõju |
> |---|---|
> | **Märgitud** *(algolek loomisel)* | Leping hõlmab ainult loendis valitud rakendusi. Sel juhul on nõutav **vähemalt üks rakendus**, vastasel juhul jääb vahekaart kehtetuks. |
> | **Märkimata** | Leping hõlmab **kõiki** rakendusi ja loendi sisu eiratakse. Tabeli veerus **ACM applications** kuvatakse siis **All**. |
>
> Pakutakse mooduli [ACM applications](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AcmApplications/) rakendusi; kui ühtegi pole deklareeritud, kuvatakse loendis **No applications**.

**ACM users**

> Moodulis [ACM users](https://docs.cyberelements.io/bastion/4.6/et/Usage/AdminConsoleReference/AcmUsers/) deklareeritud ACM-kasutajad. **Vähemalt üks kasutaja** on nõutav. Kui ühtegi pole deklareeritud, kuvatakse loendis **No users**.

**Alias**

> Vault komponendi aliased. Iga aliase järel on sulgudes konto, mida see sisaldab, kujul `domain\name` (või ainult konto nimi, kui sellel pole domeeni). **Vähemalt üks alias** on nõutav. Kui Vault komponent ei paku ühtegi, kuvatakse loendis **No alias**.

**Restrictions**

> Neli sõltumatut, kumulatiivset piirangut. Iga piirang lülitatakse sisse oma märkeruuduga; vastavad väljad jäävad **mitteaktiivseks**, kuni see on märgitud.
>
> | Märkeruut | Aktiveeritavad väljad |
> |---|---|
> | **Date:** | **Beginning date** ja **End Date** kujul `dd/mm/yyyy`. Kui lõppkuupäev on alguskuupäevast varasem, nihutatakse see alguskuupäevale. |
> | **Hour** | **Starting hour** ja **Ending hour**. Kellaajad kuvatakse konsooli ajavööndis. Väärtused peavad erinema, vastasel juhul kuvab väli **Ending hour** teate „Ending hour cannot be equal to starting hour“. |
> | **Month:** | Kaksteist märkeruutu, üks iga kuu kohta, tähistatud **algustähega**. Piirangu sisselülitamisel on kõik märgitud ja vähemalt üks peab jääma märgituks. |
> | **Day of the week** | Seitse märkeruutu, üks iga päeva kohta, tähistatud **algustähega**. Piirangu sisselülitamisel on kõik märgitud ja vähemalt üks peab jääma märgituks. |
>
> Vormi all olev tekst võtab piirangute mõju lihtsate sõnadega kokku ja värskendub iga muudatuse korral: kas **The current contract allows connections without restriction.** või **The current contract allows connections with following restrictions:**, millele järgneb üks täpp iga aktiivse piirangu kohta — „Connections are allowed from … to …“, „… from … to …“, „… in “, „… on “.

Salvestamiseks klõpsake **Validate**.

> **Nimi on juba kasutusel**
>
> Kui nimi on juba mõnel teisel lepingul, lükatakse salvestamine tagasi teatega **An ACM contract already has this name.**

## Lepingu redigeerimine

Valige rida ja klõpsake seejärel ikooni **Properties** (või topeltklõpsake). Aknas **Edit ACM contract** kuvatakse sama vorm, kus praegused valikud on igal vahekaardil eellaaditud, sealhulgas piirangud. Kõiki rakendusi hõlmav leping avaneb nii, et vahekaardi **ACM applications** märkeruut on märkimata.

## Lepingu kustutamine

Valige üks või mitu rida ja klõpsake seejärel **×**. Küsitakse kinnitust. Kustutamine puudutab ainult lepingut: selles nimetatud agendid, rakendused, kasutajad ja aliased jäävad alles — ja neid saab taas kustutada, kui ükski teine leping neile ei viita.

## Lepingute eksportimine

Nupp **Export** laadib alla semikoolonitega eraldatud faili `acm_contracts.csv`, mis kirjeldab kuvatud lepinguid. Üks veerg iga lepingu mõõtme kohta:

| Veerg | Sisu |
|---|---|
| **Name**, **Description** | Lepingu päis. |
| **Allow any application** | Tõeväärtus: tõene, kui leping pole rakenduste loendiga piiratud. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Seotud elementide loendid, mis on tähistatud nende nimega (rakenduste puhul käivitatava faili nimi, kasutajate puhul identifikaator). |
| **Beginning date**, **End Date** | Kehtivuse piirid, kui kuupäevapiirang on aktiivne. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Perioodilised piirangud. ⚠ Ajavahemikud eksporditakse **GMT** järgi, samas kui kuval näidatakse neid konsooli ajavööndis. |

## Lepingute importimine

Nupp **Import** avab konsooli importimisviisardi, mis ootab CSV-faili, milles on ülaltoodud veerud — seega sobib eksport malliks. Ainult veerg **Name** on kohustuslik; leping, mille nimi on juba võetud, märgitakse duplikaadiks.

> **Importimine võib luua rakendusi ja kasutajaid**
>
> Failis nimetatud **ACM applications** ja **ACM users**, mida veel pole olemas, **luuakse** käigu pealt, eeldusel et nende väärtus on kehtiv (käivitatava faili tee, konto identifikaator). **ACM agents** ja **site'id** peavad seevastu juba eelnevalt olemas olema: importimine neid ei loo.
