Performing Indicator Lifecycle Management
Overview
Indicator lifecycle management tracks IOCs from initial discovery through validation, enrichment, deployment, monitoring, and eventual retirement. This skill covers implementing systematic processes for IOC quality assessment, aging policies, confidence scoring decay, false positive tracking, hit-rate monitoring, and automated expiration to maintain a high-quality, actionable indicator database that minimizes analyst fatigue and maximizes detection efficacy.
When to Use
- When conducting security assessments that involve performing indicator lifecycle management
- When following incident response procedures for related security events
- When performing scheduled security testing or auditing activities
- When validating security controls through hands-on testing
Prerequisites
- Python 3.9+ with
pymisp, requests, stix2 libraries
- MISP or OpenCTI instance for indicator storage
- SIEM with IOC watchlist capabilities (Splunk, Elastic)
- Understanding of IOC types, confidence scoring, and TLP classifications
Key Concepts
Indicator Lifecycle Phases
- Discovery: IOC first identified from threat intelligence, malware analysis, or incident response
- Validation: IOC verified against enrichment sources (VirusTotal, Shodan)
- Enrichment: Additional context added (WHOIS, passive DNS, threat actor attribution)
- Deployment: IOC pushed to detection systems (SIEM, IDS, firewall)
- Monitoring: Track hit rates, false positive rates, detection efficacy
- Review: Periodic assessment of IOC relevance and accuracy
- Retirement: IOC expired or removed based on aging policy
Confidence Decay
Indicator confidence decreases over time as adversaries rotate infrastructure. A time-based decay function reduces confidence scores automatically, ensuring old indicators do not generate excessive alerts. Typical half-life: IP addresses (30 days), domains (90 days), file hashes (365 days).
Quality Metrics
- Hit Rate: Percentage of deployed IOCs generating true positive alerts
- False Positive Rate: Percentage of IOC alerts that are benign
- Coverage: Percentage of known threat techniques with IOC coverage
- Freshness: Average age of active indicators in the database
Workflow
Step 1: Implement IOC Lifecycle State Machine
from datetime import datetime, timedelta
from enum import Enum
class IOCState(Enum):
DISCOVERED = "discovered"
VALIDATED = "validated"
ENRICHED = "enriched"
DEPLOYED = "deployed"
MONITORING = "monitoring"
UNDER_REVIEW = "under_review"
RETIRED = "retired"
class IOCLifecycle:
def __init__(self, ioc_type, value, source, initial_confidence=50):
self.ioc_type = ioc_type
self.value = value
self.source = source
self.confidence = initial_confidence
self.state = IOCState.DISCOVERED
self.created = datetime.utcnow()
self.last_updated = datetime.utcnow()
self.last_seen = None
self.hit_count = 0
self.false_positive_count = 0
self.history = [{"state": "discovered", "timestamp": self.created.isoformat()}]
def transition(self, new_state: IOCState, reason=""):
self.state = new_state
self.last_updated = datetime.utcnow()
self.history.append({
"state": new_state.value,
"timestamp": self.last_updated.isoformat(),
"reason": reason,
})
def apply_decay(self):
"""Apply confidence decay based on IOC type half-life."""
half_lives = {"ip": 30, "domain": 90, "hash": 365, "url": 60}
half_life = half_lives.get(self.ioc_type, 90)
age_days = (datetime.utcnow() - self.created).days
decay_factor = 0.5 ** (age_days / half_life)
self.confidence = max(0, int(self.confidence * decay_factor))
def record_hit(self, is_true_positive=True):
self.hit_count += 1
self.last_seen = datetime.utcnow()
if not is_true_positive:
self.false_positive_count += 1
if self.false_positive_count > 3:
self.transition(IOCState.UNDER_REVIEW, "Excessive false positives")
def should_retire(self):
max_ages = {"ip": 90, "domain": 180, "hash": 730, "url": 120}
max_age = max_ages.get(self.ioc_type, 180)
age_days = (datetime.utcnow() - self.created).days
return age_days > max_age and self.hit_count == 0
Validation Criteria
- IOC lifecycle state machine transitions correctly between phases
- Confidence decay reduces scores based on IOC type half-life
- Hit rate and false positive tracking functional
- Aging policy automatically flags indicators for review/retirement
- Quality metrics dashboard shows IOC database health
References
Source: mukul975/Anthropic-Cybersecurity-Skills → skills/performing-indicator-lifecycle-management/SKILL.md
1---2name: performing-indicator-lifecycle-management3description: Indicator lifecycle management tracks IOCs from initial discovery through validation, enrichment, deployment, monitoring, and eventual retirement. This skill covers implementing systematic processes f4---5
6# Performing Indicator Lifecycle Management
7
8## Overview
9
10Indicator lifecycle management tracks IOCs from initial discovery through validation, enrichment, deployment, monitoring, and eventual retirement. This skill covers implementing systematic processes for IOC quality assessment, aging policies, confidence scoring decay, false positive tracking, hit-rate monitoring, and automated expiration to maintain a high-quality, actionable indicator database that minimizes analyst fatigue and maximizes detection efficacy.
11
12
13## When to Use
14
15- When conducting security assessments that involve performing indicator lifecycle management
16- When following incident response procedures for related security events
17- When performing scheduled security testing or auditing activities
18- When validating security controls through hands-on testing
19
20## Prerequisites
21
22- Python 3.9+ with `pymisp`, `requests`, `stix2` libraries
23- MISP or OpenCTI instance for indicator storage
24- SIEM with IOC watchlist capabilities (Splunk, Elastic)
25- Understanding of IOC types, confidence scoring, and TLP classifications
26
27## Key Concepts
28
29### Indicator Lifecycle Phases
301. **Discovery**: IOC first identified from threat intelligence, malware analysis, or incident response
312. **Validation**: IOC verified against enrichment sources (VirusTotal, Shodan)
323. **Enrichment**: Additional context added (WHOIS, passive DNS, threat actor attribution)
334. **Deployment**: IOC pushed to detection systems (SIEM, IDS, firewall)
345. **Monitoring**: Track hit rates, false positive rates, detection efficacy
356. **Review**: Periodic assessment of IOC relevance and accuracy
367. **Retirement**: IOC expired or removed based on aging policy
37
38### Confidence Decay
39Indicator confidence decreases over time as adversaries rotate infrastructure. A time-based decay function reduces confidence scores automatically, ensuring old indicators do not generate excessive alerts. Typical half-life: IP addresses (30 days), domains (90 days), file hashes (365 days).
40
41### Quality Metrics
42- **Hit Rate**: Percentage of deployed IOCs generating true positive alerts
43- **False Positive Rate**: Percentage of IOC alerts that are benign
44- **Coverage**: Percentage of known threat techniques with IOC coverage
45- **Freshness**: Average age of active indicators in the database
46
47## Workflow
48
49### Step 1: Implement IOC Lifecycle State Machine
50
51```python
52from datetime import datetime, timedelta
53from enum import Enum
54
55class IOCState(Enum):
56 DISCOVERED = "discovered"
57 VALIDATED = "validated"
58 ENRICHED = "enriched"
59 DEPLOYED = "deployed"
60 MONITORING = "monitoring"
61 UNDER_REVIEW = "under_review"
62 RETIRED = "retired"
63
64class IOCLifecycle:
65 def __init__(self, ioc_type, value, source, initial_confidence=50):
66 self.ioc_type = ioc_type
67 self.value = value
68 self.source = source
69 self.confidence = initial_confidence
70 self.state = IOCState.DISCOVERED
71 self.created = datetime.utcnow()
72 self.last_updated = datetime.utcnow()
73 self.last_seen = None
74 self.hit_count = 0
75 self.false_positive_count = 0
76 self.history = [{"state": "discovered", "timestamp": self.created.isoformat()}]
77
78 def transition(self, new_state: IOCState, reason=""):
79 self.state = new_state
80 self.last_updated = datetime.utcnow()
81 self.history.append({
82 "state": new_state.value,
83 "timestamp": self.last_updated.isoformat(),
84 "reason": reason,
85 })
86
87 def apply_decay(self):
88 """Apply confidence decay based on IOC type half-life."""
89 half_lives = {"ip": 30, "domain": 90, "hash": 365, "url": 60}
90 half_life = half_lives.get(self.ioc_type, 90)
91 age_days = (datetime.utcnow() - self.created).days
92 decay_factor = 0.5 ** (age_days / half_life)
93 self.confidence = max(0, int(self.confidence * decay_factor))
94
95 def record_hit(self, is_true_positive=True):
96 self.hit_count += 1
97 self.last_seen = datetime.utcnow()
98 if not is_true_positive:
99 self.false_positive_count += 1
100 if self.false_positive_count > 3:
101 self.transition(IOCState.UNDER_REVIEW, "Excessive false positives")
102
103 def should_retire(self):
104 max_ages = {"ip": 90, "domain": 180, "hash": 730, "url": 120}
105 max_age = max_ages.get(self.ioc_type, 180)
106 age_days = (datetime.utcnow() - self.created).days
107 return age_days > max_age and self.hit_count == 0
108```
109
110## Validation Criteria
111
112- IOC lifecycle state machine transitions correctly between phases
113- Confidence decay reduces scores based on IOC type half-life
114- Hit rate and false positive tracking functional
115- Aging policy automatically flags indicators for review/retirement
116- Quality metrics dashboard shows IOC database health
117
118## References
119
120- [MISP Indicator Lifecycle](https://www.misp-project.org/)
121- [STIX Indicator Valid From/Until](https://docs.oasis-open.org/cti/stix/v2.1/stix-v2.1.html)
122- [IOC Quality Framework](https://www.first.org/)
123
124---
125
126**Source:** [`mukul975/Anthropic-Cybersecurity-Skills`](https://github.com/mukul975/Anthropic-Cybersecurity-Skills) → `skills/performing-indicator-lifecycle-management/SKILL.md`