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

# ACM contracts

Modulul **ACM contracts** conține autorizările fără care nicio solicitare ACM nu reușește. Un contract asociază **agenți ACM**, **utilizatori ACM**, **aliasuri** din Vault și — la alegere — fie toate aplicațiile, fie o listă de **aplicații ACM**, în unul sau mai multe **site**. În plus, poate fi valabil numai în anumite perioade.

> **Disponibilitatea ACM**
>
> Ecranul **ACM** și cele cinci module ale sale apar în consolă numai atunci când ACM este permis: sunt necesare atât o **licență** care acoperă ACM, cât și opțiunea **Allow ACM usage** bifată pentru organizație, în consola de sistem.

## Lista contractelor

Fiecare rând afișează numele contractului, precedat de o pictogramă de lacăt, apoi **numărul** de elemente asociate în fiecare dimensiune.

| Coloană | Conținut |
|---|---|
| **Name** | Numele contractului. |
| **ACM users** | Numărul de utilizatori ACM acoperiți. |
| **ACM agents** | Numărul de agenți ACM acoperiți. |
| **Sites** | Numărul de site în care se aplică contractul. |
| **ACM applications** | Numărul de aplicații autorizate sau **All** în cursiv atunci când contractul nu este restrâns la o listă. |
| **Alias** | Numărul de aliasuri accesibile din Vault. |

Câmpul de căutare filtrează după numele contractului, dar și după **numele executabilului** al aplicațiilor, după **identificatorul** utilizatorilor și după **numele** și **hostul** agenților. Atât timp cât nu există niciun contract, tabelul indică **No available ACM contracts**.

> **Extindeți un rând pentru a vedea detaliile**
>
> Săgeata de la începutul unui rând extinde contractul și enumeră, câte un rând pe dimensiune, elementele efectiv asociate — utilizatori, agenți, site, aplicații, apoi aliasuri. Un indiciu repetă aceleași informații în formă etichetată („User: ” / „Users: ”, „ACM agent: ” / „ACM agents: ”, „Site: ” / „Sites: ”, „Application: ” / „Applications: ”, „Alias: ” / „Aliases: ”). Eticheta urmează numărul de elemente.

### Acțiuni din bara de instrumente

