NodeMotion
Live Canvas
MODULE 01 OF 09•Foundations

Overview & 5-Minute Quickstart

End-to-end tour from Architecture Studio topology design to Threat Studio 1-click mitigation and CISO/SARIF export.

MODULE 01 · 5-MINUTE QUICKSTART⏱ 4 min read

“A threat model that lives in a static slide deck is obsolete the moment someone opens a pull request.”

— NodeMotion Architecture Field Guide
TL;DR in 15 Seconds:Import your Terraform, Bicep, Kubernetes, or .mcp/config.json in 60 seconds, inspect live STRIDE + MITRE ATLAS risk badges, splice 1-click defenses, and export OASIS SARIF v2.1.0.

1. 3-Minute Quickstart: IaC Import, BYOK & First STRIDE + MITRE ATLAS Scan

NodeMotion.IO unifies live animated architecture design in Architecture Studio and deterministic threat modeling in Threat Modeling Studio directly inside your browser—keeping your topologies, LLM keys, and cloud storage tokens strictly client-side.

STEP 1 · IMPORT TERRAFORM (.tf), BICEP, KUBERNETES, OR GITHUB URL

Synthesize Your Topology in Seconds

Open Architecture Studio or Threat Modeling Studio and click File → Import IaC / Spec. Upload a local .tf, .bicep, docker-compose.yml, Kubernetes YAML, or OpenAPI 3.0 spec—or paste a public GitHub repository URL. NodeMotion parses resources into nested VNet/Subnet Trust Boundaries automatically.

STEP 2 · CONNECT YOUR BYOK KEY (GEMINI, OPENAI, OR ANTHROPIC)

Optional AI Co-Pilot & Architecture Synthesis

Click your profile menu → Account & BYOK Settings to enter your own Gemini, OpenAI, or Anthropic API key. Keys are kept exclusively in browser sessionStorage / memory—deterministic STRIDE + MITRE ATLAS scanning works offline with zero AI keys required.

STEP 3 · RUN STRIDE + MITRE ATLAS SCAN & SPLICE 1-CLICK CONTROLS

Evaluate Risk, Trace Kill Chains & Export Evidence

Click Threat Model in Architecture Studio (or open Threat Modeling Studio) to run the < 5ms STRIDE + MITRE ATLAS engine. Inspect red threat badges (S, T, R, I, D, E, TI), run the Kill Chain & Blast Radius simulator, apply 1-click inline countermeasures, and export OASIS SARIF v2.1.0 or a CISO PDF Report.

NodeMotion Architecture Studio Live Canvas
Figure 1.1 — Architecture Studio: Deterministic orthogonal routing, nested VNet/Subnet trust zones, and SMIL packet-flow timeline playback.LIVE PLAYWRIGHT CAPTURE

2. Zero-Secret & BYOK Trust Architecture

Zero-Secret Guarantee for Enterprise Security Reviewers

User-supplied LLM API keys (Google Gemini, OpenAI, Anthropic) and cloud storage credentials (AWS S3 IAM / Azure Blob SAS) remain strictly inside browser sessionStorage and in-memory state. They are never logged, never persisted to any server-side database, and never transmitted to analytics or telemetry sinks.

