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

# ACM contracts

O módulo **ACM contracts** contém as autorizações sem as quais nenhum pedido ACM é bem-sucedido. Um contrato associa **agentes ACM**, **utilizadores ACM**, **alias** do Vault e — por opção — todas as aplicações ou uma lista de **aplicações ACM**, em um ou vários **sites**. Além disso, pode ser válido apenas durante determinados períodos.

> **Disponibilidade do ACM**
>
> O ecrã **ACM** e os seus cinco módulos só aparecem na consola quando o ACM é permitido: são necessárias tanto uma **licença** que cubra o ACM como a opção **Allow ACM usage** assinalada para a organização, na consola de sistema.

## Lista de contratos

Cada linha apresenta o nome do contrato, precedido de um ícone de cadeado, e depois o **número** de elementos associados em cada dimensão.

| Coluna | Conteúdo |
|---|---|
| **Name** | Nome do contrato. |
| **ACM users** | Número de utilizadores ACM cobertos. |
| **ACM agents** | Número de agentes ACM cobertos. |
| **Sites** | Número de sites onde o contrato se aplica. |
| **ACM applications** | Número de aplicações autorizadas, ou **All** em itálico quando o contrato não está restringido a uma lista. |
| **Alias** | Número de alias do Vault acessíveis. |

O campo de pesquisa filtra pelo nome do contrato, mas também pelo **nome do executável** das aplicações, pelo **identificador** dos utilizadores e pelo **nome** e **host** dos agentes. Enquanto não existir nenhum contrato, a grelha indica **No available ACM contracts**.

> **Expanda uma linha para ver o detalhe**
>
> A seta no início de uma linha expande o contrato e enumera, uma linha por dimensão, os elementos efetivamente associados — utilizadores, agentes, sites, aplicações e depois alias. Uma dica repete a mesma informação em forma etiquetada («User: » / «Users: », «ACM agent: » / «ACM agents: », «Site: » / «Sites: », «Application: » / «Applications: », «Alias: » / «Aliases: »). A etiqueta segue o número de elementos.

### Ações da barra de ferramentas

