Merge pull request #9 from rticommunity/feature/04-security-threat

feat: add Module 04 — Security Threat Demonstration

Author: wcoleman-rti

.gitignore

@@ -2,6 +2,8 @@
 .venv/
 build/
 Types.py
+builtin_logging_type.py
+*_timestamp.cmake
 *.pyc
 *.pem
 *.p7s

CHANGELOG.md

@@ -7,6 +7,43 @@ and this project adheres to [Semantic Versioning](https://semver.org/).
 
 ## [Unreleased]
 
+## [1.1.0] - 2026-03-27
+
+### Added
+
+- **Module 04 — Security Threat Demonstration**: Two Python/PySide6 GUI
+  applications (Threat Injector and Threat Exfiltrator) that simulate
+  real-world DDS security attack scenarios (Rogue CA, Forged Permissions,
+  Expired Certificate) against the operating room bus
+- Module 04 security infrastructure: `setup_threat_security.sh` script,
+  OpenSSL configs, XML governance and permissions templates for rogue CA,
+  forged permissions, and expired certificate attack modes
+- Module 04 DDS configuration: `ThreatParticipantLibrary.xml` and
+  `ThreatQos.xml` with partition-scoped threat participants
+- Module 04 launch and kill scripts (`launch_injector.sh`,
+  `launch_exfiltrator.sh`, `kill_all.sh`)
+- Module 04 local `DdsUtils.py` utility for participant and security
+  configuration
+- `.gitignore` for Module 04 security directory to exclude generated
+  certificates, keys, and OpenSSL CA database files
+
+### Changed
+
+- **Module 01 — PyQt5 → PySide6 migration**: Arm.py and PatientMonitor.py
+  ported from PyQt5 to PySide6 (updated imports, enum-style Qt constants,
+  `Signal` instead of `pyqtSignal`, `app.exec()` instead of `app.exec_()`)
+- Module 01 `CMakeLists.txt`: replaced manual `execute_process` codegen call
+  with proper `connextdds_rtiddsgen_run` targets for Python type generation
+  (both `Types.xml` and `builtin_logging_type.idl`); added `refArchTypesPy`
+  custom target
+- Module 01 `README.md`: updated Python dependency references from PyQt5 to
+  PySide6
+- `system_arch/qos/Qos.xml`: removed volatile durability override from
+  secure-log DataReader QoS profile
+- Root `.gitignore`: added patterns for `builtin_logging_type.py` and
+  `*_timestamp.cmake` generated files
+- Updated `rticonnextdds-cmake-utils` submodule to latest commit
+
 ## [1.0.0] - 2026-03-25
 
 Initial stable release of the RTI MedTech Reference Architecture.

README.md

@@ -13,6 +13,7 @@ This repository contains documentation and module demo applications showcasing d
   - [Module 01: Digital Operating Room](#module-01--digital-operating-room)
   - [Module 02: RTI Recording Service & RTI Replay Service](#module-02--rti-recording-service--rti-replay-service)
   - [Module 03: Remote Teleoperation with RTI Real-Time WAN Transport](#module-03--remote-teleoperation-with-rti-real-time-wan-transport)
+  - [Module 04: Security Threat Demonstration](#module-04--security-threat-demonstration)
 - [Hands-On: Architecture](#hands-on-architecture)
 - [Architecture Overview](#architecture-overview)
   - [Data Types](#data-types)
@@ -73,6 +74,8 @@ The RTI MedTech Reference Architecture demonstrates use cases and capabilities o
 
 - ### [Module 03](./modules/03-remote-teleoperation/) : Remote Teleoperation with RTI Real-Time WAN Transport
 
+- ### [Module 04](./modules/04-security-threat/) : Security Threat Demonstration
+
 ## Hands-On: Architecture
 
 RTI System Designer allows you to graphically design, configure, examine, and share Connext system architectures.
@@ -269,4 +272,5 @@ Check out the the [system_arch](./system_arch/) folder, where the system archite
 - [Connext Real-Time WAN Transport](https://community.rti.com/static/documentation/connext-dds/7.3.0/doc/manuals/connext_dds_professional/users_manual/users_manual/PartRealtimeWAN.htm) *, used in Module 03: Remote Teleoperation with RTI Real-Time WAN Transport*
 - [RTI Routing Service](https://community.rti.com/static/documentation/connext-dds/7.3.0/doc/manuals/connext_dds_professional/services/routing_service/index.html) *, used in Module 03: Remote Teleoperation with RTI Real-Time WAN Transport*
 - [RTI Cloud Discovery Service](https://community.rti.com/static/documentation/connext-dds/7.3.0/doc/manuals/addon_products/cloud_discovery_service/index.html) *, used in Module 03: Remote Teleoperation with RTI Real-Time WAN Transport*
+- [RTI Security Plugins Users Manual](https://community.rti.com/static/documentation/connext-dds/7.3.0/doc/manuals/connext_dds_secure/users_manual/index.html) *, used in Module 04: Security Threat Demonstration*
 - [RTI Connext Third-Party Software](https://community.rti.com/static/documentation/connext-dds/7.3.0/doc/manuals/connext_dds_professional/release_notes_3rdparty/index.html)

modules/01-operating-room/CMakeLists.txt

@@ -56,7 +56,17 @@ connextdds_rtiddsgen_run(
     UNBOUNDED
 )
 
-# Generate C++ types for DDS Security builtin logging topic when NDDSHOME is available.
+# Generate Python types for application use (output alongside source files so
+# DdsUtils.py in this module and module 04 can import them directly)
+connextdds_rtiddsgen_run(
+    IDL_FILE
+    "${CMAKE_CURRENT_SOURCE_DIR}/../../system_arch/Types.xml"
+    OUTPUT_DIRECTORY
+    "${CMAKE_CURRENT_SOURCE_DIR}/src/"
+    LANG Python
+)
+
+# Generate C++ types for DDS Security builtin logging topic.
 set(BUILTIN_LOGGING_IDL "${CONNEXTDDS_DIR}/resource/idl/builtin_logging_type.idl")
 connextdds_rtiddsgen_run(
     IDL_FILE
@@ -67,10 +77,20 @@ connextdds_rtiddsgen_run(
     UNBOUNDED
 )
 
-# Use command line to manually generate Python types
-execute_process(
-    COMMAND bash -c "${RTICODEGEN_DIR}/rtiddsgen ../../system_arch/Types.xml -ppDisable -d src -language python -create typefiles"
-    WORKING_DIRECTORY ${CMAKE_CURRENT_SOURCE_DIR}
+# Generate Python types for DDS Security builtin logging topic (used by module 04
+# SecureLogUtils.py via the same _OR_SRC import path as Types.py)
+connextdds_rtiddsgen_run(
+    IDL_FILE
+    "${BUILTIN_LOGGING_IDL}"
+    OUTPUT_DIRECTORY
+    "${CMAKE_CURRENT_SOURCE_DIR}/src/"
+    LANG Python
+)
+
+add_custom_target(refArchTypesPy ALL
+    DEPENDS
+        ${Types_PYTHON_SOURCES}
+        ${builtin_logging_type_PYTHON_SOURCES}
 )
 
 # Build object library with types

modules/01-operating-room/README.md

@@ -62,7 +62,7 @@ Dependencies for building the C++ applications:
 
 Dependencies for the Python GUI applications (*Arm Monitor*, *Patient Monitor*):
 
-- `PyQt5` — Qt5 widget toolkit
+- `PySide6` — PySide6 Qt widget toolkit
 - `pyqtgraph` — fast scientific plotting
 - `numpy` — numerical arrays
 
@@ -74,7 +74,7 @@ sudo apt install \
     pkg-config \
     libgtkmm-3.0-dev \
     python3-pip \
-    python3-pyqt5 \
+    python3-pyside6 \
     python3-numpy \
     python3-pyqtgraph
 ```
@@ -96,7 +96,7 @@ Then install the Python packages:
 
 ```bash
 pip install \
-    PyQt5 \
+    PySide6 \
     pyqtgraph \
     numpy
 ```

modules/01-operating-room/src/Arm.py

@@ -15,12 +15,12 @@
 import time
 import threading
 
-from PyQt5.QtWidgets import (
+from PySide6.QtWidgets import (
     QApplication, QMainWindow, QWidget, QLabel, QFrame,
     QHBoxLayout, QVBoxLayout, QSizePolicy, QScrollArea
 )
-from PyQt5.QtCore import Qt, QTimer, QRectF, QPointF, pyqtSignal, QObject
-from PyQt5.QtGui import (
+from PySide6.QtCore import Qt, QTimer, QRectF, QPointF, Signal, QObject
+from PySide6.QtGui import (
     QPainter, QColor, QPen, QBrush, QFont, QConicalGradient, QPainterPath,
     QPixmap, QIcon
 )
@@ -84,22 +84,22 @@ def set_value(self, v: float):
 
     def paintEvent(self, event):
         p = QPainter(self)
-        p.setRenderHint(QPainter.Antialiasing)
+        p.setRenderHint(QPainter.RenderHint.Antialiasing)
 
         side = min(self.width(), self.height()) - 10
         rect = QRectF((self.width() - side) / 2,
                       (self.height() - side) / 2,
                       side, side)
 
         # ── Background track ──────────────────────────────────────
-        pen_bg = QPen(QColor("#1A2A40"), 8, Qt.SolidLine, Qt.FlatCap)
+        pen_bg = QPen(QColor("#1A2A40"), 8, Qt.PenStyle.SolidLine, Qt.PenCapStyle.FlatCap)
         p.setPen(pen_bg)
         p.drawArc(rect, 225 * 16, -270 * 16)   # 270° arc, starts at 225°
 
         # ── Foreground arc (value / 360 × 270°) ───────────────────
         span = int((self._value / 360.0) * 270 * 16)
         grad_color = self.color
-        pen_fg = QPen(grad_color, 8, Qt.SolidLine, Qt.FlatCap)
+        pen_fg = QPen(grad_color, 8, Qt.PenStyle.SolidLine, Qt.PenCapStyle.FlatCap)
         p.setPen(pen_fg)
         p.drawArc(rect, 225 * 16, -span)
 
@@ -117,16 +117,16 @@ def paintEvent(self, event):
         back_x = cx - hub_r * _math.cos(angle_rad)
         back_y = cy + hub_r * _math.sin(angle_rad)
         # Draw shadow
-        pen_shadow = QPen(QColor("#000000"), 4, Qt.SolidLine, Qt.RoundCap)
+        pen_shadow = QPen(QColor("#000000"), 4, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap)
         p.setPen(pen_shadow)
         p.drawLine(QPointF(back_x + 1, back_y + 1), QPointF(tip_x + 1, tip_y + 1))
         # Draw needle
-        pen_needle = QPen(grad_color, 2.5, Qt.SolidLine, Qt.RoundCap)
+        pen_needle = QPen(grad_color, 2.5, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap)
         p.setPen(pen_needle)
         p.drawLine(QPointF(back_x, back_y), QPointF(tip_x, tip_y))
 
         # ── Centre dot ────────────────────────────────────────────
-        p.setPen(Qt.NoPen)
+        p.setPen(Qt.PenStyle.NoPen)
         p.setBrush(QBrush(grad_color))
         p.drawEllipse(QPointF(cx, cy), 4, 4)
 
@@ -168,7 +168,7 @@ def __init__(self, motor: SurgicalRobot.Motors, parent=None):
         self.name  = JOINT_NAMES[motor]
         self._angle = 180.0
 
-        self.setFrameShape(QFrame.Box)
+        self.setFrameShape(QFrame.Shape.Box)
         self.setStyleSheet(f"""
             JointRow {{
                 background-color: {BG_PANEL};
@@ -198,9 +198,9 @@ def _build_ui(self):
         gauge_col.setSpacing(2)
         self.gauge = ArcGauge(self.color)
         self.gauge.set_value(180.0)
-        gauge_col.addWidget(self.gauge, alignment=Qt.AlignHCenter)
+        gauge_col.addWidget(self.gauge, alignment=Qt.AlignmentFlag.AlignHCenter)
         self.angle_lbl = QLabel("180.0°")
-        self.angle_lbl.setAlignment(Qt.AlignCenter)
+        self.angle_lbl.setAlignment(Qt.AlignmentFlag.AlignCenter)
         self.angle_lbl.setStyleSheet(
             f"color: {self.color}; font-size: 20px; font-weight: bold; "
             f"background: transparent;"
@@ -254,7 +254,7 @@ def __init__(self, parent=None):
         super().__init__(parent)
         self._angles: dict = {m: 180.0 for m in _MOTORS_ORDERED}
         self.setMinimumWidth(260)
-        self.setSizePolicy(QSizePolicy.Expanding, QSizePolicy.Expanding)
+        self.setSizePolicy(QSizePolicy.Policy.Expanding, QSizePolicy.Policy.Expanding)
         self.setStyleSheet(f"background-color: {BG_PANEL};")
 
     def update_angles(self, angles: dict):
@@ -266,14 +266,14 @@ def update_angles(self, angles: dict):
     def paintEvent(self, event):
         w, h = self.width(), self.height()
         p = QPainter(self)
-        p.setRenderHint(QPainter.Antialiasing)
+        p.setRenderHint(QPainter.RenderHint.Antialiasing)
 
         # Background
         p.fillRect(self.rect(), QColor(BG_PANEL))
 
         # Title
         p.setPen(QPen(QColor("#445566")))
-        p.setFont(QFont("Courier New", 11, QFont.Bold))
+        p.setFont(QFont("Courier New", 11, QFont.Weight.Bold))
         p.drawText(12, 22, "ARM VISUALIZATION")
 
         # Scale segment length so the full arm (5 links) fills ~90 % of the
@@ -319,7 +319,7 @@ def paintEvent(self, event):
             color = QColor(JOINT_COLORS[motor])
             x0, y0 = points[i]
             x1, y1 = points[i + 1]
-            pen = QPen(color, link_pen_width, Qt.SolidLine, Qt.RoundCap)
+            pen = QPen(color, link_pen_width, Qt.PenStyle.SolidLine, Qt.PenCapStyle.RoundCap)
             p.setPen(pen)
             p.drawLine(QPointF(x0, y0), QPointF(x1, y1))
 
@@ -351,7 +351,7 @@ def paintEvent(self, event):
             # joint name label (abbreviated, 3 chars)
             name = JOINT_NAMES[motor][:3]
             p.setPen(QPen(color))
-            p.setFont(QFont("Courier New", 16, QFont.Bold))
+            p.setFont(QFont("Courier New", 16, QFont.Weight.Bold))
             label_x = cx + jr + 8
             label_y = cy + 6
             p.drawText(QPointF(label_x, label_y), name)
@@ -402,7 +402,7 @@ def _build_ui(self):
         if not _logo_px.isNull():
             logo_lbl = QLabel()
             logo_lbl.setStyleSheet("background: transparent;")
-            logo_lbl.setPixmap(_logo_px.scaled(56, 56, Qt.KeepAspectRatio, Qt.SmoothTransformation))
+            logo_lbl.setPixmap(_logo_px.scaled(56, 56, Qt.AspectRatioMode.KeepAspectRatio, Qt.TransformationMode.SmoothTransformation))
             h_layout.addWidget(logo_lbl)
 
         rti_lbl = QLabel("RTI Connext")
@@ -593,7 +593,7 @@ def run(self):
         self.window.show()
         print("Started Arm")
 
-        app.exec_()
+        app.exec()
 
         print("Shutting down Arm")
         self.arm_status.status = Common.DeviceStatuses.OFF