# Scripts

> Revise, autorize e bloqueie os scripts que rodam nas suas páginas de pagamento e acompanhe a integridade de cada um.

URL: https://docs.proteside.com/pt-BR/docs/guide/scripts

A página **Scripts** é o inventário de todos os scripts vistos nas páginas onde o SDK está instalado. O PCI DSS 4.0,
requisito 6.4.3, exige exatamente isso: saber quais scripts rodam na página de pagamento, ter uma justificativa para
cada um e garantir que eles não mudem sem revisão. O requisito 11.6.1 pede que mudanças sejam detectadas — é o papel
da aba **Integridade**.

*Imagem: Inventário de scripts: recomendações (1), abas (2), filtros (3) e status (4).*

No topo da página podem aparecer dois avisos:

* **Ver recomendações** (1): há decisões sugeridas por [políticas de aprovação](https://docs.proteside.com/pt-BR/docs/guide/policies) esperando por você.
* **Autorizar todos os próprios**: há scripts da própria loja aguardando revisão. Veja como usar mais abaixo.

## Como o inventário é montado
O inventário é alimentado pelo SDK nas sessões dos clientes. Verificações periódicas, no servidor e com navegador
automatizado, complementam o monitoramento contínuo e atendem à avaliação semanal exigida pelo 11.6.1. Cada endereço
de script vira uma linha. Scripts inline (escritos dentro do HTML) são identificados pelo próprio conteúdo.

O SDK do Proteside aparece no inventário já autorizado, com método **Automático**.

### Tipos
| Tipo             | Significado                                                            |
| ---------------- | ---------------------------------------------------------------------- |
| **Próprio**      | Script inline ou servido pelo domínio da loja (inclui subdomínios).    |
| **Terceiro**     | Script de um fornecedor conhecido, presente no catálogo do Proteside.  |
| **Desconhecido** | Script de outro domínio que não está no catálogo. Merece mais atenção. |

### Categorias
**Pagamento**, **Analytics**, **Publicidade**, **Funcional**, **Autenticação**, **Gerenciador de tags** e
**Desconhecido**. A categoria vem do SDK ou do catálogo de fornecedores. Scripts inline e bibliotecas conhecidas
servidas pela própria loja entram como **Funcional**.

### Status
| Status              | Significado                                                               |
| ------------------- | ------------------------------------------------------------------------- |
| **Precisa revisão** | Visto na página e aguardando decisão. É o status de todo script novo.     |
| **Autorizado**      | Aprovado por uma pessoa, por uma política ou pela API, com justificativa. |
| **Bloqueado**       | Bloqueado por regra. O SDK impede o script no navegador.                  |
| **Suspeito**        | Sinalizado por comportamento suspeito.                                    |
| **Malicioso**       | Confirmado como malicioso. A linha fica destacada em vermelho.            |
| **Confiável**       | Status antigo, anterior à autorização com justificativa.                  |
| **Permitido**       | Status antigo, de uma regra de permissão.                                 |

Ao lado do status podem aparecer marcadores:

* **↺ Re-revisão**: o conteúdo do script mudou e ele precisa de uma nova decisão.
* **Divergente**: o conteúdo atual é diferente do que foi autorizado.
* **Autorização vencida**: a validade da autorização passou.
* **Revisão em N dias**: a autorização vence em menos de 14 dias.

## Encontrar um script
Use as abas **Todos** e **Re-revisão** (2) e os filtros (3):

* **Todos** / **Próprios** / **Terceiros** / **Desconhecidos** filtram por tipo.
* **Todos os status** filtra por status. Cada opção mostra uma dica do que significa.
* **Buscar por URL ou domínio** procura no endereço, no domínio e no nome do script.

A coluna **Status** (4) mostra o status de cada script e os marcadores descritos em [Status](#status).

A lista mostra primeiro os scripts que precisam de revisão e depois os vistos mais recentemente, 50 por página. Os
filtros ficam no endereço da página: você pode copiar o link e mandar para alguém da equipe com a mesma visão.

Clique em qualquer linha para abrir o painel de detalhes, com hash, tamanho, quando o script foi visto pela primeira e
pela última vez, tipo, categoria e status. O campo **Páginas** mostra a última página em que o script foi visto, não
todas. Para scripts inline, o bloco **Conteúdo do script** mostra o início do código.

## Revisar e autorizar um script
Autorizar é registrar que você conhece o script, sabe por que ele está na página e aceita que ele rode. A justificativa
fica guardada como evidência do requisito 6.4.3.

*Imagem: Aba Autorização (1) com a última decisão (2) e os botões Autorizar (3) e Bloquear (4).*

### Abra o script
Clique na linha do script, ou no menu **…** da linha e em **Ver detalhes**.

### Confira a aba Autorização
A aba **Autorização** (1) mostra a última decisão (2): **Método**, **Autorizado por**, **Revisado em**, **Válido
até**, **Próxima revisão**, a **Política** que decidiu (se houver) e a **Justificativa**. Um script nunca revisado
mostra "Este script ainda não foi revisado".

### Clique em Autorizar
Clique em **Autorizar** (3). Se o script já estiver autorizado, o botão se chama **Reautorizar**.

### Escreva a justificativa e escolha a validade
*Imagem: Justificativa (1), sugestões (2), validade (3) e confirmação (4).*

Preencha a **Justificativa** (1), com no mínimo 10 caracteres. As **Sugestões** (2) trazem textos prontos para a
categoria do script; clicar em uma substitui o que estiver escrito. Em **Validade da autorização** (3), escolha
**Sem validade**, **90 dias**, **180 dias** ou **365 dias**. Quando a validade vence, o script volta para
**Precisa revisão** — o PCI DSS recomenda revisão periódica.

### Confirme
Clique em **Autorizar** (4). O script passa para **Autorizado** e o hash atual vira o **hash autorizado**, que
servirá de referência para detectar mudanças.

Toda decisão fica registrada com autor, data, justificativa e validade, e aparece nas
[evidências PCI DSS](https://docs.proteside.com/pt-BR/docs/guide/compliance) e no [registro de auditoria](https://docs.proteside.com/pt-BR/docs/guide/settings/audit-log).

> **Autorizar não libera nada no navegador**
>
> A autorização é um registro de decisão; ela não é enviada ao SDK. O único efeito no navegador é que regras de
> bloqueio ativas que casem com o script (pelo domínio ou pela URL) são desativadas. Se o script estava
> bloqueado por uma regra de domínio, autorizá-lo desbloqueia **o domínio inteiro**. A mensagem de confirmação pode
> citar "1 regra(s) de bloqueio desativada(s)" mesmo quando não havia regra; confira em [Regras](https://docs.proteside.com/pt-BR/docs/guide/rules).

## Autorizar todos os scripts próprios
Na primeira semana, a maior parte do inventário costuma ser de scripts da própria loja. Em vez de autorizar um por um:

### Clique em Autorizar todos os próprios
O botão aparece no topo da página quando há scripts **Próprios** com status **Precisa revisão**.

### Escreva uma justificativa única
A mesma justificativa e a mesma validade valem para todos. Use as sugestões de "Próprio" se quiser.

### Confirme
Clique em **Autorizar**. A autorização vale para **todos** os scripts próprios pendentes da loja, não só os que
aparecem na página ou no filtro atual.

## Bloquear um script
### Escolha Bloquear
No menu **…** da linha, ou no painel de detalhes, clique em **Bloquear** (4 no print da aba Autorização).

### Registre o motivo
A justificativa é opcional para bloquear, mas registrar o motivo ajuda na auditoria.

### Confirme
Clique em **Bloquear**. O script passa para **Bloqueado** e o Proteside cria uma regra em [Regras](https://docs.proteside.com/pt-BR/docs/guide/rules),
com o nome do script como rótulo. O SDK aplica a regra nas páginas em poucos minutos.

> **Bloquear um script externo bloqueia o domínio inteiro**
>
> Para scripts de outro endereço, a regra criada é de **domínio**, com todos os subdomínios. Todos os scripts daquele
> domínio deixam de carregar, inclusive os que você autorizou (eles continuam aparecendo como **Autorizado** no
> inventário). Se o script for **Próprio** e estiver no domínio da loja, a regra alcança os scripts da loja. Para bloquear um único arquivo, vá em [Regras](https://docs.proteside.com/pt-BR/docs/guide/rules), desative a regra de domínio criada e
> adicione uma regra **Bloquear** com alvo **URL do script**.

> **Scripts inline devem ser removidos na origem**
>
> O bloqueio no navegador vale para scripts carregados por endereço; scripts inline devem ser removidos na origem
> (HTML, tema da loja ou gerenciador de tags).

Se um script bloqueado continuar aparecendo na página, o inventário mostra um aviso em amarelo. Remova a tag do HTML ou
do tema da loja e confirme que o snippet é o primeiro script do `<head>`.

Para desfazer um bloqueio, clique em **Autorizar** no script bloqueado: a regra de bloqueio correspondente é
desativada.

## Integridade e hash
O hash é a impressão digital do conteúdo do script. Quando você autoriza um script, o hash daquele momento
fica guardado como **hash autorizado**. Se o conteúdo mudar depois, o Proteside percebe.

*Imagem: Aviso de mudança (1), status (2), aba Integridade (3), hashes (4) e SRI sugerido (5).*

O que acontece quando o conteúdo de um script autorizado muda:

1. A integridade vira **Divergente** e o painel mostra um aviso no topo (1).
2. O script volta para **Precisa revisão** (2) e entra na aba **Re-revisão**.
3. Um alerta **Divergência de integridade de script**, de severidade alta, é aberto em [Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts).

Na aba **Integridade** (3) você compara o **Hash autorizado** com o **Hash atual** (4) e vê:

| Integridade    | Significado                                                                |
| -------------- | -------------------------------------------------------------------------- |
| **Íntegro**    | O conteúdo atual é igual ao autorizado.                                    |
| **Divergente** | O conteúdo mudou desde a autorização.                                      |
| **Pendente**   | Script do domínio da loja ainda sem hash calculado.                        |
| **Monitorado** | Script de terceiro acompanhado pelas verificações periódicas do Proteside. |
| **Bloqueado**  | O script está bloqueado.                                                   |

A **Origem do hash** diz como o valor foi obtido. A aba também mostra **Versões**,
**Última verificação**, **Hash alterado em**, se o script tem **Atributo integrity**, o **Container GTM** e o
**Fornecedor**, quando houver.

### SRI sugerido
Quando disponível, a aba mostra o **Subresource Integrity (SRI) sugerido** (5). Clique em
**Copiar atributo SRI** e cole o atributo na tag `script` do seu site. Com ele, o próprio navegador se recusa a
executar o arquivo se o conteúdo mudar.

Use SRI só em arquivos com conteúdo fixo, como os que têm a versão no endereço. Se o fornecedor atualizar o arquivo no
mesmo endereço, o navegador deixa de carregá-lo.

### Tratar a re-revisão
### Abra a aba Re-revisão
A aba **Re-revisão** (3 no print da lista) mostra os scripts cujo conteúdo mudou. O painel abre direto na aba
**Integridade**.

### Entenda a mudança
Compare os hashes e, se possível, confirme com o fornecedor ou com sua equipe o que mudou (uma nova versão, uma
configuração do gerenciador de tags).

### Decida
Clique em **Reautorizar** com uma nova justificativa ou em **Bloquear**. Depois, resolva o alerta correspondente em
[Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts).

> **Autorizações vencidas não entram na aba Re-revisão**
>
> Quando a validade de uma autorização vence, o script volta para **Precisa revisão**, mas não aparece na aba
> **Re-revisão**. Para encontrá-los, use a aba **Todos** com o filtro de status **Precisa revisão**. A aba
> **Re-revisão** também pode listar scripts nunca autorizados cujo conteúdo mudou.

## Scripts inativos
Scripts que não aparecem há mais de 30 dias ficam ocultos. Para vê-los, marque **Mostrar inativos**. Eles aparecem
com o selo **Inativo**. O total no topo da página e o contador da aba **Todos** incluem os inativos.

## Quem pode autorizar e bloquear
Só **proprietários** e **administradores** da loja autorizam, reautorizam e bloqueiam. Membros e leitores veem o
inventário e os detalhes, mas os botões de ação não aparecem para eles.

## Próximos passos
- [Políticas de aprovação](https://docs.proteside.com/pt-BR/docs/guide/policies): Automatize a autorização de scripts conhecidos.
- [Regras](https://docs.proteside.com/pt-BR/docs/guide/rules): Permita ou bloqueie domínios e URLs no navegador.
- [Alertas](https://docs.proteside.com/pt-BR/docs/guide/alerts): Trate mudanças de integridade e outras detecções.