Least-Privilege AWS S3 Bucket / IAM Policy (Scoped to workspaces/*)

When connecting your own S3 bucket for encrypted workspace persistence, attach the following least-privilege IAM policy scoped exclusively to the workspaces/* prefix:

aws-s3-workspaces-iam-policy.jsonjson
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "NodeMotionWorkspaceObjectAccess",
      "Effect": "Allow",
      "Action": [
        "s3:GetObject",
        "s3:PutObject",
        "s3:DeleteObject"
      ],
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME/workspaces/*"
    },
    {
      "Sid": "NodeMotionWorkspacePrefixList",
      "Effect": "Allow",
      "Action": "s3:ListBucket",
      "Resource": "arn:aws:s3:::YOUR_BUCKET_NAME",
      "Condition": {
        "StringLike": {
          "s3:prefix": "workspaces/*"
        }
      }
    }
  ]
}

Azure Blob Storage SAS Minimum Permissions

For Azure Storage BYOK workspace sync, generate a Container/Service SAS token restricted to HTTPS-only (spr=https), short expiry TTLs (e.g., 1–8 hours), and the minimum permission flags: r (Read), a (Add), c (Create), w (Write), l (List) — omitting Delete (d) or Account Admin permissions where immutable retention is required.

azure-blob-sas-minimum.txturi
https://<storage-account>.blob.core.windows.net/<container>?sv=2024-11-04&ss=b&srt=co&sp=racwl&se=2026-12-31T23:59:59Z&spr=https&sig=<HMAC_SIGNATURE>

3. STRIDE + MITRE ATLAS Scoring & AI/MCP Rule Catalog

INHERENT RISK

Weighted baseline exposure calculated across all open STRIDE, OWASP API, and MITRE ATLAS findings before compensating controls are spliced.

RESIDUAL RISK

Live recalculated risk after applying 1-click inline countermeasures (Cloud WAF, mTLS X.509, AI Safety Guardrails, SIEM) and triage dispositions.

CONTROL-BREAK BLAST RADIUS

Toggle Simulate Control Failure or open Kill Chain & Blast Radius to trace lateral pivot paths from any breached node to Crown Jewel assets.

Rule / Threat ClassMITRE ATLAS / OWASPAttack Vector1-Click / Hardened Control
Direct & Indirect Prompt InjectionAML.T0051 · LLM01Untrusted user inputs or external text override system instructions.Splice AI Safety Guardrail + Delimiter Shield
System Prompt & PII LeakageAML.T0056 · LLM02/07Jailbreaks extract hidden instructions, API keys, or memorized PII.Outbound DLP PII Redaction + Output Schema
RAG / Vector DB PoisoningAML.T0020 · LLM08Adversarial chunks injected into knowledge base hijack retrieved context.Signed Document Provenance + Spotlighting
Cross-Tenant Vector LeakageAML.T0024 · API1Shared vector index lacks per-user ACL metadata filtering.Mandatory Pre-Retrieval Tenant ACL Filter
Unauthenticated MCP ServersAML.T0040 · CWE-306Model Context Protocol server exposes tool endpoints without mTLS/OAuth.Enforce mTLS X.509 + Scoped OAuth Tokens
Over-Privileged Agent Tool ExecutionAML.T0051.001 · LLM06Agent autonomously runs destructive SQL, shell, or payment mutations.Read-Only Tool Scope + Human-in-the-Loop (HITL)
Threat Modeling Studio Canvas with Inline Visual Legend Open
Figure 1.2 — Threat Modeling Studio: Live STRIDE badges, Trust Boundary crossings, and the inline '? Legend' reference popover.LIVE PLAYWRIGHT CAPTURE

4. CI/CD & DevSecOps Integration (OASIS SARIF v2.1.0 & Exports)

Export your Threat Register via File → Export OASIS SARIF v2.1.0 and upload it directly to GitHub Advanced Security Code Scanning using github/codeql-action/upload-sarif@v3:

.github/workflows/nodemotion-sarif.ymlyaml
name: NodeMotion Threat Model SARIF Upload

on:
  push:
    branches: [ main ]
  pull_request:
    branches: [ main ]

permissions:
  contents: read
  security-events: write

jobs:
  upload-threat-sarif:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4

      - name: Upload NodeMotion OASIS SARIF v2.1.0 to GitHub Security
        uses: github/codeql-action/upload-sarif@v3
        with:
          sarif_file: exports/nodemotion-threats.sarif.json
          category: nodemotion-stride-atlas
OWASP Threat Dragon v2 (.json)

Full schema-compatible DFD export for cross-tool review in desktop or enterprise Threat Dragon pipelines.

Mermaid.js & PlantUML

Paste-ready diagram definitions for GitHub Pull Requests, Markdown ADR docs, and Confluence pages.

Jira / ServiceNow CSV

Pre-formatted threat rows with severity, rule ID, target asset, countermeasure, and disposition owner.

Executive CISO STRIDE PDF & DOCX

Audit-ready runbooks and risk reports with inherent/residual scorecards for ISO 27001, SOC 2, and DORA.

5. Supported IaC Formats & Known Limits

Format / SpecExtensions / InputSupported Constructs & Known Limits
Terraform HCL.tf, .tf.json, GitHub URLAWS/Azure/GCP compute, VNets, subnets, DBs, gateways, IAM. Remote state & encrypted modules require local variable expansion.
Azure Bicep.bicepResource declarations, VNets, AKS, Key Vault, APIM, Storage, and symbolic parent references.
Docker Composedocker-compose.yml / .yamlServices, depends_on wiring, exposed ports, networks, Redis/Postgres/Kafka images.
Kubernetes Manifests.yaml (Multi-doc)Deployments, Services, Ingress, NetworkPolicy, StatefulSets. Helm templates should be rendered via helm template first.
OpenAPI / Swaggeropenapi.json / .yaml (v3.x)Synthesizes API Gateway endpoints, securitySchemes (OAuth2/OIDC/API Key), and downstream backend paths.

6. Complete 9-Module Documentation Directory

MODULE 01Foundations
Overview & 5-Minute Quickstart

End-to-end tour from Architecture Studio topology design to Threat Studio 1-click mitigation and CISO/SARIF export.

Read Full Guide
MODULE 02Foundations
Architecture Studio & Aesthetic Canvas

Deterministic orthogonal routing, nested trust zones, step-by-step packet playback, Well-Architected Advisor, Aesthetic Backdrop Switcher, and Word/PDF runbooks.

Read Full Guide
MODULE 03Threat Modeling Studio
Threat Modeling Studio: Canvas Badges & Visual Legend

Decode every red STRIDE/ATLAS badge, dashed Trust Boundary, transport & sensitivity pill, identity label, and Crown Jewel marker on the canvas.

Read Full Guide
MODULE 04Threat Modeling Studio
Left Panel: STRIDE Filter & Security Controls Palette

How live STRIDE Threat Filter counters work and full reference guide for all 10 Adversaries & Security Controls in the Threat Studio palette.

Read Full Guide
MODULE 05Threat Modeling Studio
Right Panel: Threat Register, Posture, Assumptions & AI Co-Pilot

Anatomy of a Threat Register card (NM-STRIDE-T01, CWE/OWASP/NIST/PCI-DSS badges, 1-click inline mitigation), Posture Inspector, Control-Break Simulator, Assumptions, and AI Co-Pilot.

Read Full Guide
MODULE 06Threat Modeling Studio
Top Toolbar, Bidirectional Sync & Enterprise Exports

Real-world workflows for Attack Paths, Workspaces, Sync to Studio, CISO STRIDE Report (PDF), Threat Register CSV, OWASP Threat Dragon v2, OASIS SARIF v2.1.0, and .nodemotion.json.

Read Full Guide
MODULE 07AI, IaC & Enterprise Governance
Threat Modeling OpenAI, RAG & Agentic Workflows

How NodeMotion models LLMs, vector stores, and MCP tool-calling agents under STRIDE + MITRE ATLAS (NM-ATLAS-LLM01), and how AI Safety Guardrail & DLP mitigate prompt injection.

Read Full Guide
MODULE 08AI, IaC & Enterprise Governance
IaC & GitHub Ingestion + Downloadable Templates

Supported formats (.tf, .bicep, docker-compose.yaml, OpenAPI, Kubernetes YAML), GitHub tree discovery rules, and 1-click downloadable starter templates.

Read Full Guide
MODULE 09AI, IaC & Enterprise Governance
Capabilities, Limitations, BYOK & CI/CD

Honest What is There vs. What is Not matrix, BYOK privacy lifecycle (Gemini, OpenAI, Anthropic), Zero-Secret S3/Azure SAS cloud workspaces, and GitHub Actions SARIF pipelines.

Read Full Guide

There Are No Dumb Questions

Candid answers to the skeptical questions every security engineer asks first.

Q:Wait—do I need an OpenAI or Gemini API key to run threat modeling?
A:No! The deterministic STRIDE + MITRE ATLAS engine runs 100% locally in your browser in under 5ms with zero API keys. BYOK keys are only needed if you want conversational AI diagram synthesis or ticket drafting.
Q:Do my diagrams or Terraform files leave my browser during analysis?
A:Deterministic IaC parsing, layout, STRIDE scanning, Kill-Chain simulation, and SARIF/CSV/PDF exports all run client-side.
INTERACTIVE EXERCISE

Sharpen Your Pencil · 60-Second Brain Challenge

You import a Terraform file with a public PostgreSQL server (public_network_access_enabled = true) and no WAF. Which action drops Residual Risk fastest?

The Sticky-Note Takeaway
  • ▸Start from Architecture Studio, a Reference Blueprint, or File → Import IaC / Spec.
  • ▸Handoff to Threat Modeling Studio in 1 click to score Inherent vs. Residual Risk.
  • ▸Splice inline controls and export OASIS SARIF v2.1.0 or CISO PDF evidence.