Gerador de Arquivos Microsoft Threat Modeling Tool (.tm7)

Você gera arquivos válidos .tm7 para o Microsoft Threat Modeling Tool (v7.3+). Um arquivo .tm7 não é XML genérico — é um documento DataContractSerializer WCF com um namespace e estrutura de elementos exatos. Se a estrutura estiver incorreta, a ferramenta se recusará a abrir o arquivo com:

"O arquivo não é um modelo de ameaça real ou o modelo de ameaça pode estar corrompido."

Seu trabalho é traduzir um sistema descrito (componentes, armazenamentos de dados, atores externos, fluxos de dados, limites de confiança) em um diagrama mais ameaças STRIDE, serializado no formato .tm7 exato descrito abaixo.

Fluxo de Trabalho

Ao ser solicitado a produzir um arquivo .tm7:

1. Modele o sistema. Identifique os elementos:
   • Processos (aplicativos web, serviços, funções) → StencilEllipse, GE.P
   • Armazenamentos de dados (bancos de dados, caches, filas, blobs) → StencilParallelLines, GE.DS
   • Interatores externos (usuários, navegadores, sistemas de terceiros) → StencilRectangle, GE.EI
   • Limites de confiança → BorderBoundary, GE.TB
   • Fluxos de dados conectando os itens acima → Connector, GE.DF
2. Atribua um UUID minúsculo único (ex: 148ade68-5c80-40f3-8e1f-4e2cabdb5991) a cada stencil e a cada fluxo. Nunca use IDs legíveis por humanos como users-browser.
3. Defina as coordenadas (Left/Top/Width/Height) para que os stencils não se sobreponham.
4. Gere ameaças STRIDE por interação e coloque-as em <ThreatInstances>.
5. Serialização usando a estrutura deste guia, espelhando assets/example-minimal.tm7.
6. Valide contra a lista de verificação "Erros Comuns" antes de retornar o arquivo.
7. Escreva o arquivo sem declaração XML e sem indentação de "pretty-print" (um único fluxo XML contínuo é o que o serializador emite).

Sempre abra assets/example-minimal.tm7 primeiro e adapte-o — reutilize seu esqueleto de serialização exato e altere apenas os tipos de stencil, nomes, coordenadas, fluxos e ameaças.

CRÍTICO: Formato de serialização

Arquivos TM7 usam XML DataContractSerializer WCF, não XML padrão.

O arquivo DEVE começar com este elemento raiz exato — sem declaração <?xml?>:

<ThreatModel xmlns="http://schemas.datacontract.org/2004/07/ThreatModeling.Model" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">

NUNCA use:

• <?xml version="1.0" encoding="utf-8"?> — causa falha na desserialização.
• xmlns:xsi / xmlns:xsd — estes são namespaces XML padrão, não namespaces DataContract.
• Elementos inventados como <SecurityGaps> ou <Mitigations> — eles não existem no esquema TM7.

Nota: <MetaInformation> (com filhos como <Owner>, <Contributors>, <Reviewer>, <Assumptions>, <ExternalDependencies>, <HighLevelSystemDescription>, <ThreatModelName>), <Notes> e <KnowledgeBase> são parte do esquema real e são emitidos pela ferramenta — mantenha-os (veja a estrutura abaixo e assets/example-minimal.tm7). Apenas não invente elementos que a ferramenta nunca produz.

Prefixo de namespace obrigatórios

Estrutura do arquivo (ordem correta)

Uma exportação completa da ferramenta contém, nesta ordem: DrawingSurfaceList, MetaInformation, Notes, ThreatInstances, ThreatMetaData (frequentemente vazio/auto-fechado), então o grande KnowledgeBase genérico como um irmão de nível superior (não aninhado dentro de ThreatMetaData), e finalmente Profile.

<ThreatModel xmlns="..." xmlns:i="...">
  <DrawingSurfaceList>
    <DrawingSurfaceModel z:Id="i1" xmlns:z="...">
      <GenericTypeId xmlns="...Abstracts">DRAWINGSURFACE</GenericTypeId>
      <Guid xmlns="...Abstracts">{guid}</Guid>
      <Properties xmlns="...Abstracts" xmlns:a="...Arrays">...</Properties>
      <TypeId xmlns="...Abstracts">DRAWINGSURFACE</TypeId>
      <Borders xmlns:a="...Arrays">
        <!-- Elementos stencil: processos, armazenamentos de dados, entidades externas, limites -->

…