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

# ACM contracts

El módulo **ACM contracts** contiene las autorizaciones sin las cuales ninguna solicitud ACM se completa. Un contrato vincula **agentes ACM**, **usuarios ACM**, **alias** de la bóveda y — según se elija — todas las aplicaciones o una lista de **aplicaciones ACM**, en uno o varios **sitios**. Además, puede ser válido únicamente durante determinados periodos.

> **Disponibilidad de ACM**
>
> La pantalla **ACM** y sus cinco módulos solo aparecen en la consola cuando ACM está permitido: se requieren a la vez una **licencia** que cubra ACM y la opción **Allow ACM usage** marcada para la organización, en la consola de sistema.

## Lista de contratos

Cada fila muestra el nombre del contrato, precedido de un icono de candado, y después el **número** de elementos asociados en cada dimensión.

| Columna | Contenido |
|---|---|
| **Name** | Nombre del contrato. |
| **ACM users** | Número de usuarios ACM cubiertos. |
| **ACM agents** | Número de agentes ACM cubiertos. |
| **Sites** | Número de sitios en los que se aplica el contrato. |
| **ACM applications** | Número de aplicaciones autorizadas, o **All** en cursiva cuando el contrato no está restringido a una lista. |
| **Alias** | Número de alias de la bóveda accesibles. |

El campo de búsqueda filtra por el nombre del contrato, pero también por el **nombre del ejecutable** de las aplicaciones, el **identificador** de los usuarios y el **nombre** y el **host** de los agentes. Mientras no existe ningún contrato, la cuadrícula indica **No available ACM contracts**.

> **Despliegue una fila para ver el detalle**
>
> La flecha del principio de una fila despliega el contrato y enumera, una fila por dimensión, los elementos realmente asociados — usuarios, agentes, sitios, aplicaciones y después alias. Una información contextual repite los mismos datos en forma etiquetada (« User: » / « Users: », « ACM agent: » / « ACM agents: », « Site: » / « Sites: », « Application: » / « Applications: », « Alias: » / « Aliases: »). La etiqueta sigue al número de elementos.

### Acciones de la barra de herramientas

