mirror of
https://github.com/SHOGGOTH-SECTOR/sica-fondt.git
synced 2026-08-01 16:40:24 +00:00
24f816b6a3
Place useful parts of the surrounding repos into sica-fondt by layer, per the
body model (Ada = membrane; brain/endocrine/capabilities/knowledge non-Ada):
- brain/ LLM reasoning + providers (dapr, hermes, MoMoA)
- capabilities/ REPRAG sidecars: hermes tools/skills, dapr tools, parallel
dispatch, A51 channels, and the OSINT cluster
- knowledge/ LORAG corpus: 754 cyber-skills, agency personas, secure-coding,
MITRE ATT&CK data
- reference/ defensive threat-reference (C3, shhbruh doc) + AdaYaml parser
License handling: AGPL sources (worldosint, advanced_evolution, mercury,
Reticulum) and GPL DeTTECT are SPEC-only clean-room/port descriptions — no
copyleft code copied. MIT/Apache/data parts copied as working trees.
Safety: shhbruh escape/persistence material and C3 covert-C2 kept as reference
only, not wired into the running organism. See CONSOLIDATION.md.
https://claude.ai/code/session_01UehUqEXXJJCsHoA4voCU5c
67 lines
1.9 KiB
Markdown
67 lines
1.9 KiB
Markdown
# API Reference: Detecting Business Email Compromise
|
|
|
|
## Python email Library
|
|
|
|
```python
|
|
import email
|
|
from email import policy
|
|
|
|
# Parse .eml file
|
|
with open("message.eml") as f:
|
|
msg = email.message_from_file(f, policy=policy.default)
|
|
|
|
msg.get("From") # sender header
|
|
msg.get("Reply-To") # reply-to header
|
|
msg.get("Authentication-Results") # SPF/DKIM/DMARC results
|
|
body = msg.get_body(preferencelist=("plain", "html"))
|
|
body.get_content() # decoded body text
|
|
```
|
|
|
|
## Authentication Header Patterns
|
|
|
|
| Result | Meaning |
|
|
|--------|---------|
|
|
| `spf=pass` | Sender IP authorized by domain SPF record |
|
|
| `spf=fail` | Sender IP NOT in SPF record |
|
|
| `dkim=pass` | DKIM signature valid |
|
|
| `dkim=fail` | DKIM signature invalid or missing |
|
|
| `dmarc=pass` | SPF or DKIM aligned with From domain |
|
|
| `dmarc=fail` | Neither SPF nor DKIM aligned |
|
|
|
|
## BEC Attack Types (FBI IC3)
|
|
|
|
| Type | Description |
|
|
|------|-------------|
|
|
| CEO Fraud | Impersonates executive requesting wire transfer |
|
|
| Invoice Fraud | Fake invoice with changed bank details |
|
|
| Account Compromise | Compromised email used for payment requests |
|
|
| Attorney Impersonation | Urgent legal matter requiring funds |
|
|
| Data Theft | Requests for W-2 / PII from HR |
|
|
|
|
## BEC Indicator Regex Patterns
|
|
|
|
```python
|
|
# Financial urgency
|
|
r"\b(wire transfer|bank transfer|routing number)\b"
|
|
# Secrecy pressure
|
|
r"\b(confidential|do not share|keep this between us)\b"
|
|
# Gift card fraud
|
|
r"\b(gift card|bitcoin|crypto|western union)\b"
|
|
# Account change
|
|
r"\b(change.*(bank|account|payment))\b"
|
|
```
|
|
|
|
## Microsoft Graph API - Mail Security
|
|
|
|
```http
|
|
GET https://graph.microsoft.com/v1.0/me/messages?$filter=internetMessageHeaders/any(h: h/name eq 'Authentication-Results')
|
|
Authorization: Bearer {token}
|
|
```
|
|
|
|
## CLI Usage
|
|
|
|
```bash
|
|
python agent.py --email-file suspicious.eml --vip-names "John Smith" "Jane CEO"
|
|
python agent.py --scan-dir /var/mail/quarantine/ --vip-names "CFO Name"
|
|
```
|