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

# ACM agents

O módulo **ACM agents** declara e controla os agentes ACM implementados nas máquinas remotas. Um agente ACM é executado como serviço do Windows na máquina e acede ao serviço ACM publicado por um Edge Gateway do Bastion para obter as palavras-passe de que as aplicações locais necessitam. Um administrador utiliza utiliza-o para criar uma ficha de agente, implementar ou retirar o serviço remotamente e gerar o material de configuração a incorporar na máquina.

> **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. Se faltar uma delas, o ecrã fica oculto e qualquer operação ACM é recusada.

## Lista de agentes

| Coluna | Descrição |
|---|---|
| **Name** | Identificador único do agente. |
| **Description** | Texto livre. |
| **Host** | Nome da máquina onde o agente está (ou vai estar) implementado. |

O campo de pesquisa da barra de ferramentas filtra por esses três valores ao mesmo tempo. Enquanto não existir nenhum agente, a grelha indica **No agents**.

### Ações da barra de ferramentas

As ações que operam sobre um agente existente permanecem desativadas até que a seleção o permita.

| Ação | Disponibilidade | Efeito |
|---|---|---|
| **+** — dica **Add** | Sempre | Abre o formulário de criação (ver capítulo [Adicionar um agente](#add-an-agent)). |
| Í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 agente](#delete-an-agent)). |
| **Deploy Agent** | Seleção ≥ 1 | Instala o serviço nas máquinas dos agentes selecionados (ver capítulo [Deploy Agent](#deploy-agent)). |
| **Remove Agent** | Seleção ≥ 1 | Desinstala o serviço remotamente (ver capítulo [Remove Agent](#remove-agent)). |
| **Download configuration** | Seleção = 1 | Produz o pacote de configuração do agente (ver capítulo [Download configuration](#download-configuration)). |

Fazer duplo clique numa linha equivale a **Properties**.

## Adicionar um agente

Clique em **+**. Abre-se a janela **Add ACM agent**. Todos os campos são obrigatórios exceto a descrição.

| Campo | Descrição |
|---|---|
| **Name** | Único. Até 1024 caracteres. |
| **Description** | Opcional. Até 256 caracteres. |
| **Host** | Nome da máquina de destino. Até 1024 caracteres. |

Clique em **Validate**. Declarar um agente **não implementa nada**: apenas regista a entrada.

> **Nome já utilizado**
>
> Se o nome já existir, o servidor recusa a adição com a mensagem **An ACM agent already has this name.**

## Modificar um agente

Selecione uma linha e clique no ícone **Properties** (ou faça duplo clique). A janela **Edit ACM agent** apresenta os mesmos campos.

## Eliminar um agente

Selecione uma ou várias linhas e clique em **×**. É pedida uma confirmação.

> **Agente utilizado por um contrato ACM**
>
> Um agente que apareça num **ACM contract** não pode ser eliminado. A operação não é totalmente cancelada: os agentes não utilizados **são eliminados** e uma mensagem de erro enumera os **agentes conservados** — «The following elements is currently associated with one or more ACM contract, and thus cannot be deleted:» seguido dos respetivos nomes. Para os eliminar, retire-os primeiro desses contratos.

## Deploy Agent

Selecione um ou vários agentes e clique em **Deploy Agent**. A janela com o mesmo nome solicita os parâmetros de implementação. Todos os campos são obrigatórios.

| Campo | Descrição |
|---|---|
| **Host** | Apenas de leitura. Máquinas dos agentes selecionados, separadas por vírgulas. |
| **Gateway** | Edge Gateway que dirige a implementação. Só são propostos os Edge Gateway **com gravação**. |
| **Domain** | Domínio da conta utilizada para abrir a sessão remota. |
| **Username** | Conta autorizada a instalar software na máquina. |
| **Password** | Palavra-passe correspondente (oculta). |
| **Target drive** | Letra da unidade de instalação. Valor predefinido: `c`. |
| **Target directory** | Caminho nessa unidade. Valor predefinido: `Program Files (x86)\Systancia\ACMAgent`. Até 1024 caracteres. |

Ao submeter, a grelha bloqueia na mensagem **Deployment in progress...**.

| Resultado | Resposta |
|---|---|
| Um único agente | Uma mensagem: **Agent deployment succeeded**, **Deployment failed**, **Agent already present**, ou a recusa por permissões. |
| Vários agentes | A janela **Agent deployment log**, com uma linha por agente na forma `name (host)`, com o estado **Success**, **Failure** ou **Agent already present**. |

## Remove Agent

Selecione um ou vários agentes e clique em **Remove Agent**. O formulário apresenta **Host**, **Gateway**, **Domain**, **Username** e **Password** — os dois campos próprios da instalação não são solicitados. A grelha apresenta **Deletion in progress...** e depois o resultado é apresentado da mesma forma: uma mensagem (**The agent is not present on the server.** ou **The agent is in use and can not be deleted.**) para um único agente e a janela **Agent removal log** para além disso, onde o estado **Agent not present** substitui **Agent already present**.

> **O registo permanece declarado**
>
> Remover o serviço não remove o agente da lista: o registo permanece e pode servir uma nova implementação. Para o apagar, utilize **×** (capítulo [Eliminar um agente](#delete-an-agent)).

## Download configuration

Selecione **exatamente um** agente e clique em **Download configuration**. A janela solicita apenas o **Host** (apenas de leitura) e o **Gateway**. Ao submeter, o navegador transfere um ficheiro `<agent name>.zip` que contém:

| Ficheiro | Conteúdo |
|---|---|
| `<agent name>.p12` | Certificado de cliente do agente, gerado a pedido. |
| `ca.crt` | Certificado da autoridade que assina o serviço ACM. |
| `configuration.xml` | Caminho do certificado de cliente e endereços `fqdn:port` do serviço ACM publicado pelo Edge Gateway escolhido. |
| `readme.txt` | As três operações a realizar na máquina. |

Este modo serve para a implementação **manual** do agente, quando a instalação remota não é possível. O `readme.txt` indica o procedimento: importar `ca.crt` para as autoridades de certificação de raiz de confiança **do computador local**, copiar os ficheiros para a pasta de instalação do agente e reiniciar depois o serviço **Cleanroom Credentials Manager**.

> **Falha de geração**
>
> Se o pacote não puder ser produzido, é apresentada a mensagem **An error occured while generating configuration**. O Edge Gateway deve estar **online**: é ele que fornece a porta do serviço ACM.