| Ação | Disponibilidade | Efeito |
|---|---|---|
| **+** — dica **Add** | Sempre | Abre o formulário de criação (ver capítulo [Adicionar um contrato](#add-a-contract)). |
| Ícone de edição — dica **Properties** | Seleção = 1 | Abre o mesmo formulário, previamente preenchido. |
| **×** — dica **Delete** | Seleção ≥ 1 | Pede uma confirmação (ver capítulo [Eliminar um contrato](#delete-a-contract)). |
| **Export** | Sempre | Transfere os contratos em CSV (ver capítulo [Exportar os contratos](#export-the-contracts)). |
| **Import** | Sempre | Abre o assistente de importação CSV (ver capítulo [Importar contratos](#import-contracts)). |

## Adicionar um contrato

Clique em **+**. Abre-se a janela **Add ACM contract**. É composta por um cabeçalho comum e por uma navegação de **seis separadores**, a percorrer por ordem na criação: o botão de submissão só fica ativo quando todos os separadores são válidos.

### Cabeçalho

| Campo | Descrição |
|---|---|
| **Name** | Obrigatório, único. Até 256 caracteres. Um valor composto apenas por espaços é recusado. |
| **Description** | Opcional. Até 256 caracteres. |

### Separadores

Os cinco primeiros separadores funcionam do mesmo modo: uma **lista dupla**, com os elementos disponíveis à esquerda, os elementos retidos à direita, e um botão de seleção total.

**ACM agents**

> Agentes ACM declarados no módulo [ACM agents](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/AcmAgents/). É necessário **pelo menos um agente**. Se não estiver declarado nenhum agente, a lista indica **No agents**.

**Sites**

> Sites onde o contrato se aplica. É necessário **pelo menos um site**. Se não existir nenhum site, a lista indica **No Sites**.

**ACM applications**

> O conteúdo do separador está condicionado pela caixa de verificação **Only allow specific applications**.
>
> | Estado da caixa de verificação | Efeito |
> |---|---|
> | **Selecionada** *(estado inicial na criação)* | O contrato só cobre as aplicações retidas na lista. É então necessária **pelo menos uma aplicação**; caso contrário, o separador permanece inválido. |
> | **Não selecionada** | O contrato cobre **todas** as aplicações e o conteúdo da lista é ignorado. A coluna **ACM applications** da grelha indica então **All**. |
>
> As aplicações propostas são as do módulo [ACM applications](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/AcmApplications/); se não estiver declarada nenhuma, a lista indica **No applications**.

**ACM users**

> Utilizadores ACM declarados no módulo [ACM users](https://docs.cyberelements.io/bastion/4.6/pt/Usage/AdminConsoleReference/AcmUsers/). É necessário **pelo menos um utilizador**. Se não estiver declarado nenhum, a lista indica **No users**.

**Alias**

> Alias do Vault. Cada alias é seguido, entre parênteses, da conta que contém, na forma `domain\name` (ou apenas o nome da conta quando não tem domínio). É necessário **pelo menos um alias**. Se o Vault não expor nenhum, a lista indica **No alias**.

**Restrictions**

> Quatro restrições independentes e cumulativas. Cada uma é ativada pela sua própria caixa de verificação; os campos correspondentes permanecem **desativados** até que esta seja selecionada.
>
> | Caixa de verificação | Campos ativados |
> |---|---|
> | **Date:** | **Beginning date** e **End Date**, no formato `dd/mm/yyyy`. A data de fim é recuada para a data de início quando a precede. |
> | **Hour** | **Starting hour** e **Ending hour**. As horas são apresentadas no fuso horário da consola. Os dois valores devem ser diferentes; caso contrário, o campo **Ending hour** indica «Ending hour cannot be equal to starting hour». |
> | **Month:** | Doze caixas de verificação, uma por mês, etiquetadas com a respetiva **inicial**. Todas ficam selecionadas quando a restrição é ativada, e pelo menos uma deve permanecer selecionada. |
> | **Day of the week** | Sete caixas de verificação, uma por dia, etiquetadas com a respetiva **inicial**. Todas ficam selecionadas quando a restrição é ativada, e pelo menos uma deve permanecer selecionada. |
>
> Abaixo do formulário, um texto resume o efeito das restrições em palavras correntes e é atualizado a cada alteração: ou **The current contract allows connections without restriction.**, ou **The current contract allows connections with following restrictions:** seguido de um ponto por restrição ativa — «Connections are allowed from … to …», «… from … to …», «… in », «… on ».

Clique em **Validate** para guardar.

> **Nome já utilizado**
>
> Se o nome já for utilizado por outro contrato, a gravação é recusada com a mensagem **An ACM contract already has this name.**

## Modificar um contrato

Selecione uma linha e clique no ícone **Properties** (ou faça duplo clique). A janela **Edit ACM contract** apresenta o mesmo formulário, com as seleções atuais previamente carregadas em todos os separadores, restrições incluídas. Um contrato que cobre todas as aplicações abre com a caixa de verificação do separador **ACM applications** não selecionada.

## Eliminar um contrato

Selecione uma ou várias linhas e clique em **×**. É pedida uma confirmação. A eliminação apenas afeta o contrato: os agentes, aplicações, utilizadores e alias que nomeava permanecem — e podem voltar a ser eliminados se nenhum outro contrato os referenciar.

## Exportar os contratos

O botão **Export** transfere um ficheiro `acm_contracts.csv`, separado por ponto e vírgula, que descreve os contratos apresentados. Uma coluna por dimensão do contrato:

| Coluna | Conteúdo |
|---|---|
| **Name**, **Description** | Cabeçalho do contrato. |
| **Allow any application** | Booleano: verdadeiro quando o contrato não está restringido a uma lista de aplicações. |
| **ACM applications**, **ACM agents**, **Alias**, **Sites**, **ACM users** | Listas dos elementos associados, designados pelo respetivo nome (nome do executável nas aplicações, identificador nos utilizadores). |
| **Beginning date**, **End Date** | Limites de validade, quando a restrição de data está ativa. |
| **Months**, **Days of the week**, **Timeframe (GMT)** | Restrições periódicas. ⚠ Os intervalos horários são exportados em **GMT**, enquanto o ecrã os apresenta no fuso horário da consola. |

## Importar contratos

O botão **Import** abre o assistente de importação da consola, que espera um CSV com as colunas anteriores — uma exportação serve portanto de modelo. Só a coluna **Name** é obrigatória; um contrato cujo nome já esteja ocupado é indicado como duplicado.

> **Uma importação pode criar aplicações e utilizadores**
>
> As **ACM applications** e os **ACM users** nomeados pelo ficheiro que ainda não existam são **criados** pelo caminho, desde que o respetivo valor seja válido (caminho de executável, identificador de conta). Os **ACM agents** e os **sites**, em contrapartida, devem existir previamente: a importação não os cria.
