OpenCyber Academy
Engenharia · Capítulo 48 · Português
Código do curso: OCA-132Capítulo 48: OCA-132-C048

Capítulo 48 — Dossiê de evidências

Ensino gratuito e aberto para quem deseja proteger pessoas e tecnologias. Não é preciso criar uma conta para estudar ou consultar as respostas.

Mapa da aula

Aula 48 publicada. Mapa, exemplo, EX142.

flowchart TD
  N0["48.1 Finalidade"]
  N1["48.2 Conteúdo"]
  N2["48.3 Índice e identificadores"]
  N3["48.4 Tabela de afirmações"]
  N4["48.5 Confidencialidade"]
  N5["48.6 Revisão"]
  N6["48.7 Formato"]
  N7["48.8 Retenção"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> N7
  N7 --> EX["Exemplo resolvido"]
  EX --> Q["Exercício EX142"]

Desenho lógico

flowchart LR
  N0["48.1 Finalidade"]
  N1["48.2 Conteúdo"]
  N2["48.3 Índice e identificadores"]
  N3["48.4 Tabela de afirmações"]
  N4["48.5 Confidencialidade"]
  N5["48.6 Revisão"]
  N6["48.7 Formato"]
  N7["48.8 Retenção"]
  N0 --> N1 --> N2 --> N3 --> N4 --> N5 --> N6 --> N7 --> Q["EX142"]

[48.1 Finalidade]
    |
    v
[48.2 Conteúdo]
    |
    v
[48.3 Índice e identificadores]
    |
    v
[48.4 Tabela de afirmações]
    |
    v
[48.5 Confidencialidade]
    |
    v
[48.6 Revisão]
    |
    v
[48.7 Formato]
    |
    v
[48.8 Retenção]
    |
    v
[Exemplo resolvido] --> [Exercício EX142]

Objetivos de aprendizagem

Você vai (1) montar um dossiê de evidências de engenharia; (2) organizá-lo para avaliadores e auditores; (3) ligar cada afirmação a uma evidência; (4) proteger o material confidencial.

48.1 Finalidade

O dossiê prova o que o projeto alcançou. Ele é o equivalente, na engenharia, de um processo de caso pericial: toda afirmação da tese precisa poder ser rastreada até um registro nele. Um processo de caso pericial permite que alguém que não estava presente confira como se chegou a uma conclusão; o dossiê faz o mesmo com as afirmações de engenharia de Priya. Os avaliadores não podem repetir o piloto, mas podem ler os seus registros. Se uma afirmação da tese não tiver um registro que a sustente, o dossiê deixa isso visível. Construí-lo enquanto o projeto anda, e não no fim, evita reconstruir evidências de memória sob a pressão do prazo.

48.2 Conteúdo

Requisitos e matriz de rastreabilidade; projeto e registros de decisão; análises de ameaças e falhas; código-fonte na tag da versão lançada; relatórios de verificação e validação; revisão independente e respostas; dados e avaliação do piloto; relatório do ensaio de falha; registro de dívidas; atas de reuniões. A lista espelha a vida do projeto: o que foi exigido, como foi projetado, o que podia dar errado, o que foi construído, como foi conferido, o que alguém de fora encontrou, como se comportou no uso, como se recuperou de uma falha e o que continua inacabado. As atas registram decisões que nunca foram escritas em outro lugar. Incluir o registro de dívidas mostra aos avaliadores as fraquezas conhecidas do projeto ao lado dos seus sucessos, o que sustenta sua credibilidade, em vez de miná-la.

48.3 Índice e identificadores

Cada documento tem um ID, uma versão e um hash registrados num manifesto do dossiê, para que os avaliadores possam confirmar que veem o que foi entregue. Os hashes do manifesto permitem a um avaliador confirmar, anos depois, que o arquivo que ele abre é o que foi entregue, usando a mesma ideia da verificação de imagens no laboratório. As versões distinguem os rascunhos dos documentos finais. Identificadores como P-07 para os registros do piloto mantêm as referências curtas no texto da tese. O próprio manifesto tem seu hash calculado, e esse valor é impresso no formulário de entrega, amarrando todo o conjunto a um ponto fixo.

48.4 Tabela de afirmações

Uma tabela lista cada afirmação da tese com os itens do dossiê que a sustentam, por exemplo: "Zero exames sobre cópias não verificadas" → registros do piloto P-07, logs de verificação V-12. A tabela funciona num único sentido, da afirmação para a evidência, que é como um examinador lê uma tese. Cada afirmação é formulada exatamente como aparece no texto, então não há distância entre o que foi escrito e o que foi sustentado. Montar a tabela também apanha exageros: quando Priya não encontra um registro para uma frase que escreveu, ela acrescenta a evidência ou enfraquece a frase até corresponder ao que os registros de fato mostram.

48.5 Confidencialidade

Todos os dados do dossiê são sintéticos ou registros do sistema sem conteúdo de caso. Os detalhes de segurança específicos do laboratório, como endereços de rede, são suprimidos com uma nota. Usar dados sintéticos ou registros do sistema desde o início significa que não há conteúdo de caso que precise ser suprimido depois. Endereços de rede e detalhes parecidos poderiam ajudar um atacante a planejar algo contra Northfield, sem acrescentar nada ao argumento acadêmico. Uma nota em cada supressão declara o que foi removido e por quê, para que os avaliadores saibam que a omissão foi deliberada. O gerente de Northfield revisa o dossiê antes da entrega para confirmar que nada sensível permanece.

48.6 Revisão

A supervisora dela sorteia dez afirmações e segue cada uma até a sua evidência. Uma afirmação, sobre as horas de treinamento, não tem registro; Priya acrescenta a lista de presença. Sortear dez afirmações é uma auditoria prática: conferir todas levaria dias, mas uma amostra aleatória revela se as lacunas são raras ou comuns. A afirmação sobre as horas de treinamento era verdadeira, já que as sessões aconteceram, mas o registro faltava, o que, num contexto pericial, a deixaria sem sustentação. Priya então confere ela mesma as demais afirmações do mesmo tipo e constata que, fora isso, o dossiê está completo.

48.7 Formato

Arquivos simples com um índice legível, para que o dossiê possa ser lido daqui a dez anos sem software especial. PDF para os documentos, texto simples e CSV para os dados, e o código-fonte como arquivos de texto mantêm o dossiê independente de programas específicos. O índice é um arquivo de texto simples que lista identificadores, títulos, versões e caminhos. Formatos proprietários, como uma planilha com macros, são convertidos, e a conversão é conferida comparando os totais. O mesmo raciocínio orientou a escolha, no próprio EvidenceDesk, de registros em JSON simples.

48.8 Retenção

A universidade guarda o dossiê pelo período que os seus regulamentos exigem. Os prazos de retenção permitem recursos contra resultados de graduação e sustentam auditorias posteriores dos padrões acadêmicos. Northfield guarda sua própria cópia das partes relevantes para o EvidenceDesk segundo a tabela de registros do laboratório, porque as evidências de validação podem ser necessárias enquanto os registros do sistema forem usados em juízo, o que pode muito bem durar mais que o período da universidade. Priya não guarda consigo nenhuma cópia de material restrito do laboratório. O descarte no fim desse período também é registrado.

Percurso pelo dossiê

Antes da entrega, Priya pede a um colega que escolha cinco afirmações ao acaso e encontre as suas evidências sem ajuda. Duas demoraram demais; ela melhora os títulos do índice.

Exemplo resolvido

A linha da tabela de afirmações para o achado maior da revisão aponta para o relatório do revisor, o commit da mudança, o teste T-ANCH-03 e o e-mail de confirmação do revisor. A supervisora segue a trilha em menos de cinco minutos.

Caso sintético. O dossiê é inventado.

Erros e limites

Um dossiê prova que os registros existem; os avaliadores ainda julgam se as evidências sustentam as afirmações.

Exercícios

Síntese

Um dossiê com um manifesto e uma tabela de afirmações torna cada conquista verificável.

Continue estudando — capítulo 48 de 50

← Capítulo 47 (rascunho) · Índice de capítulos do curso · Capítulo 49 (rascunho) →

Respostas comentadas

EX142. Para que os avaliadores possam verificar que cada documento é exatamente a versão entregue, sem alterações desde então.

EX143. A afirmação sobre as horas de treinamento não tinha registro que a sustentasse; Priya acrescentou a lista de presença do treinamento.

EX144. Detalhes de segurança do laboratório, como endereços de rede, porque publicá-los enfraqueceria a segurança de Northfield.