AEGIS Secure Messenger Demo

Autonomous Encryption Governance & Intelligent Switching

A hackathon demo app that visually simulates breaking RSA-512 and upgrading to ML-KEM-768 + ML-DSA-65 (CRYSTALS-Dilithium) with real-time interaction via Socket.IO.

---

Quick Start (under 5 minutes)

1. Install dependencies

cd aegis-demo
npm install

2. Start the server

npm start

3. Open interfaces

• Admin Dashboard → http://localhost:3000
• Judge Interface → http://localhost:3000/judge
  • Or scan the QR code shown in the terminal / admin dashboard

---

How it works

1. Admin opens the dashboard on their laptop (/)
2. Judge scans the QR code on their phone → opens /judge
3. Judge types a message and hits SEND SECURE MESSAGE
4. Admin sees:
   • Message appear in the Incoming Messages panel
   • 28-step encryption log stream in real time (RSA-512 break → ML-KEM migration)
   • After ~12s, a decision card appears in the Control Panel
5. Admin clicks APPROVE, REJECT, or AUTO (50/50)
6. Judge's phone shows either:
   • ✅ A downloadable AEGIS Quantum-Safe Certificate
   • ❌ A rejection card

---

For ngrok (external QR access — judge on different network)

# Install ngrok: https://ngrok.com/download
ngrok http 3000

Then update the QR URL manually by opening: http://localhost:3000/api/qr after setting NGROK_URL=https://xxxx.ngrok.io in env.

Or simply share the ngrok URL directly with the judge.

---

File Structure

aegis-demo/
├── server.js           # Express + Socket.IO server, QR generation, encryption simulation
├── package.json
├── README.md
└── public/
    ├── index.html      # Admin dashboard (3-panel layout)
    ├── judge.html      # Judge mobile interface
    ├── style.css       # Shared cybersecurity dark theme
    └── script.js       # Shared utilities

---

Tech Stack

Component	Technology
Server	Node.js + Express
Real-time	Socket.IO
QR Code	qrcode (npm)
Crypto	Simulated (demo only)
Frontend	Plain HTML/CSS/JS
Fonts	IBM Plex Mono + Exo 2

---

Notes

• All cryptographic operations are simulated for demo purposes
• The Deterministic Arbiter with 7 checks is visually simulated
• Real implementations use liboqs (Open Quantum Safe)
• Target: PSIT Kanpur PROTECH 2026 | Team AEGIS

---

AI Proposes. The Arbiter Verifies. Post-Quantum Cryptography Seals. Nothing Executes Without Passing All 7 Checks.