OSINT Ontology Quick Reference¶
Quick reference for OSINT entities, relationships, and implementation
Entity Types at a Glance¶
| Entity | Purpose | Key Attributes |
|---|---|---|
| Person | Individual humans | name, aliases, usernames, emails, phones |
| Organization | Companies, orgs | legal_name, registration_number, directors |
| Account | Platform IDs | platform, username, display_name, verified |
| Domain | Websites | name, dns_records, ssl_certificate, hosting |
| Email addresses | address, breach_history, reputation | |
| Phone | Phone numbers | e164_format, line_type, carrier |
| Location | Places | name, coordinates, type (city/venue/gps) |
| Image | Photos/media | hash, exif, gps, authenticity |
| Investigation | Cases | id, target_type, scope, depth |
Relationship Types Quick Reference¶
Identity Resolution¶
SAME_PERSON_AS (95-100%) — Confirmed same person
LIKELY_SAME_PERSON (70-94%) — Probable match
POSSIBLY_SAME_PERSON (50-69%) — Tentative
DIFFERENT_PERSON (95-100%) — Confirmed different
Digital Identity¶
HAS_EMAIL Person → Email
HAS_PHONE Person → Phone
HAS_ACCOUNT Person → Account
REGISTERED_WITH Account → Email
Professional¶
WORKS_AT Person → Org (since, title)
DIRECTOR_OF Person → Org (appointed, resigned)
FOUNDER_OF Person → Org
EMPLOYS Org → Person
Corporate¶
PARENT_OF Org → Org (ownership_pct)
SUBSIDIARY_OF Org → Org
OWNS Org → Domain
FUNDED_BY Org → Investor
COMPETES_WITH Org ↔ Org
Infrastructure¶
Social¶
Confidence Levels¶
| Level | Range | When to Use |
|---|---|---|
| Confirmed | 95-100% | Verified email, exact profile match, explicit cross-link |
| High | 80-94% | Same unique identifier, strong temporal correlation |
| Medium | 60-79% | Similar usernames + network overlap |
| Low | 40-59% | Username pattern only |
| Tentative | 0-39% | Weak association, needs verification |
Knowledge Graph Groups¶
osint-people → Person entities
osint-organizations → Organization entities
osint-accounts → Platform accounts
osint-domains → Domain/DNS entities
osint-emails → Email entities
osint-phones → Phone entities
osint-locations → Location entities
osint-images → Image entities
osint-investigations → Investigation cases
Common Episode Patterns¶
Username Enumeration Episode¶
Person: John Smith
Usernames: twitter: @jsmith, github: jsmith-dev
Emails: john@example.com
Accounts Found: 15
Confidence: 85%
Sources: Twitter API, GitHub Profile
Corporate Profile Episode¶
Organization: Acme Corporation Inc.
Registration: DE-12345678
Jurisdiction: Delaware
Founded: 2015-03-15
Directors: Jane Smith (CEO), John Doe (CTO)
Subsidiaries: Acme UK Ltd, Acme Labs Inc.
Confidence: 92%
Sources: Delaware Registry, SEC EDGAR
Implementation Checklist¶
- Define custom entities in Pydantic models
- Register custom entities with Graphiti
- Define custom relationship types
- Create episode processors for each workflow
- Test with sample OSINT data
- Integrate with existing OSINT workflows
- Set up knowledge graph groups
- Configure Neo4j/FalkorDB connection
- Add confidence scoring framework
- Implement temporal tracking (bi-temporal)
- Add provenance tracking
Related Documentation¶
- OSINT_ONTOLOGY.md - Complete ontology specification
- GRAPHITI_IMPLEMENTATION.md - Implementation guide
- KNOWLEDGE_GROUPS.md - Group naming conventions
Version: 1.0.0 Last Updated: 2026-02-04