> For the complete documentation index, see [llms.txt](https://wiki.datadike.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.datadike.com/pt/sonar/administration/patching/patch-policy.md).

# Política de aprovação de atualizações

Aprove atualizações do Windows automaticamente por severidade, agende a instalação e escolha o comportamento de reinicialização, em uma política de automação ou em um dispositivo.

## O que é e quando usar

Uma política de atualizações informa ao SONAR três coisas sobre as atualizações do Windows dos dispositivos aos quais ela se aplica:

* quais atualizações são **aprovadas** automaticamente, por severidade;
* **quando** as atualizações aprovadas são instaladas;
* se o dispositivo **reinicia** depois de uma instalação.

"Aprovada" é uma marca que o servidor mantém para cada atualização em cada dispositivo. Só as atualizações aprovadas são instaladas, seja por uma execução agendada, por **Install Approved Updates** no dispositivo ou por uma instalação em massa. Uma atualização é aprovada pela política ou à mão, na aba **Updates** do dispositivo.

Uma política de atualizações fica dentro de uma política de automação e, por isso, alcança todos os dispositivos que essa política alcança. Cada dispositivo também tem a sua própria política de atualizações, usada para substituir configurações isoladas. Use a política de automação para a regra e o dispositivo para a exceção: o servidor que nunca pode reiniciar sozinho, o notebook que instala em outro dia.

Para o procedimento completo, da primeira varredura à atribuição da política, veja [Automatizar as atualizações do Windows](https://wiki.datadike.com/pt/sonar/administration/patching/automate-windows-updates.md).

## Antes de começar

* Em uma política de automação: **Manage Automation Policies** em **Admin Center › Roles**, e uma política de automação ativa e aplicada aos clientes, sites ou dispositivos desejados. Veja [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md).
* Em um dispositivo: **Edit Agent**.
* Dispositivos Windows. As políticas de atualizações não têm efeito em dispositivos Linux e macOS.
* O fuso horário dos dispositivos correto: os agendamentos rodam no horário do próprio dispositivo. Ele vem de **Timezone**, no painel lateral **Edit** do dispositivo, ou, por padrão, de **Default agent timezone** em **Admin Center › Settings › General**.

## Como a política aplicada é escolhida

Para cada dispositivo, o SONAR usa a política de atualizações da **primeira** política de automação, nesta ordem, que esteja ativa e tenha uma política de atualizações:

1. a política atribuída ao próprio dispositivo;
2. a política do site para o tipo do dispositivo (servidor ou estação de trabalho);
3. a política do cliente para o tipo do dispositivo;
4. a política padrão de servidor ou de estação de trabalho.

O bloqueio de herança e as exclusões de política se aplicam como no restante da política de automação. Só uma política de atualizações é usada; elas não são mescladas.

Em seguida, a política de atualizações do próprio dispositivo é sobreposta. Toda configuração do dispositivo diferente de **Inherit** substitui a da política:

| Configuração do dispositivo                                                    | Quando não está em **Inherit**                                                                                                                                                                        |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Uma severidade (**Critical**, **Important**, **Moderate**, **Low**, **Other**) | Substitui apenas essa severidade                                                                                                                                                                      |
| **Schedule Frequency**                                                         | Substitui a frequência, o **Scheduled Time** e os **Week Days**. **Day of month to run** continua sendo o da política de automação; por isso, defina os agendamentos mensais na política de automação |
| **Reboot After Install**                                                       | Substitui a configuração de reinicialização                                                                                                                                                           |

Quando nenhuma política de automação com política de atualizações alcança o dispositivo, as configurações do próprio dispositivo são usadas sozinhas, e **Inherit** significa: nenhuma aprovação automática, nenhuma instalação agendada, nenhuma reinicialização.

## Passos

**Em uma política de automação**

1. Abra **Management › Automations**.
2. Na linha da política, clique em **Create Patch Policy** na coluna **Patch Policy**, ou em **Modify Patch Policy** se ela já tiver uma. A mesma opção está no menu do clique com o botão direito da linha.
3. Em **Auto Approval**, escolha **Manual**, **Approve** ou **Ignore** para cada severidade.
4. Em **Installation Schedule**, escolha **Schedule Frequency** e depois **Day of month to run** ou **Week Days**, e **Scheduled Time**.
5. Em **Reboot After Installation**, escolha **Reboot After Install**.
6. Clique em **Submit**.

**Em um dispositivo**

1. Abra **Dashboard › Sysadmin** e selecione o dispositivo.
2. No menu **Other actions** (o **⋮** no cabeçalho do painel do dispositivo), escolha **Edit**.
3. Abra a aba **Patches**. Os mesmos campos aparecem, cada um com uma opção extra, **Inherit**.
4. Mude apenas as configurações que precisam ser diferentes das da política de automação. Deixe as outras em **Inherit**.
5. Clique em **Save**.

Um ponto de partida que muitas equipes usam para a política de atualizações de uma política de automação, a ser adaptado ao seu próprio processo de mudanças: **Approve** para **Critical** e **Important**, **Manual** para **Moderate**, **Low** e **Other**, uma janela semanal fora do horário de trabalho, e **Never** em **Reboot After Install** na política atribuída como **Server Policy**.

## O que você deve ver

Em uma política de automação, o console confirma com `Patch policy was created successfully!` ou `Patch policy was edited successfully!`, e a coluna **Patch Policy** da linha passa a mostrar **Modify Patch Policy**. Em um dispositivo, ele confirma com `Agent was edited!`.

O que acontece depois em cada dispositivo:

| Quando                               | O que acontece                                                                                                                                                                                                   |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| A cada 8 horas                       | O servidor aplica a aprovação automática: toda atualização ainda não instalada cuja severidade está em **Approve** é marcada como aprovada. Ele também pede uma varredura a todos os dispositivos Windows online |
| Em uma instalação manual ou em massa | A aprovação automática é aplicada primeiro e, depois, as atualizações aprovadas são instaladas                                                                                                                   |
| A cada hora                          | O servidor verifica quais dispositivos chegaram ao horário agendado, no fuso horário do dispositivo, e inicia a instalação das atualizações aprovadas deles                                                      |
| Ao final de uma instalação           | **Reboot After Install** decide se o dispositivo reinicia                                                                                                                                                        |

## Como verificar se funcionou

1. Abra o painel lateral **Edit** do dispositivo, aba **Automation Policies**. **Effective Patch Policy** mostra a aprovação por severidade, a **Run Time Frequency** e o **Reboot after installation** que valem para esse dispositivo, depois da combinação descrita acima. `Do Nothing` ali significa que nada está definido.
2. Depois do próximo ciclo de 8 horas, a aba **Updates** do dispositivo mostra as atualizações das severidades aprovadas com **Approve** e **Pending**, e a coluna **Patches Pending** do dispositivo em **Dashboard › Sysadmin** fica marcada.
3. Depois do horário agendado, a aba mostra essas atualizações como **Installed**, com uma data em **Installed On**.
4. **Reports & Audits › Audits** registra a criação, a alteração ou a remoção da política de atualizações, com os valores de antes e de depois.
5. Quando **Agent Debug Level** está em **Info** em **Admin Center › Settings › General**, a aba **Debug** do dispositivo registra `Installing windows updates on <hostname>` a cada execução agendada.

## Erros comuns

| Sintoma                                                                       | Causa                                                                                                                  | Correção                                                                                                  |
| ----------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------- |
| Nada é instalado no horário agendado                                          | Nenhuma severidade está em **Approve** na política efetiva. Uma execução agendada só acontece quando ao menos uma está | Coloque ao menos uma severidade em **Approve**, ou instale à mão                                          |
| Nada é instalado em um agendamento diário                                     | **Week Days** não tem nenhum dia selecionado                                                                           | Selecione os dias                                                                                         |
| A instalação rodou na hora errada                                             | O fuso horário do dispositivo não é o que você supunha                                                                 | Confira **Timezone** no painel lateral **Edit** do dispositivo, ou **Default agent timezone**             |
| Um dispositivo pulou a execução agendada                                      | Ele não estava online no horário agendado                                                                              | Ele instala no próximo dia agendado. Para instalar agora, use **Install Patches Now**                     |
| Uma atualização nova de uma severidade aprovada ainda não está aprovada       | A aprovação automática roda a cada 8 horas                                                                             | Aguarde o próximo ciclo, ou clique em **Install Approved Updates**, que aprova antes                      |
| O dispositivo ignora as configurações de atualização da política de automação | Uma política anterior na ordem tem a sua própria política de atualizações, ou o dispositivo substitui a configuração   | Confira **Effective Patch Policy** no painel lateral **Edit** do dispositivo                              |
| Uma instalação mensal não acontece em alguns meses                            | O dia escolhido não existe em todos os meses                                                                           | Escolha um dia de 1 a 28                                                                                  |
| Um dispositivo reiniciou no horário de trabalho                               | **Reboot After Install** está em **When Required** ou **Always**, e uma instalação rodou                               | Agende a instalação fora do horário de trabalho, ou use **Never** e reinicie em um horário de sua escolha |

## Referência de campos

| Campo                                              | O que faz                                                                                                         | Valores                                                                   | Padrão ao criar a política de atualizações em uma política de automação |
| -------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- | ----------------------------------------------------------------------- |
| **Critical**, **Important**, **Moderate**, **Low** | Aprovação automática das atualizações dessa severidade da Microsoft                                               | **Manual**, **Approve**, **Ignore**, **Inherit** (só no dispositivo)      | **Ignore**                                                              |
| **Other**                                          | O mesmo, para as atualizações às quais a Microsoft não atribui severidade, a maioria das que não são de segurança | Como acima                                                                | **Ignore**                                                              |
| **Schedule Frequency**                             | Quando as atualizações aprovadas são instaladas                                                                   | **Daily/Weekly**, **Monthly**, **Inherit** (só no dispositivo)            | **Daily/Weekly**                                                        |
| **Week Days**                                      | Com **Daily/Weekly**: os dias da semana em que a instalação roda                                                  | De segunda a domingo, vários permitidos                                   | Nenhum selecionado                                                      |
| **Day of month to run**                            | Com **Monthly**: o dia do mês                                                                                     | 1 a 31                                                                    | 1                                                                       |
| **Scheduled Time**                                 | A hora em que a instalação começa, no fuso horário do dispositivo                                                 | 12 AM a 11 PM, horas cheias                                               | 3 AM                                                                    |
| **Reboot After Install**                           | O que acontece quando uma instalação termina                                                                      | **Never**, **When Required**, **Always**, **Inherit** (só no dispositivo) | **Never**                                                               |

O que cada valor de aprovação faz:

| Valor       | Efeito                                                                                                                                                                   |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Approve** | Toda atualização dessa severidade ainda não instalada é aprovada na próxima aprovação automática, inclusive as atualizações colocadas em **Ignore** à mão no dispositivo |
| **Manual**  | Nada é aprovado automaticamente. As atualizações dessa severidade só são instaladas quando alguém as aprova à mão                                                        |
| **Ignore**  | Nada é aprovado automaticamente, como em **Manual**                                                                                                                      |
| **Inherit** | Assume o valor da política de automação                                                                                                                                  |

O que cada valor de reinicialização faz:

| Valor             | Efeito                                                                                                                            |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Never**         | O dispositivo não reinicia. **Needs Reboot** em **Dashboard › Sysadmin** mostra que o Windows está aguardando uma reinicialização |
| **When Required** | O dispositivo reinicia imediatamente quando o Windows informa que precisa                                                         |
| **Always**        | O dispositivo reinicia imediatamente ao final de toda instalação                                                                  |

{% hint style="warning" %}
Com **When Required** ou **Always**, o dispositivo reinicia assim que a instalação termina, sem avisar a pessoa que o usa; o trabalho não salvo é perdido. Na dúvida sobre se um dispositivo pode reiniciar, em particular servidores de produção, mantenha **Never**.
{% endhint %}

Em uma política de automação, **Remove Policy** exclui a política de atualizações depois de uma confirmação; os dispositivos passam então para a próxima política na ordem.

## Páginas relacionadas

* [Automatizar as atualizações do Windows](https://wiki.datadike.com/pt/sonar/administration/patching/automate-windows-updates.md)
* [Políticas de automação](https://wiki.datadike.com/pt/sonar/administration/automation/automation-policies.md)
* [Atualizações em um único dispositivo](https://wiki.datadike.com/pt/sonar/administration/patching/device-updates.md)
* [Windows Updates em todo o parque](https://wiki.datadike.com/pt/sonar/administration/patching/windows-updates.md)
* [Clientes e sites](https://wiki.datadike.com/pt/sonar/administration/devices/clients-and-sites.md)
