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

# ACM contracts

Il modulo **ACM contracts** contiene le autorizzazioni senza le quali nessuna richiesta ACM può andare a buon fine. Un contratto collega **agenti ACM**, **utenti ACM**, **alias** del Vault e — a scelta — tutte le applicazioni oppure un elenco di **applicazioni ACM**, in uno o più **siti**. Può inoltre essere valido soltanto durante determinati periodi.

> **Disponibilità di ACM**
>
> La schermata **ACM** e i suoi cinque moduli appaiono nella console solo quando ACM è consentito: sono necessarie sia una **licenza** che copra ACM sia l'opzione **Allow ACM usage** selezionata per l'organizzazione, nella console di sistema.

## Elenco dei contratti

Ogni riga mostra il nome del contratto, preceduto da un'icona a forma di lucchetto, poi il **numero** di elementi associati in ciascuna dimensione.

| Colonna | Contenuto |
|---|---|
| **Name** | Nome del contratto. |
| **ACM users** | Numero di utenti ACM coperti. |
| **ACM agents** | Numero di agenti ACM coperti. |
| **Sites** | Numero di siti in cui si applica il contratto. |
| **ACM applications** | Numero di applicazioni autorizzate, oppure **All** in corsivo quando il contratto non è limitato a un elenco. |
| **Alias** | Numero di alias del Vault accessibili. |

Il campo di ricerca filtra sul nome del contratto, ma anche sul **nome dell'eseguibile** delle applicazioni, sull'**identificativo** degli utenti e sul **nome** e sull'**host** degli agenti. Fino a quando non esiste alcun contratto, la griglia visualizza **No available ACM contracts**.

> **Espandere una riga per vederne il dettaglio**
>
> La freccia all'inizio di una riga espande il contratto ed elenca, una riga per dimensione, gli elementi effettivamente associati — utenti, agenti, siti, applicazioni e infine alias. Un tooltip riporta le stesse informazioni in forma etichettata («User: » / «Users: », «ACM agent: » / «ACM agents: », «Site: » / «Sites: », «Application: » / «Applications: », «Alias: » / «Aliases: »). L'etichetta segue il numero di elementi.

### Azioni della barra degli strumenti

