> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ecotrust.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurar o AutoPatch

> Como usar a Config do AutoPatch: o rollback automático, os serviços críticos, a concorrência, a validação pós-deploy e o portão de liberação na aba Operação; os prazos por framework e as metas por severidade na aba Baseline.

Use este guia para definir como o AutoPatch aplica as correções no seu parque e a que prazos ele responde. Ao final, os próximos planos de correção partem dos seus padrões, e o Dashboard do AutoPatch, o Flow e o Baseline medem a correção contra as suas metas.

## Pré-requisitos

* Acesso ao painel com o módulo AutoPatch.
* Perfil **Gestor** para salvar. O **Analista avançado** consulta tudo, com o aviso de somente leitura no topo; os outros perfis não têm a aba **Config**.

## Onde fica

Na tira de abas do AutoPatch, clique em **Config**, a sexta e última posição, à direita de **Observabilidade**. As abas aparecem nesta ordem: **Operação**, **Baseline**, **MCP** e, quando o módulo tem quantidade de licenças contratada, **Licenças**.

## Na aba Operação

A aba começa pelo bloco **Escopo**, com os ativos que ficam de fora das campanhas, segue com os controles de execução e termina na seção **Campanhas**, com o tamanho de uma campanha e quem entra primeiro no piloto.

### Ativos e grupos proibidos

No bloco **Escopo**, **Ativos e grupos proibidos** lista o que nunca entra numa campanha montada ou recriada. Escolha **Ativos** ou **Grupos**, busque pelo nome (um ativo também pelo IP) e clique no resultado para incluí-lo. O **×** tira um item da lista.

Ao montar ou recriar uma campanha, a plataforma deixa de fora os ativos proibidos e diz quais foram. Quando todos os ativos escolhidos estão proibidos, a campanha não é criada.

### Campanhas

A seção **Campanhas** fica no fim da aba.

| Campo | O que faz | Padrão |
| - | - | - |
| Máximo de ativos por campanha | Quantos ativos cabem numa campanha, de 2 a 50. Acima desse número, a criação da campanha é recusada. Ao montar uma campanha pelo agente, ele diz esse limite antes de você escolher os ativos. | 50 |
| Piloto preferido | Os ativos e grupos que o piloto sorteia primeiro, escolhidos como nos proibidos. O piloto completa a amostra com os demais ativos da campanha. Sem preferidos, ele sorteia entre todos. | Nenhum |

Um ativo proibido nunca entra no piloto, mesmo quando também está entre os preferidos: a tela avisa **O proibido vence** e diz quais ficam fora.

### Controles de execução

Os controles de execução, num formulário só. Uma mudança aqui vale para os planos aprovados depois dela: um plano já aprovado segue com os valores do momento da aprovação.

| Campo | O que faz | Padrão |
| - | - | - |
| Rollback automático | **Reverter em caso de falha** ligado: o ativo volta ao estado anterior quando uma etapa da correção não conclui. Desligado: nada é revertido sozinho, e o ativo fica como a execução o deixou. | Ligado |
| Serviços críticos | Os serviços que a plataforma confere depois de cada aplicação, além dos que o próprio patch toca. Digite o nome, a porta se quiser, e clique em **Adicionar**; o **×** remove um serviço. | Nenhum |
| Concorrência | Quantos ativos recebem a correção ao mesmo tempo, de 1 a 20 (**deploys simultâneos**). | 5 |
| Validação pós-deploy | **Validar serviços após cada deploy** ligado: um serviço crítico que rodava antes e parou depois da aplicação também reverte o ativo, com o rollback automático ligado. Desligado, o serviço parado fica só registrado. | Ligada |
| Portão de liberação do parque | Decide se uma campanha pode passar da primeira onda para o parque inteiro. Em **Critério**, escolha **Percentual da amostra** (de 1 a 100, padrão 95) ou **Número de máquinas**, e informe o valor. Uma máquina conta como sucesso só quando todos os patches dela foram aplicados. | 95% da amostra |

