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

# Request history

O módulo **Request history** regista os pedidos ACM processados: quem pediu que alias, a partir de que agente e para que aplicação, e o que foi respondido. Um administrador utiliza-o para auditar os acessos ao Vault, compreender uma recusa ou extrair um período.

> **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 pedidos

A grelha tem apenas **duas colunas**, sendo a primeira a que reúne todo o contexto do pedido.

| Coluna | Conteúdo |
|---|---|
| **Information** | Quatro a cinco linhas precedidas de um ícone: a **data** do pedido no fuso horário da consola, o **identificador** utilizado, o **agente ACM** emissor, a **aplicação** que chama e, por fim, o **alias** pedido. Um valor ausente não apresenta a sua linha. |
| **Request status** | Em negrito, o resultado exato; em itálico abaixo, a família a que pertence. |

Uma barra vertical colorida no início da linha recorda a família: azul para um sucesso, vermelho para uma falha, laranja para uma recusa.

### Resultados possíveis

| Família | Resultados |
|---|---|
| **Success** | **Success** — a palavra-passe foi entregue. |
| **Request failed** | **Server Error**, **Vault error**, **Invalid parameters**. |
| **Request denied** | **Unknown alias**, **No contract**, **No application**, **Request denied** — este último caso significa que foi encontrado um contrato mas as suas restrições não foram cumpridas. |

Enquanto não tiver sido registado nenhum pedido, a grelha indica **No request.**

## Filtrar a lista

Um painel **Filters**, contraído por predefinição, situa-se acima da grelha. Oferece três modos **exclusivos**, selecionados por botão de opção, mais um filtro de data independente.

| Modo | Descrição |
|---|---|
| **All** *(predefinido)* | Nenhum filtro sobre o conteúdo. |
| **Request status** | Um grupo de caixas de verificação em três colunas, uma por família: **Success**, **Request failed**, **Request denied**. Não selecionar nenhuma caixa equivale a selecioná-las todas. |
| **Keyword** | Subcadeia pesquisada no identificador, no alias pedido, na aplicação e no agente — **não** na data. |

| Campo | Descrição |
|---|---|
| **Date** | Caixa de verificação que ativa o filtro de período. |
| **Starting date** | No formato `dd/mm/yyyy`. Não pode ir além de hoje. |
| **Ending date** | No formato `dd/mm/yyyy`. Recuada para a data de início quando a precede, e limitada a hoje. O dia indicado está **incluído**. |

> **As secções selecionam-se sozinhas**
>
> Não é necessário clicar no botão de opção antes de escrever: selecionar uma caixa de estado ou introduzir uma palavra-chave **seleciona** o modo correspondente e **reinicia** os restantes. Do mesmo modo, alterar uma data **seleciona** a caixa **Date**. Um modo abandonado perde portanto o que foi introduzido.

Clique em **Display** para aplicar os filtros e contrair o painel, ou em **Reset** para os limpar. Quando um filtro está ativo, o título do painel passa a **Current filter**, seguido do critério retido e, se aplicável, do período.

## Exportação

O botão **Export all pages** transfere um ficheiro `acm_requests.csv`, separado por ponto e vírgula, que contém os pedidos **que correspondem aos filtros atuais** — e não apenas a página apresentada.

O ficheiro começa com um cabeçalho de contexto: uma linha **Organization** com o respetivo nome, os limites do período quando o filtro de data está ativo, e depois uma linha **Exportation date**. Após duas linhas em branco vêm as seis colunas:

| Coluna | Conteúdo |
|---|---|
| **Date** | Data do pedido, no formato ISO 8601. ⚠ Ao contrário da grelha, a exportação **não** a converte para o fuso horário da consola. |
| **ACM login** | Identificador utilizado pelo pedido. |
| **ACM agent** | Agente emissor. |
| **Alias requested** | Alias visado no Vault. |
| **ACM application** | Executável que chama. |
| **Request status** | Resultado, sob a sua **etiqueta** — nunca sob a forma de código. |
