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

# ACM contracts

Moduuli **ACM contracts** kantaa ne valtuutukset, joita ilman mikään ACM-pyyntö ei koskaan onnistu. Sopimus sitoo yhteen **ACM agents**, **ACM users**, Vault-säilön **aliakset** ja — valinnan mukaan — joko kaikki sovellukset tai luettelon **ACM applications** -sovelluksia yhdessä tai useammassa **site**-kohteessa. Lisäksi se voi olla voimassa vain tiettyinä ajanjaksoina.

> **ACM:n saatavuus**
>
> Näyttö **ACM** ja sen viisi moduulia näkyvät konsolissa vain, kun ACM on sallittu: sekä ACM:n kattava **lisenssi** että organisaatiolle valittu asetus **Allow ACM usage** järjestelmäkonsolissa vaaditaan.

## Sopimusluettelo

Jokainen rivi näyttää sopimuksen nimen, jonka edessä on lukkokuvake, ja sen jälkeen **määrän** liitettyjä elementtejä kussakin ulottuvuudessa.

| Sarake | Sisältö |
|---|---|
| **Name** | Sopimuksen nimi. |
| **ACM users** | Katettujen ACM-käyttäjien määrä. |
| **ACM agents** | Katettujen ACM-agenttien määrä. |
| **Sites** | Niiden site-kohteiden määrä, joissa sopimus on voimassa. |
| **ACM applications** | Sallittujen sovellusten määrä, tai kursiivilla **All**, kun sopimusta ei ole rajattu luetteloon. |
| **Alias** | Saavutettavissa olevien Vault-säilön aliasten määrä. |

Hakukenttä suodattaa sopimuksen nimen perusteella, mutta myös niiden sovellusten **suoritettavan tiedoston nimen** perusteella, käyttäjien **tunnisteen** sekä agenttien **nimen** ja **hostin** perusteella. Niin kauan kuin yhtään sopimusta ei ole, taulukossa näkyy **No available ACM contracts**.

> **Laajenna rivi nähdäksesi yksityiskohdat**
>
> Rivin alussa oleva nuoli laajentaa sopimuksen ja luettelee, yksi rivi ulottuvuutta kohden, siihen todella liitetyt elementit — käyttäjät, agentit, site-kohteet, sovellukset ja sitten aliakset. Työkaluvihje toistaa samat tiedot nimettyinä muodossa (”User: ” / ”Users: ”, ”ACM agent: ” / ”ACM agents: ”, ”Site: ” / ”Sites: ”, ”Application: ” / ”Applications: ”, ”Alias: ” / ”Aliases: ”). Nimike määräytyy elementtien lukumäärän mukaan.

### Työkalupalkin toiminnot

