SentriScope Intelligence Architecture
Global Intelligence Dashboard, CTI lifecycle, threat actor profiling, IOC correlation, feed API, and investigation platform evolution.
1. Overview
The Intelligence architecture covers three interconnected domains:
- Global Intelligence Dashboard — Operator-facing prioritization surface that aggregates canonical data into ranked attention points.
- Threat Intelligence Platform — CTI lifecycle management, threat actor profiling, IOC correlation, and intelligence-to-risk influence.
- Threat Intel Feed API — Platform-level news feed with tenant subscriptions.
2. Global Intelligence Dashboard
2.1 Purpose
The Global Intelligence Dashboard (/ endpoint, tenant-facing) gives security operators a single consolidated view of where to focus. It aggregates:
- Technology context: CMDB-derived assets, vulnerabilities, security coverage, exposure lifecycle
- Threat intelligence: Tenant-owned
CanonicalThreatIntelItem, platform feed articles, CVE reference data - Correlated risk: Latest
RiskSnapshot,RiskSnapshotItem, exposure–asset–vulnerability links
Key design: The dashboard does not replace list/detail UIs. It sits on top as a prioritization and triage entry point.
2.2 Operator-Driven → System-Driven Intelligence Shift
| Before | After |
|---|---|
| Operator manually opens Risk, Exposures, Intelligence, Connectors | System precomputes and ranks "attention points" |
| Mental correlation required | Deterministic scoring produces stable, explainable priority |
| Multiple tabs, context switching | Single ranked list with evidence and recommended actions |
2.3 Attention Points
Each attention point carries:
- priority_score: Deterministic 0–100 computed from risk, threat intel, and coverage data
- reason_codes: Why this item appears (e.g. CRITICAL_CVE_ACTIVE_TI, COVERAGE_GAP, LONG_LIVED_EXPOSURE)
- evidence_refs: Links to canonical entities (exposure ID, asset ID, TI item ID)
- recommended_action: Suggested remediation or investigation step
Deterministic scoring: No LLM in the critical attention-point computation path.
Attention points emit canonical Intelligence Insights via apps/intelligence_insights/adapters/attention_point_adapter.py (read-only mapping; scoring unchanged). See IMPLEMENTATION_INTELLIGENCE_INSIGHT_PLATFORM.md.
2.4 SOAR Readiness
The architecture is designed for future SOAR integration:
- Attention points can link to RemediationPlaybook (human-in-the-loop)
- Deterministic scoring remains the source of truth
- Automation consumes the same attention-point stream
2.5 Data Sources (Read-Only)
The dashboard consumes existing canonical data — it does not modify models or ingestion logic:
| Component | Location |
|---|---|
| Connector sessions | apps/connectors/ |
| Vulnerability storage | CanonicalVulnerability, CanonicalExposure |
| Threat intelligence | CanonicalThreatIntelItem, CanonicalIntelAssessment |
| Feed articles | apps/feeds/models.py (FeedArticle, TenantFeedSubscription) |
| Risk snapshots | RiskSnapshot, RiskSnapshotItem |
3. Threat Intelligence Platform
3.1 CTI Lifecycle Model
CanonicalThreatIntelItem follows a formal CTI lifecycle:
| State | Description |
|---|---|
NEW |
Ingested, not yet validated |
VALIDATED |
Analyst has confirmed relevance |
ENRICHED |
Additional context added (IOC correlation, actor profile) |
CORRELATED |
Linked to assets, identities, or exposures |
ACTIONED |
Response action taken |
ARCHIVED |
No longer active — excluded from risk scoring |
Transitions are auditable. Only authorized roles may change lifecycle state. Archived items are excluded from risk weighting.
3.2 Intelligence Tier Model
| Tier | Description | Risk Weight |
|---|---|---|
TACTICAL |
Short-term, specific indicators (IOCs, CVEs being exploited) | High |
OPERATIONAL |
Campaign-level context (TTPs, actor behavior) | Medium |
STRATEGIC |
Long-term trends, sector threats | Lower |
Tier is stored in CanonicalThreatIntelItem.intelligence_tier and CanonicalIntelAssessment.intelligence_tier.
3.3 Intelligence Source Types
| Source Type | Default Weight | Example |
|---|---|---|
COMMODITIZED |
Lower | Open-source TI feeds, NVD |
SECTOR_SPECIFIC |
Medium | ISAC feeds, sector-specific TI |
ORGANIZATIONAL_SPECIFIC |
Higher | Custom TI, internal threat hunting output |
3.4 Threat Intelligence Risk Influence Model
Intel items influence risk scoring via IntelWeightFactor:
IntelWeightFactor = source_type_weight × tier_weight × confidence × decay_factor
RiskScoringProfile extended with:
- intel_source_weight_map: Weight per source type
- intel_tier_weight_map: Weight per intelligence tier
- intel_confidence_multiplier: Scaling factor for confidence
- decay_enabled: Whether expired intel is excluded
3.5 Intelligence Validity and Decay
valid_from/valid_until— Explicit validity windowdecay_rate— Rate at which intel relevance decreases aftervalid_from- Expired intel (
valid_until < now) is excluded from risk calculations - Decay is deterministic — identical parameters produce identical decay values
4. Threat Actor and Campaign Profiling
4.1 CanonicalThreatActor
| Field | Description |
|---|---|
name |
Actor name / alias |
origin_region |
Country / region of origin |
targets |
Target sectors or organizations |
motivation |
Financial, espionage, hacktivism, etc. |
sophistication_level |
Low / Medium / High / Nation-State |
linked_campaigns |
FK to CanonicalCampaign |
linked_iocs |
Via CanonicalIOCThreatActor |
4.2 IOC Correlation
CanonicalIOC is correlated with:
- CanonicalThreatActor via CanonicalIOCThreatActor
- CanonicalCampaign via CanonicalIOCCampaign
- CanonicalIncident via IOCContextCorrelation and CanonicalIntelEdge
Correlations appear in the Attack Graph as edge types (see ).
5. Produced Intelligence: CanonicalIntelAssessment
CanonicalIntelAssessment is produced intelligence — an analyst's conclusion linking raw intel items to tenant assets and risks:
| Field | Description |
|---|---|
tenant |
FK (tenant-scoped) |
intel_items |
M2M to CanonicalThreatIntelItem |
linked_assets |
M2M to CanonicalAsset |
linked_applications |
M2M to CanonicalApplication |
linked_risks |
M2M to RiskSnapshot |
intelligence_tier |
Tactical / Operational / Strategic |
relevance_score |
0–100 analyst-assigned relevance |
confidence_level |
0–100 confidence in assessment |
analyst_notes |
Free-text analysis |
recommended_action |
Suggested response |
expiry_date |
After which the assessment is archived |
CanonicalIntelAssessment is LLM-queryable and auditable. All changes are audit-logged.
6. Security Validation Events
CanonicalSecurityValidationEvent records active validation and adversarial testing results:
| Type | Description |
|---|---|
RED_TEAM |
Red team exercise outcome |
PURPLE_TEAM |
Purple team detection test |
HONEYPOT |
Honeypot trigger event |
DETECTION_GAP |
Confirmed detection failure |
SIMULATION |
Breach and attack simulation |
Fields: detection_success, time_to_detect, time_to_respond, linked controls and exposures. All events are tenant-scoped and auditable.
7. Threat Intel Feed API
7.1 Architecture
Platform-level FeedArticle records are published to subscribed tenants via TenantFeedSubscription.
| Model | Purpose |
|---|---|
FeedArticle |
Platform-level article (CVE, threat news, advisories) |
TenantFeedSubscription |
Tenant opt-in to specific feed categories |
ThreatIntelligenceSync |
Platform sync tracking (MITRE, CVE, threat_feed) |
7.2 Intelligence Newsfeed API
GET /api/v1/intelligence/feed/ List feed articles (tenant-subscribed)
GET /api/v1/intelligence/feed/<id>/ Article detail
POST /api/v1/intelligence/feed/<id>/correlate/ Correlate article with tenant IOCs
GET /api/v1/intelligence/actors/ Threat actor list
GET /api/v1/intelligence/iocs/ IOC list with correlation status
All endpoints are tenant-scoped. Platform feed articles are read-only from tenant perspective.
8. Threat Intel Graph Analytics
Threat intel entities are connected via CanonicalIntelEdge:
| Edge Type | Source → Target | Description |
|---|---|---|
ACTOR_USES_IOC |
ThreatActor → IOC | Actor uses this indicator |
ACTOR_RUNS_CAMPAIGN |
ThreatActor → Campaign | Actor attributed to campaign |
CAMPAIGN_USES_IOC |
Campaign → IOC | Campaign associated with IOC |
IOC_TARGETS_ASSET |
IOC → Asset | IOC observed targeting this asset |
CREDENTIAL_EXPOSES_ASSET |
CredentialLeak → Asset | Leaked credential grants access to asset |
CREDENTIAL_EXPOSES_IDENTITY |
CredentialLeak → Identity | Leaked credential belongs to identity |
Graph analytics queries traverse these edges to discover:
- Which threat actors are relevant to the tenant's asset profile
- Which ongoing campaigns target the tenant's sector
- Which IOCs have been observed against the tenant's assets
9. Investigation Platform Evolution
9.1 Relationship to Attack Path Intelligence
The Intelligence architecture is evolving from dashboard + CTI into a unified Operator Investigation Platform. Attack Path Intelligence (ARCHITECTURE_ATTACK_PATH_INTELLIGENCE.md) extends the dashboard with technology attack chains; this document's CTI graph analytics extend investigation for threat entities.
| Investigation context | Engine | Primary UI |
|---|---|---|
| Technology attack chains | Attack Graph → Attack Path Intelligence | Entity detail, Attack Path dashboard |
| CTI correlation | Intel graph (CanonicalIntelEdge) |
Graph Explorer, IOC/actor/campaign pages |
| Risk prioritization | Security Pulse attention points | Tenant dashboard / |
9.2 Dashboard as investigation entry point
Security Pulse (apps/intelligence_dashboard) remains the primary operator entry. Planned evolution:
- Integrate Attack Path Intelligence priority widgets (critical assets, chains, crown jewel exposure)
- Extend attention point
reason_codeswith path-derived codes (see Attack Path Intelligence architecture §6.3) - Preserve deterministic scoring — no LLM in widget computation
Design shift: Dashboard answers “what should I investigate?”; entity pages answer “what does this mean for this asset/identity/app?”; graph viewer supports both contextually.
9.3 Investigation workflow (target)
Dashboard → Critical entity → Evidence → Attack path → Relationships
→ Timeline → Pivot → Response
See DESIGN_ATTACK_PATH_INVESTIGATION_UI.md for component standards.
9.4 Intel Graph Explorer positioning
/intelligence/graph/ remains the CTI neighborhood explorer. It is complementary, not replaced by Attack Graph. Unified investigation UI presents CTI pivot and attack path panels side-by-side on relevant entity pages (IOC, actor, campaign with tenant asset touchpoints).