How hato0/nornops works
NornOps is a multi-tenant SOC workbench: analysts submit indicators, which are normalized, enriched across threat-intelligence providers, and turned into a scored verdict; they can then organize findings into cases or share them with the community. The graph also preserves the documented Path Encyclopedia, authentication, dashboard, and billing capabilities. The README establishes the product-level flow, while excerpts show API registration, provider orchestration and caching, authentication, and case persistence; unsampled route internals are represented only at the documented capability level.
Main entry points: main.py FastAPI app · orchestrator.py Enrichment orchestration · cases.py Case management · auth.py Authentication
Components 28
Analyst experience
- Next.js app
frontend/src/app/(app)/iocs/page.tsx - API client
frontend/src/lib/api.ts
API and identity
- FastAPI app
backend/app/main.py - Authentication
backend/app/routers/auth.py - Identity and access
backend/app/deps.py - JWT security
backend/app/security.py - Runtime settings
backend/app/config.py - API schemas
backend/app/schemas.py - Plans and entitlements
backend/app/entitlements/loader.py - Billing API
backend/app/routers/billing.py
IOC intelligence
- IOC API
backend/app/routers/ioc.py - IOC normalization
backend/app/ioc_normalization.py - Enrichment orchestration
backend/app/enrichment/orchestrator.py - Threat intel sources
backend/app/enrichment - Enrichment cache
backend/app/enrichment/cache.py - Verdict scoring
backend/app/enrichment/scoring.py - Verdict assembly
backend/app/enrichment/verdict.py
Investigation workspace
- Case management
backend/app/routers/cases.py - Community sharing
backend/app/routers/community.py - Analyst dashboard
backend/app/routers/dashboard.py - Domain models
backend/app/models.py - Application database
backend/app/database.py
Path Encyclopedia
- Path lookup API
backend/app/routers/path.py - Path analysis
backend/app/path_analyzer.py - Knowledge matching
backend/app/path_matching.py - Knowledge merging
backend/app/path_scoring/merging.py - Knowledge sources
backend/app/kb_sources.py
Other components
- SOC analyst
Connections 29
- SOC analyst → Next.js app: uses
README.md - Next.js app → API client: requests data
README.md - API client → FastAPI app: REST + JWT
README.md - FastAPI app → Authentication: registers routes
backend/app/main.py - FastAPI app → IOC API: registers routes
backend/app/main.py - FastAPI app → Case management: registers routes
backend/app/main.py - FastAPI app → Community sharing: registers routes
backend/app/main.py - FastAPI app → Analyst dashboard: registers routes
backend/app/main.py - FastAPI app → Path lookup API: registers routes
backend/app/main.py - Authentication → JWT security: hashes and signs
backend/app/routers/auth.py - Authentication → Domain models: creates users
backend/app/routers/auth.py - IOC API → IOC normalization: normalizes indicators
README.md - IOC API → Enrichment orchestration: requests enrichment
README.md - Enrichment orchestration → Threat intel sources: dispatches sources
backend/app/enrichment/orchestrator.py - Enrichment orchestration → Enrichment cache: reads and writes
backend/app/enrichment/orchestrator.py - Enrichment orchestration → Verdict scoring: feeds verdict scoring
README.md - Verdict scoring → Verdict assembly: contributes verdict
README.md - Case management → Domain models: reads and writes
backend/app/routers/cases.py - Case management → Application database: uses session
backend/app/routers/cases.py - Community sharing → IOC normalization: normalizes shared IOC
backend/app/routers/community.py - Analyst dashboard → Domain models: summarizes workspace
- Path lookup API → Path analysis: analyzes paths
- Path lookup API → Knowledge matching: matches knowledge
- Path analysis → Knowledge merging: combines signals
- Knowledge matching → Knowledge sources: consults sources
- FastAPI app → Runtime settings: configures middleware
backend/app/main.py - Case management → API schemas: validates payloads
backend/app/routers/cases.py - FastAPI app → Plans and entitlements: loads extensions
backend/app/main.py - FastAPI app → Billing API: registers routes
backend/app/main.py