| Toiminto | Saatavuus | Vaikutus |
|---|---|---|
| **+** — työkaluvihje **Add** | Aina | Avaa luontilomakkeen (katso luku [Sopimuksen lisääminen](#add-a-contract)). |
| Muokkauskuvake — työkaluvihje **Properties** | Valinta = 1 | Avaa saman lomakkeen valmiiksi täytettynä. |
| **×** — työkaluvihje **Delete** | Valinta ≥ 1 | Pyytää vahvistusta (katso luku [Sopimuksen poistaminen](#delete-a-contract)). |
| **Export** | Aina | Lataa sopimukset CSV-muodossa (katso luku [Sopimusten vienti](#export-the-contracts)). |
| **Import** | Aina | Avaa CSV-tuonnin ohjatun toiminnon (katso luku [Sopimusten tuonti](#import-contracts)). |

## Sopimuksen lisääminen

Napsauta **+**. Ikkuna **Add ACM contract** avautuu. Se koostuu yhteisestä otsikko-osasta ja **kuuden välilehden** navigoinnista, joka on luonnin yhteydessä käytävä läpi järjestyksessä: lähetyspainike aktivoituu vasta, kun jokainen välilehti on kelvollinen.

### Otsikko-osa

| Kenttä | Kuvaus |
|---|---|
| **Name** | Pakollinen, yksilöllinen. Enintään 256 merkkiä. Pelkistä välilyönneistä koostuva arvo hylätään. |
| **Description** | Valinnainen. Enintään 256 merkkiä. |

### Välilehdet

Viisi ensimmäistä välilehteä toimivat samalla tavalla: **kaksoisluettelo**, käytettävissä olevat elementit vasemmalla, valitut elementit oikealla, ja painike kaikkien valitsemiseen.

**ACM agents**

> ACM-agentit, jotka on määritelty moduulissa [ACM agents](https://docs.cyberelements.io/bastion/4.6/fi/Usage/AdminConsoleReference/AcmAgents/). **Vähintään yksi agentti** on pakollinen. Jos yhtään agenttia ei ole määritelty, luettelossa näkyy **No agents**.

**Sites**

> Site-kohteet, joissa sopimus on voimassa. **Vähintään yksi site-kohde** on pakollinen. Jos yhtään ei ole, luettelossa näkyy **No Sites**.

**ACM applications**

> Välilehden sisältöä hallitsee valintaruutu **Only allow specific applications**.
>
> | Valintaruudun tila | Vaikutus |
> |---|---|
> | **Valittuna** *(alkutila luonnin yhteydessä)* | Sopimus kattaa vain luetteloon valitut sovellukset. Tällöin vaaditaan **vähintään yksi sovellus**, muuten välilehti pysyy kelvottomana. |
> | **Ei valittuna** | Sopimus kattaa **kaikki** sovellukset, ja luettelon sisältö ohitetaan. Taulukon sarakkeessa **ACM applications** näkyy tällöin **All**. |
>
> Tarjolla ovat moduulin [ACM applications](https://docs.cyberelements.io/bastion/4.6/fi/Usage/AdminConsoleReference/AcmApplications/) sovellukset; jos yhtään ei ole määritelty, luettelossa näkyy **No applications**.

**ACM users**

> ACM-käyttäjät, jotka on määritelty moduulissa [ACM users](https://docs.cyberelements.io/bastion/4.6/fi/Usage/AdminConsoleReference/AcmUsers/). **Vähintään yksi käyttäjä** on pakollinen. Jos yhtään ei ole määritelty, luettelossa näkyy **No users**.

**Alias**

> Vault-säilön aliakset. Jokaista aliasta seuraa sulkeissa tili, jonka se sisältää, muodossa `domain\name` (tai pelkkä tilin nimi, jos sillä ei ole toimialuetta). **Vähintään yksi alias** on pakollinen. Jos Vault-säilö ei tarjoa yhtään, luettelossa näkyy **No alias**.

**Restrictions**

> Neljä toisistaan riippumatonta, kumuloituvaa rajoitusta. Kukin otetaan käyttöön omalla valintaruudullaan; vastaavat kentät pysyvät **poissa käytöstä**, kunnes se valitaan.
>
> | Valintaruutu | Käyttöön otetut kentät |
> |---|---|
> | **Date:** | **Beginning date** ja **End Date**, muodossa `dd/mm/yyyy`. Päättymispäivä siirretään alkamispäivään, jos se on sitä ennen. |
> | **Hour** | **Starting hour** ja **Ending hour**. Kellonajat näytetään konsolin aikavyöhykkeessä. Arvojen on erottava toisistaan, muuten kenttä **Ending hour** ilmoittaa ”Ending hour cannot be equal to starting hour”. |
> | **Month:** | Kaksitoista valintaruutua, yksi kuukautta kohden, nimettynä **alkukirjaimella**. Rajoitusta käyttöön otettaessa kaikki ovat valittuina, ja vähintään yhden on pysyttävä valittuna. |
> | **Day of the week** | Seitsemän valintaruutua, yksi päivää kohden, nimettynä **alkukirjaimella**. Rajoitusta käyttöön otettaessa kaikki ovat valittuina, ja vähintään yhden on pysyttävä valittuna. |
>
> Lomakkeen alla teksti tiivistää rajoitusten vaikutuksen tavallisin sanoin ja päivittyy jokaisesta muutoksesta: joko **The current contract allows connections without restriction.**, tai **The current contract allows connections with following restrictions:** ja sen jälkeen yksi luettelomerkki aktiivista rajoitusta kohden — ”Connections are allowed from … to …”, ”… from … to …”, ”… in ”, ”… on ”.

Napsauta **Validate** tallentaaksesi.

> **Nimi on jo käytössä**
>
> Jos nimi on jo toisella sopimuksella, tallennus hylätään ja annetaan viesti **An ACM contract already has this name.**

## Sopimuksen muokkaaminen

Valitse rivi ja napsauta kuvaketta **Properties** (tai kaksoisnapsauta). Ikkuna **Edit ACM contract** näyttää saman lomakkeen, jossa nykyiset valinnat on esiladattu jokaiselle välilehdelle, rajoitukset mukaan lukien. Kaikki sovellukset kattava sopimus avautuu niin, että välilehden **ACM applications** valintaruutu ei ole valittuna.

## Sopimuksen poistaminen

Valitse yksi tai useampi rivi ja napsauta **×**. Vahvistusta pyydetään. Poistaminen koskee vain sopimusta: sen nimeämät agentit, sovellukset, käyttäjät ja aliakset säilyvät — ja ovat jälleen poistettavissa, jos mikään muu sopimus ei viittaa niihin.

## Sopimusten vienti

Painike **Export** lataa puolipistein erotellun tiedoston `acm_contracts.csv`, joka kuvaa näytetyt sopimukset. Yksi sarake sopimuksen ulottuvuutta kohden:

| Sarake | Sisältö |
|---|---|
| **Name**, **Description** | Sopimuksen otsikko-osa. |
| **Allow any application** | Totuusarvo: tosi, kun sopimusta ei ole rajattu sovellusluetteloon. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Luettelot liitetyistä elementeistä, nimettynä nimensä mukaan (sovelluksilla suoritettavan tiedoston nimi, käyttäjillä tunniste). |
| **Beginning date**, **End Date** | Voimassaolon rajat, kun päivämäärärajoitus on käytössä. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Jaksottaiset rajoitukset. ⚠ Aikavälit viedään **GMT**-ajassa, kun taas näytöllä ne esitetään konsolin aikavyöhykkeessä. |

## Sopimusten tuonti

Painike **Import** avaa konsolin ohjatun tuonnin, joka odottaa CSV-tiedostoa, jossa on edellä mainitut sarakkeet — vienti toimii siis mallina. Vain sarake **Name** on pakollinen; sopimus, jonka nimi on jo varattu, ilmoitetaan kaksoiskappaleena.

> **Tuonti voi luoda sovelluksia ja käyttäjiä**
>
> Tiedoston nimeämät **ACM applications** ja **ACM users**, joita ei vielä ole, **luodaan** samalla, jos niiden arvo on kelvollinen (suoritettavan tiedoston polku, tilin tunniste). **ACM agents** -agenttien ja **site**-kohteiden on sen sijaan oltava olemassa jo ennalta: tuonti ei luo niitä.
