ENGINEERING

How NexSOC is built.

An AI that can isolate machines needs to be engineered like any other security control. This page explains the design choices that keep it predictable, auditable and safe to run on real networks.

977
automated tests
6
specialised agents
1
human approval per action, used once
2
EDRs for containment

ARCHITECTURE

Every request goes through one gate.

Agents never call a tool directly. They ask the capability registry, which checks the tenant's grants and policy, requires a human approval for anything that changes a system, picks the connector, and writes the audit record.

AGENTS
TriageInvestigationThreat intelContainmentReportingFollow-up

Plan the work and explain it. They can only ask for capabilities.

CAPABILITY REGISTRY
  • Tenant grants and policy
  • Single-use approval for writes
  • Timeouts, retries, rate limits
  • Audit record for every call
  • Evidence stored with each result
CONNECTORS
DefenderFalconElasticVirusTotalJiraAny REST API

Called from the cloud or from the on-site Collector.

DESIGN DECISIONS

Where the AI decides, and where it never does.

Rules choose the response, not the model

Containment proposals come from fixed rules over the risk score, the investigation's threat likelihood and threat-intel verdicts. The model explains and summarises; it cannot pick an action.

Approvals are single use

An approval names one action and one exact target. It is consumed before the action runs, so a retry or a different target needs a fresh human decision.

Real tools always beat simulations

When a real EDR is connected, an approved action can never fall back to the simulator. A failure is shown as a failure, never as a success that did nothing.

Ambiguity stops the action

If two active devices share a name, NexSOC refuses to isolate either and asks an analyst. Isolating the wrong machine is worse than waiting a minute.

Secrets are references, never values

Connectors store only the name of an environment variable. Each customer can reference only its own variables, and platform credentials are off limits.

Missing evidence is not innocence

Every tool call records whether it found evidence, found nothing, failed or was denied. An unavailable tool is never reported as a clean result.

CONTAINMENT

From alert to isolated host, step by step.

  1. 01InvestigateAgents gather evidence and score the risk.
  2. 02ProposeRules turn the findings into isolate or block proposals.
  3. 03ApproveAn analyst approves one action on one target.
  4. 04ActDefender or Falcon isolates the host or blocks the hash.
  5. 05RecordReceipt on the case, the ticket and the audit log.

STACK

Boring technology, on purpose.

Small, well-understood parts that a customer's security team can review, and that run the same on a laptop as in the cloud.

BackendPython, FastAPI, SQLite with versioned migrations
ConsoleReact and TypeScript, built with Vite, served by nginx
AI modelsPluggable per agent: Ollama, Anthropic, OpenAI-compatible
IdentityOIDC single sign-on with PKCE, HttpOnly session cookies
PackagingDocker Compose; the Collector is one container
Assurance977 tests, dependency and image scans, posture checks

WHAT'S NEXT

On the roadmap.

NexSOC Cloud on AWS

Deployed from GitHub Actions with no SSH and no long-lived keys.

Claude on Amazon Bedrock

Managed models reached through the server's own AWS role.

Recommend-only mode

Per customer and per action, for pilots that want proposals before execution.

Identity response

Disable a compromised account and end its sessions in Microsoft Entra ID.

Want to talk shop?

Questions about the design, a pilot, or working together are all welcome.

Connect on LinkedIn Email