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 simultaneamente uma licença que cubra ACM e a opção Allow ACM usage ativada para o seu tenant.
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). |
| Í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). |
| Export | Sempre | Transfere os contratos em CSV (ver capítulo Exportar os contratos). |
| Import | Sempre | Abre o assistente de importação CSV (ver capítulo Importar contratos). |
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.
Agentes ACM declarados no módulo ACM agents. É necessário pelo menos um agente. Se não estiver declarado nenhum agente, a lista indica No agents.
Sites onde o contrato se aplica. É necessário pelo menos um site. Se não existir nenhum site, a lista indica No Sites.
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; se não estiver declarada nenhuma, a lista indica No applications.
Utilizadores ACM declarados no módulo ACM users. É necessário pelo menos um utilizador. Se não estiver declarado nenhum, a lista indica No users.
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.
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
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.