| Acción | Disponibilidad | Efecto |
|---|---|---|
| **+** — información contextual **Add** | Siempre | Abre el formulario de creación (véase el capítulo [Añadir un contrato](#add-a-contract)). |
| Icono de edición — información contextual **Properties** | Selección = 1 | Abre el mismo formulario, precargado. |
| **×** — información contextual **Delete** | Selección ≥ 1 | Solicita una confirmación (véase el capítulo [Eliminar un contrato](#delete-a-contract)). |
| **Export** | Siempre | Descarga los contratos en CSV (véase el capítulo [Exportar los contratos](#export-the-contracts)). |
| **Import** | Siempre | Abre el asistente de importación CSV (véase el capítulo [Importar contratos](#import-contracts)). |

## Añadir un contrato

Pulse **+**. Se abre la ventana **Add ACM contract**. Consta de un encabezado común y de una navegación de **seis pestañas**, que deben recorrerse en orden al crear: el botón de envío solo se activa cuando todas las pestañas son válidas.

### Encabezado

| Campo | Descripción |
|---|---|
| **Name** | Obligatorio, único. Hasta 256 caracteres. Se rechaza un valor compuesto únicamente de espacios. |
| **Description** | Opcional. Hasta 256 caracteres. |

### Pestañas

Las cinco primeras pestañas funcionan del mismo modo: una **lista doble**, elementos disponibles a la izquierda, elementos retenidos a la derecha, con un botón de selección total.

**ACM agents**

> Agentes ACM declarados en el módulo [ACM agents](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/AcmAgents/). Se requiere **al menos un agente**. Si no hay ningún agente declarado, la lista indica **No agents**.

**Sites**

> Sitios en los que se aplica el contrato. Se requiere **al menos un sitio**. Si no existe ningún sitio, la lista indica **No Sites**.

**ACM applications**

> El contenido de la pestaña está condicionado por la casilla **Only allow specific applications**.
>
> | Estado de la casilla | Efecto |
> |---|---|
> | **Marcada** *(estado inicial al crear)* | El contrato solo cubre las aplicaciones retenidas en la lista. Se requiere entonces **al menos una aplicación**; de lo contrario, la pestaña permanece no válida. |
> | **Sin marcar** | El contrato cubre **todas** las aplicaciones, y el contenido de la lista se ignora. La columna **ACM applications** de la cuadrícula indica entonces **All**. |
>
> Las aplicaciones propuestas son las del módulo [ACM applications](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/AcmApplications/); si no se ha declarado ninguna, la lista indica **No applications**.

**ACM users**

> Usuarios ACM declarados en el módulo [ACM users](https://docs.cyberelements.io/bastion/4.6/es/Usage/AdminConsoleReference/AcmUsers/). Se requiere **al menos un usuario**. Si no se ha declarado ninguno, la lista indica **No users**.

**Alias**

> Alias de la bóveda. Cada alias va seguido, entre paréntesis, de la cuenta que contiene, con la forma `dominio\nombre` (o solo el nombre de la cuenta cuando no tiene dominio). Se requiere **al menos un alias**. Si la bóveda no expone ninguno, la lista indica **No alias**.

**Restrictions**

> Cuatro restricciones independientes y acumulativas. Cada una se activa mediante su propia casilla; los campos correspondientes permanecen **desactivados** hasta que se marca.
>
> | Casilla | Campos activados |
> |---|---|
> | **Date:** | **Beginning date** y **End Date**, con el formato `dd/mm/aaaa`. La fecha de fin se retrotrae a la de inicio cuando la precede. |
> | **Hour** | **Starting hour** y **Ending hour**. Las horas se muestran en la zona horaria de la consola. Ambos valores deben ser distintos; de lo contrario, el campo **Ending hour** indica « Ending hour cannot be equal to starting hour ». |
> | **Month:** | Doce casillas, una por mes, etiquetadas con su **inicial**. Todas quedan marcadas al activar la restricción, y al menos una debe permanecer marcada. |
> | **Day of the week** | Siete casillas, una por día, etiquetadas con su **inicial**. Todas quedan marcadas al activar la restricción, y al menos una debe permanecer marcada. |
>
> Debajo del formulario, un texto resume el efecto de las restricciones con palabras corrientes y se actualiza con cada cambio: bien **The current contract allows connections without restriction.**, bien **The current contract allows connections with following restrictions:** seguido de un punto por restricción activa — « Connections are allowed from … to … », « … from … to … », « … in  », « … on  ».

Pulse **Validate** para guardar.

> **Nombre ya utilizado**
>
> Si el nombre ya lo lleva otro contrato, el guardado se rechaza con el mensaje **An ACM contract already has this name.**

## Modificar un contrato

Seleccione una fila y pulse el icono **Properties** (o haga doble clic). La ventana **Edit ACM contract** muestra el mismo formulario, con las selecciones actuales precargadas en todas las pestañas, restricciones incluidas. Un contrato que cubre todas las aplicaciones se abre con la casilla de la pestaña **ACM applications** sin marcar.

## Eliminar un contrato

Seleccione una o varias filas y pulse **×**. Se solicita una confirmación. La eliminación solo afecta al contrato: los agentes, aplicaciones, usuarios y alias que nombraba permanecen — y vuelven a poder eliminarse si ningún otro contrato los referencia.

## Exportar los contratos

El botón **Export** descarga un fichero `acm_contracts.csv`, separado por punto y coma, que describe los contratos mostrados. Una columna por dimensión del contrato:

| Columna | Contenido |
|---|---|
| **Name**, **Description** | Encabezado del contrato. |
| **Allow any application** | Booleano: verdadero cuando el contrato no está restringido a una lista de aplicaciones. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Listas de los elementos asociados, designados por su nombre (nombre del ejecutable en las aplicaciones, identificador en los usuarios). |
| **Beginning date**, **End Date** | Límites de validez, cuando la restricción de fecha está activa. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Restricciones periódicas. ⚠ Las franjas horarias se exportan en **GMT**, mientras que la pantalla las muestra en la zona horaria de la consola. |

## Importar contratos

El botón **Import** abre el asistente de importación de la consola, que espera un CSV con las columnas anteriores — una exportación sirve por tanto de plantilla. Solo la columna **Name** es obligatoria; un contrato cuyo nombre ya esté tomado se indica como duplicado.

> **Una importación puede crear aplicaciones y usuarios**
>
> Las **ACM applications** y los **ACM users** nombrados por el fichero que aún no existan se **crean** por el camino, siempre que su valor sea válido (ruta de ejecutable, identificador de cuenta). Los **ACM agents** y los **sitios**, en cambio, deben existir previamente: la importación no los crea.