A caixa abaixo do rollback diz o que cada escolha faz e destaca a atual. A reversão automática vale hoje para ativos Linux das famílias Debian e Red Hat acessados por SSH. Nos demais ativos, a reversão é feita pelo serviço **Rollback patch aplicado**, que também fica disponível com o rollback automático ligado ou desligado, sempre com a sua aprovação no plano; veja [Acompanhar a aplicação de um patch](https://docs.ecotrust.io/modulos/autopatch/acompanhar-a-aplicacao.md).

Num serviço crítico, use o nome do serviço como o sistema o conhece. A plataforma recusa nomes com caracteres de comando, como `;` ou `|`, um serviço repetido e mais de 50 serviços.

O portão fica depois da validação pós-deploy. O percentual arredonda para cima: 95% de uma amostra de 5 máquinas exige as 5, e a tela mostra essa conta, numa amostra de 5, para o percentual escolhido. Em amostra pequena, o **Número de máquinas** é mais previsível. Um número maior que a amostra passa a exigir todas as máquinas dela. Veja [Acompanhar as campanhas](https://docs.ecotrust.io/modulos/autopatch/acompanhar-as-campanhas.md).

## Na aba Baseline

A aba tem o bloco **Metas e limiares**, com duas seções.

### SLA por framework

Cada framework de conformidade do painel traz o prazo de correção em dias, de 1 a 365, o tempo médio para corrigir (MTTR) medido e o selo **Conforme** ou **Não conforme**, que compara os dois. O MTTR e o selo só são medidos quando há uma CVE confirmada como corrigida. Antes disso, a tela mostra **sem medida** no lugar do MTTR e o selo **Sem medida**. O prazo grava sozinho quando você sai do campo, sem a barra de salvar. A marca **padrão** ao lado de um prazo diz que ele ainda é o da plataforma. Os prazos alimentam o requisito **Conformidade por framework** da governança.

### SLA por severidade

O prazo do acordo de nível de serviço (SLA) de cada severidade, de **Crítica** a **Baixa**, de 1 a 365 dias. Os padrões são 7, 14, 30 e 60 dias. A mesma tabela é lida por três módulos:

* no AutoPatch, a meta de **TEMPO PARA CORRIGIR POR SEVERIDADE** e o requisito **SLA por severidade** da governança;
* no Flow, o prazo de cada ocorrência e a **Meta de correção por severidade** da Config dele;
* no Baseline, o controle **Correção dentro do SLA**.

## Salvar ou descartar

As abas **Operação** e **Baseline** compartilham uma barra de salvar, que aparece no pé da tela quando um valor muda. **Salvar** grava só os campos alterados, das duas abas, e **Descartar** volta aos valores salvos. O prazo por framework é a exceção: ele grava ao sair do campo. As abas **MCP** e **Licenças** gravam pelos próprios botões.

## Verificar o resultado

No [Dashboard do AutoPatch](https://docs.ecotrust.io/modulos/autopatch/painel.md), **TEMPO PARA CORRIGIR POR SEVERIDADE** mostra as metas novas, sem a marca **padrão**. O próximo plano de correção que você aprovar parte do rollback, da concorrência e dos serviços críticos salvos, e a próxima campanha que você montar respeita os proibidos, o máximo de ativos e o piloto preferido.

## Problemas comuns

> [accordion] A barra diz Não foi salvo
>
> O servidor recusou um valor e escreveu o motivo ao lado da barra, por exemplo um serviço crítico com caractere de comando. A sua edição continua na tela: corrija o campo e salve de novo, ou descarte.

> [accordion] O serviço crítico não entrou na lista
>
> A porta informada está fora do intervalo, e a tela diz **A porta vai de 1 a 65535.** Corrija a porta ou deixe o campo vazio.

> [accordion] O prazo do framework voltou ao valor anterior
>
> O campo só grava um número de 1 dia ou mais. Vazio, zero ou negativo devolve o valor salvo, e um valor acima de 365 vira 365. Se a gravação falhar, a tela diz **Não foi possível salvar o prazo**: recarregue a aba e tente de novo.

## Próximos passos

* [Conferir a governança do AutoPatch](https://docs.ecotrust.io/modulos/autopatch/conferir-a-governanca.md): os requisitos que usam as metas.
* [Conectar um MCP](https://docs.ecotrust.io/ecotrust-os/conectar-um-mcp.md), para a aba **MCP**.
* [Gerenciar uso de licenças](https://docs.ecotrust.io/console/gerenciar-uso-de-licencas.md), para a aba **Licenças**.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.