detecting-attacks-on-historian-servers

Detect unauthorized access, data manipulation, and lateral movement targeting OT historian servers.

954|172|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/xalgord/xalgorix --skill detecting-attacks-on-historian-servers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: detecting-attacks-on-historian-servers
Source: https://github.com/xalgord/xalgorix/tree/main/internal/tools/skills/data/ot-ics-security/detecting-attacks-on-historian-servers
Command: npx skills add https://github.com/xalgord/xalgorix --skill detecting-attacks-on-historian-servers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests.

What problem does it solve?

OT historian servers like OSIsoft PI and Ignition sit at the IT/OT boundary and are prime pivot points for attackers moving between enterprise and control networks, yet their compromise indicators often go undetected.

Core Features & Use Cases

  • Unauthorized Client Detection: Queries PI Web API or Ignition API for active connections and flags clients outside an authorized baseline.
  • Data Integrity Validation: Detects flatlined or replayed tag values (Stuxnet-style replay attacks) and missing data indicating deletion.
  • Lateral Movement Indicators: Identifies historians initiating outbound connections to PLC ports (502, 102, 44818), unauthorized processes, and anomalous authentication.
  • Use Case: A security team monitoring a plant's PI server uses this to detect an unauthorized client IP querying process tags and a flatlined reactor temperature tag, catching a replay attack before escalation.

Quick Start

Run the historian attack detector against my OSIsoft PI server at pi-server.plant.local with my authorized client list and check the last 24 hours of reactor temperature and pump flow tags for integrity issues.

Frequently Asked Questions about detecting-attacks-on-historian-servers

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I detect attacks on OSIsoft PI historian servers?

Query the PI Web API system status endpoint for connected clients and compare them against an authorized baseline. Also check recorded tag data for flatlines (constant values across many points) and gaps indicating deletion or replay attacks.

How to detect data replay attacks on OT historians?

Replay attacks appear as flatlined tags where a constant value repeats across hundreds of data points, effectively bypassing PI compression. Check recorded values over a time window and flag tags where all values are identical despite expected process variation.

Does this work with Ignition SCADA historians?

Yes, the detector supports Ignition via its status connections API using bearer token authentication, alongside OSIsoft PI via the PI Web API. It flags unauthorized client connections on both platforms.

What indicates a historian is being used as a pivot point?

A compromised historian initiates outbound connections to Level 1/2 devices on ports like 502, 102, 44818, or 20000, which it should never do since it only receives data. Also watch for unauthorized processes and logons from non-baseline sources.

When should I not use historian attack detection?

Do not use it for general database security monitoring, historian deployment or configuration, or IT-only data warehouse security. Validate detections on a non-production instance and cross-check alerts against change and maintenance logs first.