| Acțiune | Disponibilitate | Efect |
|---|---|---|
| **+** — indiciu **Add** | Întotdeauna | Deschide formularul de creare (consultați capitolul [Adăugarea unui contract](#add-a-contract)). |
| Pictograma de editare — indiciu **Properties** | Selecție = 1 | Deschide același formular, precompletat. |
| **×** — indiciu **Delete** | Selecție ≥ 1 | Solicită o confirmare (consultați capitolul [Ștergerea unui contract](#delete-a-contract)). |
| **Export** | Întotdeauna | Descarcă contractele în format CSV (consultați capitolul [Exportarea contractelor](#export-the-contracts)). |
| **Import** | Întotdeauna | Deschide expertul de import CSV (consultați capitolul [Importarea contractelor](#import-contracts)). |

## Adăugarea unui contract

Faceți clic pe **+**. Se deschide fereastra **Add ACM contract**. Aceasta constă dintr-un antet comun și o navigare cu **șase taburi**, care trebuie parcurse în ordine la creare: butonul de trimitere devine activ numai după ce fiecare tab este valid.

### Antet

| Câmp | Descriere |
|---|---|
| **Name** | Obligatoriu, unic. Până la 256 de caractere. O valoare formată numai din spații este refuzată. |
| **Description** | Opțional. Până la 256 de caractere. |

### Taburi

Primele cinci taburi funcționează în același mod: o **listă dublă**, elementele disponibile în stânga, elementele reținute în dreapta, cu un buton de selectare totală.

**ACM agents**

> Agenți ACM declarați în modulul [ACM agents](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/AcmAgents/). Este necesar **cel puțin un agent**. Dacă nu este declarat niciun agent, lista indică **No agents**.

**Sites**

> Site în care se aplică contractul. Este necesar **cel puțin un site**. Dacă nu există niciun site, lista indică **No Sites**.

**ACM applications**

> Conținutul tabului este condiționat de caseta de selectare **Only allow specific applications**.
>
> | Starea casetei | Efect |
> |---|---|
> | **Bifată** *(stare inițială la creare)* | Contractul acoperă numai aplicațiile reținute în listă. Este atunci necesară **cel puțin o aplicație**, altfel tabul rămâne nevalid. |
> | **Nebifată** | Contractul acoperă **toate** aplicațiile, iar conținutul listei este ignorat. Coloana **ACM applications** a tabelului indică atunci **All**. |
>
> Aplicațiile propuse sunt cele ale modulului [ACM applications](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/AcmApplications/); dacă nu este declarată niciuna, lista indică **No applications**.

**ACM users**

> Utilizatori ACM declarați în modulul [ACM users](https://docs.cyberelements.io/bastion/4.6/ro/Usage/AdminConsoleReference/AcmUsers/). Este necesar **cel puțin un utilizator**. Dacă nu este declarat niciunul, lista indică **No users**.

**Alias**

> Aliasuri din Vault. Fiecare alias este urmat, între paranteze, de contul pe care îl deține, sub forma `domain\name` (sau numai numele contului atunci când acesta nu are domeniu). Este necesar **cel puțin un alias**. Dacă Vault nu expune niciunul, lista indică **No alias**.

**Restrictions**

> Patru restricții independente și cumulative. Fiecare este activată de propria casetă de selectare; câmpurile corespunzătoare rămân **dezactivate** până când aceasta este bifată.
>
> | Casetă de selectare | Câmpuri activate |
> |---|---|
> | **Date:** | **Beginning date** și **End Date**, în formatul `dd/mm/yyyy`. Data de sfârșit este readusă la data de început atunci când o precede. |
> | **Hour** | **Starting hour** și **Ending hour**. Orele sunt afișate în fusul orar al consolei. Cele două valori trebuie să difere, altfel câmpul **Ending hour** semnalează „Ending hour cannot be equal to starting hour”. |
> | **Month:** | Douăsprezece casete de selectare, câte una pe lună, etichetate cu **inițiala** lor. Toate sunt bifate la activarea restricției și cel puțin una trebuie să rămână bifată. |
> | **Day of the week** | Șapte casete de selectare, câte una pe zi, etichetate cu **inițiala** lor. Toate sunt bifate la activarea restricției și cel puțin una trebuie să rămână bifată. |
>
> Sub formular, un text rezumă în cuvinte simple efectul restricțiilor și se actualizează la fiecare modificare: fie **The current contract allows connections without restriction.**, fie **The current contract allows connections with following restrictions:** urmat de câte un punct pe restricție activă — „Connections are allowed from … to …”, „… from … to …”, „… in ”, „… on ”.

Faceți clic pe **Validate** pentru a salva.

> **Nume deja utilizat**
>
> Dacă numele este deja purtat de un alt contract, salvarea este refuzată cu mesajul **An ACM contract already has this name.**

## Modificarea unui contract

Selectați un rând, apoi faceți clic pe pictograma **Properties** (sau dublu clic). Fereastra **Edit ACM contract** afișează același formular, cu selecțiile curente preîncărcate în fiecare tab, inclusiv restricțiile. Un contract care acoperă toate aplicațiile se deschide cu caseta de selectare a tabului **ACM applications** nebifată.

## Ștergerea unui contract

Selectați unul sau mai multe rânduri, apoi faceți clic pe **×**. Se solicită o confirmare. Ștergerea afectează numai contractul: agenții, aplicațiile, utilizatorii și aliasurile pe care le numea rămân — și pot fi din nou șterse dacă niciun alt contract nu le referențiază.

## Exportarea contractelor

Butonul **Export** descarcă un fișier `acm_contracts.csv`, separat prin punct și virgulă, care descrie contractele afișate. Câte o coloană pe dimensiune a contractului:

| Coloană | Conținut |
|---|---|
| **Name**, **Description** | Antetul contractului. |
| **Allow any application** | Boolean: adevărat atunci când contractul nu este restrâns la o listă de aplicații. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Liste ale elementelor asociate, desemnate prin numele lor (numele executabilului pentru aplicații, identificatorul pentru utilizatori). |
| **Beginning date**, **End Date** | Limitele de validitate, atunci când restricția de dată este activă. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Restricții periodice. ⚠ Intervalele orare sunt exportate în **GMT**, în timp ce ecranul le afișează în fusul orar al consolei. |

## Importarea contractelor

Butonul **Import** deschide expertul de import al consolei, care așteaptă un CSV ce conține coloanele de mai sus — un export servește prin urmare drept șablon. Numai coloana **Name** este obligatorie; un contract cu un nume deja folosit este semnalat ca duplicat.

> **Un import poate crea aplicații și utilizatori**
>
> **ACM applications** și **ACM users** numiți de fișier și care nu există încă sunt **create** pe parcurs, cu condiția ca valoarea lor să fie validă (cale de executabil, identificator de cont). **ACM agents** și **site**, în schimb, trebuie să existe în prealabil: importul nu le creează.