| Azione | Disponibilità | Effetto |
|---|---|---|
| **+** — tooltip **Add** | Sempre | Apre la maschera di creazione (vedere il capitolo [Aggiungere un contratto](#add-a-contract)). |
| Icona di modifica — tooltip **Properties** | Selezione = 1 | Apre la stessa maschera, precompilata. |
| **×** — tooltip **Delete** | Selezione ≥ 1 | Richiede una conferma (vedere il capitolo [Eliminare un contratto](#delete-a-contract)). |
| **Export** | Sempre | Scarica i contratti in formato CSV (vedere il capitolo [Esportare i contratti](#export-the-contracts)). |
| **Import** | Sempre | Apre la procedura guidata di importazione CSV (vedere il capitolo [Importare i contratti](#import-contracts)). |

## Aggiungere un contratto

Fare clic su **+**. Si apre la finestra **Add ACM contract**. È composta da un'intestazione comune e da una navigazione a **sei schede**, da percorrere in ordine durante la creazione: il pulsante di invio diventa attivo solo quando tutte le schede sono valide.

### Intestazione

| Campo | Descrizione |
|---|---|
| **Name** | Obbligatorio, univoco. Fino a 256 caratteri. Un valore composto solo da spazi viene rifiutato. |
| **Description** | Facoltativo. Fino a 256 caratteri. |

### Schede

Le prime cinque schede funzionano nello stesso modo: un **elenco doppio**, con gli elementi disponibili a sinistra, gli elementi selezionati a destra e un pulsante di selezione totale.

**ACM agents**

> Agenti ACM dichiarati nel modulo [ACM agents](https://docs.cyberelements.io/bastion/4.6/it/Usage/AdminConsoleReference/AcmAgents/). È necessario **almeno un agente**. Se non è dichiarato alcun agente, l'elenco visualizza **No agents**.

**Sites**

> Siti in cui si applica il contratto. È necessario **almeno un sito**. Se non esiste alcun sito, l'elenco visualizza **No Sites**.

**ACM applications**

> Il contenuto della scheda è subordinato alla casella di controllo **Only allow specific applications**.
>
> | Stato della casella | Effetto |
> |---|---|
> | **Selezionata** *(stato iniziale durante la creazione)* | Il contratto copre solo le applicazioni selezionate nell'elenco. È quindi necessaria **almeno un'applicazione**, altrimenti la scheda resta non valida. |
> | **Non selezionata** | Il contratto copre **tutte** le applicazioni e il contenuto dell'elenco viene ignorato. La colonna **ACM applications** della griglia visualizza allora **All**. |
>
> Le applicazioni proposte sono quelle del modulo [ACM applications](https://docs.cyberelements.io/bastion/4.6/it/Usage/AdminConsoleReference/AcmApplications/); se non ne è dichiarata alcuna, l'elenco visualizza **No applications**.

**ACM users**

> Utenti ACM dichiarati nel modulo [ACM users](https://docs.cyberelements.io/bastion/4.6/it/Usage/AdminConsoleReference/AcmUsers/). È necessario **almeno un utente**. Se non ne è dichiarato alcuno, l'elenco visualizza **No users**.

**Alias**

> Alias del Vault. Ogni alias è seguito, tra parentesi, dall'account che contiene, nella forma `domain\name` (o dal solo nome dell'account quando non ha dominio). È necessario **almeno un alias**. Se il Vault non ne espone alcuno, l'elenco visualizza **No alias**.

**Restrictions**

> Quattro restrizioni indipendenti e cumulative. Ciascuna viene abilitata dalla propria casella di controllo; i campi corrispondenti restano **disabilitati** fino a quando non viene selezionata.
>
> | Casella di controllo | Campi abilitati |
> |---|---|
> | **Date:** | **Beginning date** e **End Date**, nel formato `dd/mm/yyyy`. La data di fine viene riportata alla data di inizio quando la precede. |
> | **Hour** | **Starting hour** e **Ending hour**. Le ore vengono visualizzate nel fuso orario della console. I due valori devono essere diversi, altrimenti il campo **Ending hour** segnala «Ending hour cannot be equal to starting hour». |
> | **Month:** | Dodici caselle di controllo, una per mese, etichettate con la rispettiva **iniziale**. Vengono selezionate tutte quando la restrizione è abilitata e almeno una deve restare selezionata. |
> | **Day of the week** | Sette caselle di controllo, una per giorno, etichettate con la rispettiva **iniziale**. Vengono selezionate tutte quando la restrizione è abilitata e almeno una deve restare selezionata. |
>
> Sotto la maschera, un testo riassume l'effetto delle restrizioni in parole semplici e si aggiorna a ogni modifica: **The current contract allows connections without restriction.** oppure **The current contract allows connections with following restrictions:** seguito da un punto elenco per ciascuna restrizione attiva — «Connections are allowed from … to …», «… from … to …», «… in », «… on ».

Fare clic su **Validate** per salvare.

> **Nome già utilizzato**
>
> Se il nome è già utilizzato da un altro contratto, il salvataggio viene rifiutato con il messaggio **An ACM contract already has this name.**

## Modificare un contratto

Selezionare una riga e fare clic sull'icona **Properties** (o fare doppio clic). La finestra **Edit ACM contract** mostra la stessa maschera, con le selezioni correnti precaricate in tutte le schede, restrizioni incluse. Un contratto che copre tutte le applicazioni si apre con la casella di controllo della scheda **ACM applications** non selezionata.

## Eliminare un contratto

Selezionare una o più righe e fare clic su **×**. Viene richiesta una conferma. L'eliminazione riguarda solo il contratto: gli agenti, le applicazioni, gli utenti e gli alias che nominava restano — e diventano di nuovo eliminabili se nessun altro contratto li referenzia.

## Esportare i contratti

Il pulsante **Export** scarica un file `acm_contracts.csv`, con separatore punto e virgola, che descrive i contratti visualizzati. Una colonna per ciascuna dimensione del contratto:

| Colonna | Contenuto |
|---|---|
| **Name**, **Description** | Intestazione del contratto. |
| **Allow any application** | Valore booleano: vero quando il contratto non è limitato a un elenco di applicazioni. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Elenchi degli elementi associati, indicati dal loro nome (nome dell'eseguibile per le applicazioni, identificativo per gli utenti). |
| **Beginning date**, **End Date** | Limiti di validità, quando la restrizione di data è attiva. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Restrizioni periodiche. ⚠ Le fasce orarie vengono esportate in **GMT**, mentre la schermata le visualizza nel fuso orario della console. |

## Importare i contratti

Il pulsante **Import** apre la procedura guidata di importazione della console, che si aspetta un CSV con le colonne indicate sopra — un'esportazione funge quindi da modello. Solo la colonna **Name** è obbligatoria; un contratto il cui nome è già utilizzato viene segnalato come duplicato.

> **Un'importazione può creare applicazioni e utenti**
>
> Le **ACM applications** e gli **ACM users** nominati dal file che non esistono ancora vengono **creati** durante l'operazione, purché il loro valore sia valido (percorso dell'eseguibile, identificativo dell'account). Gli **ACM agents** e i **siti**, invece, devono esistere in precedenza: l'importazione non li crea.
