Capítulo 16 — Documentação técnica e segurança
Mapa da aula
Aula 16 publicada. Mapa, exemplo, EX052.
flowchart TD
N0["16.1 Os documentos que um técnico possui"]
N1["16.2 A segurança vem primeiro e pertence às operaçõe"]
N2["16.3 Dispositivos e mídias transitórios"]
N3["16.4 Segredos e informações sensíveis"]
N4["16.6 Atividade prática"]
N5["Síntese do capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5
N5 --> EX["Exemplo resolvido"]
EX --> Q["Exercício EX052"]
Desenho lógico
flowchart LR
N0["16.1 Os documentos que um técnico possui"]
N1["16.2 A segurança vem primeiro e pertence às operaçõe"]
N2["16.3 Dispositivos e mídias transitórios"]
N3["16.4 Segredos e informações sensíveis"]
N4["16.6 Atividade prática"]
N5["Síntese do capítulo"]
N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> Q["EX052"]
[16.1 Os documentos que um técnico possui]
|
v
[16.2 A segurança vem primeiro e pertence às operaçõe]
|
v
[16.3 Dispositivos e mídias transitórios]
|
v
[16.4 Segredos e informações sensíveis]
|
v
[16.6 Atividade prática]
|
v
[Síntese do capítulo]
|
v
[Exemplo resolvido] --> [Exercício EX052]
Objetivos de aprendizagem e conexão
Ao final deste capítulo, você deverá ser capaz de:
- escrever documentos técnicos que outro técnico possa executar com segurança: instruções de trabalho, registros de resolução de problemas, registros de mudança e registros de configuração como construída (as-built);
- integrar a segurança física e do processo ao trabalho técnico: permissões de trabalho, isolamento, a autoridade das operações e as condições de parada;
- controlar os dispositivos transitórios — notebooks e mídias removíveis levados aos locais — para que não transportem malware ou dados entre zonas;
- manter segredos fora dos documentos.
Os Capítulos 1–15 produziram constatações, mudanças e evidências. Este capítulo trata dos documentos que tornam esse trabalho repetível e seguro, e das regras de segurança que se sobrepõem a qualquer plano técnico.
16.1 Os documentos que um técnico possui
| Documento | Propósito | Precisa conter |
|---|---|---|
| Instrução de trabalho | Permite que um colega competente execute uma tarefa corretamente | Pré-condições, etapas numeradas com resultados esperados, condições de parada, reversão, a quem chamar |
| Registro de resolução de problemas | Registra uma investigação enquanto ela acontece | Horários em UTC, quatro rótulos (observado, inferido, feito, em aberto), referências de evidências |
| Registro de mudança | Autoriza e registra uma mudança | Antes/depois, motivo, testes (Capítulo 11), reversão, janela, aprovador, verificador |
| Registro as-built | Declara o que está realmente configurado | Versões, resumos da configuração (Capítulo 14), desvios em relação ao projeto e a sua aprovação |
Escreva as etapas como ações no imperativo, com um resultado observável: "Execute sshd -T | grep -i passwordauthentication; espere passwordauthentication no." Uma etapa sem resultado esperado não pode ser conferida, e um documento que não pode ser conferido se afasta da realidade.
16.2 A segurança vem primeiro e pertence às operações
Numa estação de tratamento de água, numa subestação ou numa casa de máquinas de hospital, as pessoas responsáveis pelo processo físico têm autoridade sobre ele. O trabalho de um técnico ali começa com a permissão delas e para a pedido delas. Regras práticas:
- Permissões e isolamento: o trabalho em equipamentos do processo ou perto deles segue os procedimentos de permissão de trabalho e de isolamento do local; uma tarefa de segurança não isenta você deles.
- Os sistemas de proteção e de segurança funcional nunca são tocados pelo trabalho de segurança: relés de proteção numa subestação, sistemas instrumentados de segurança, alarmes de gases medicinais.
- Informe antes de agir: a sala de controle sabe quando você começa, o que está fazendo e quando termina.
- As condições de parada são escritas em toda instrução de trabalho (Capítulo 5) e respeitadas imediatamente.
A NIST SP 800-82 Rev. 3 discute a relação entre a segurança de TO e a segurança funcional (SP 800-82 Rev. 3); o Cyber Assessment Framework do NCSC do Reino Unido trata o entendimento que o operador tem das suas funções essenciais como fundamento da segurança (NCSC CAF).
16.3 Dispositivos e mídias transitórios
Um notebook que visita as estações, o centro de controle e o escritório corporativo é uma ponte entre todas as zonas. Controles que um técnico pode aplicar:
- notebooks de engenharia dedicados, que nunca entram na rede corporativa nem na internet;
- uma imagem sabidamente boa, atualizada e verificada num ponto controlado antes de cada visita ao local;
- mídias removíveis apenas de um conjunto controlado, verificadas antes do uso, com um registro de onde cada item esteve;
- nenhum dispositivo pessoal em redes de controle;
- um registro de toda conexão feita num local (qual porta, qual dispositivo, quando).
As metas de desempenho da CISA listam controles sobre mídias removíveis e sobre a configuração de dispositivos (CISA CPGs).
16.4 Segredos e informações sensíveis
Os documentos não devem conter senhas, chaves privadas, tokens de API nem códigos de uso único. Escreva "credencial da entrada kw-rtu-eng do cofre" em vez da credencial. Diagramas de rede, mapas de registradores e exportações de firewall de infraestrutura crítica são sensíveis: guarde-os com controle de acesso, compartilhe-os com base na necessidade de saber e retire-os dos chamados que vão para fornecedores. Este livro imprime alguns valores falsos apenas porque eles são falsos.
O nome da entrada do cofre pode aparecer com segurança em um chamado de mudança, porque indica a um engenheiro autorizado onde procurar sem revelar nada que um estranho possa usar. Mapas de registradores e exportações de firewall reais merecem o mesmo cuidado que as credenciais, já que juntos descrevem como uma estação pode ser alterada e a partir de onde.
16.5 Exemplo resolvido: uma instrução de trabalho (sintético)
WI-KW-07 — Exportar a configuração da RTU da KW-04 para a linha de base de deriva. Pré-condições: registro de mudança CHG-2219 aprovado; sala de controle da Kestrel Water informada; notebook de engenharia ENG-L3 verificado hoje (registro no livro de mídias). Etapas: (1) às 10:00, horário local, ligar para a sala de controle; registrar o nome do operador. (2) No ENG-L3, abrir a ferramenta do fornecedor em modo somente de leitura; esperado: a barra de status mostra "Online — read only". (3) Exportar a configuração para KW04-20261013.cfg; esperado: tamanho do arquivo entre 40 e 60 kB. (4) Executar sha256sum KW04-20261013.cfg; registrar o resumo na CHG-2219. (5) Desconectar; informar a sala de controle. Condições de parada: qualquer alarme na KW-04; a ferramenta pede para passar a "online edit"; pedido do operador. Reversão: nenhuma necessária (somente leitura), mas, se houver suspeita de qualquer escrita, informar imediatamente as operações e abrir um incidente. Evidências: arquivo, resumo, horários das ligações.
16.6 Atividade prática
Escreva uma instrução de trabalho para a mudança no roteador da KW-04 do EX052, incluindo preservação, a mudança, testes positivos e negativos, reversão e condições de parada. Peça a outra pessoa que a leia e liste cada etapa em que teria de adivinhar.
Inclua a preservação da configuração do roteador antes da mudança, testes positivos e negativos depois, etapas de reversão e condições de parada que incluam qualquer alarme na KW-04. Peça a um colega que marque cada etapa em que teria de adivinhar; essas etapas precisam de um resultado esperado ou de uma captura de tela da ferramenta do fornecedor. Guarde a cópia revisada com o registro de mudança.
16.7 Erros comuns e limites
- Etapas sem resultados esperados.
- Documentos que contêm credenciais ou são compartilhados amplamente demais.
- Tratar uma visita ao local como tarefa de TI e pular a permissão ou a ligação para a sala de controle.
- Um notebook para tudo.
-
Documentação escrita depois do trabalho, de memória.
-
Deixar de fora do procedimento de campo o rollback de uma mudança de regra no fw-01, de modo que uma mudança falha não tem caminho de volta testado.
- Pôr credenciais ou exportações completas de firewall num chamado amplamente compartilhado.
- Pular a permissão ou a ligação para a sala de controle porque a tarefa parece TI comum.
- Usar um único notebook para o trabalho corporativo, no centro de controle e nos locais.
- Escrever o documento de memória depois do trabalho.
Exercícios — capítulo 16
EX061 — Conserte uma instrução de trabalho. Objetivo: tornar as etapas executáveis. Insumos: "Entrar na RTU (senha Kestrel2024!) e conferir as configurações. Consertar o que estiver errado. Avisar as operações quando terminar." Passos: listar os defeitos e reescrever. Evidência esperada: lista de defeitos e instrução reescrita. Rubrica: 3 = remove a credencial (e recomenda trocá-la, já que foi escrita), acrescenta pré-condições, modo somente de leitura, resultados esperados, condições de parada, informa as operações antes, substitui "consertar o que estiver errado" por um registro de mudança; 2 = a maioria; 1 = cosmético; 0 = nada.
EX062 — Política de dispositivos transitórios. Objetivo: controlar uma ponte entre zonas. Insumos: um engenheiro usa o mesmo notebook para e-mail e para o trabalho nas estações. Passos: escrever uma política técnica curta e o plano de transição. Evidência esperada: política e plano. Rubrica: 3 = notebooks de engenharia dedicados com uma imagem controlada, sem uso corporativo nem de internet, verificação antes da visita, conjunto e registro de mídias, registro de conexões; transição que preserva os arquivos de projeto do notebook atual depois de verificá-los; 2 = política sem transição; 1 = "tomar cuidado"; 0 = nada.
EX063 — Limites de segurança. Objetivo: reconhecer o que está fora dos limites. Insumos: durante uma visita a uma subestação, você encontra um relé de proteção com a senha web padrão. Passos: declarar o que você faz e o que não faz, e como registra isso. Evidência esperada: procedimento curto. Rubrica: 3 = não entrar nem alterá-la; registrar a observação (dispositivo, horário, como foi notada); relatar ao engenheiro de proteção da Kestrel Grid e à líder de segurança do KVROC; os engenheiros de proteção decidem e agem; constatação sensível tratada com base na necessidade de saber; 2 = ações certas, registro fraco; 1 = troca a senha; 0 = nada.
EX064 — Registro as-built. Objetivo: documentar a realidade. Insumos: o fw-01 depois da correção do EX038 e o hist-02 depois da CHG-2207. Passos: redigir um registro as-built com versões, resumos (marcadores de posição são permitidos), desvios e aprovações. Evidência esperada: registro de uma página. Rubrica: 3 = declara a configuração real, inclui os resumos e onde estão guardados, lista os desvios em aberto (REQ-3/4 antes da correção) com aprovações ou chamados, datado e assinado; 2 = sem desvios; 1 = copia o projeto; 0 = nada.
Síntese do capítulo
Bons documentos técnicos são executáveis e conferíveis: etapas numeradas com resultados esperados, condições de parada, reversão e evidências. A segurança e a autoridade das operações se sobrepõem a todo plano técnico; os sistemas de proteção e de segurança funcional estão fora dos limites. Notebooks e mídias que se movem entre zonas precisam dos seus próprios controles, e segredos nunca pertencem aos documentos.
Continue estudando — capítulo 16 de 18
← Capítulo 15 · Índice de capítulos do curso · Capítulo 17 →
Siga para a próxima lição escrita.