Files
kestrelos/server/plugins/websocket.js
Keli Grubb e61e6bc7e3
All checks were successful
ci/woodpecker/push/push Pipeline was successful
major: kestrel is now a tak server (#6)
## Added

- CoT (Cursor on Target) server on port 8089 enabling ATAK/iTAK device connectivity
- Support for TAK stream protocol and traditional XML CoT messages
- TLS/SSL support with automatic fallback to plain TCP
- Username/password authentication for CoT connections
- Real-time device position tracking with TTL-based expiration (90s default)
- API endpoints: `/api/cot/config`, `/api/cot/server-package`, `/api/cot/truststore`, `/api/me/cot-password`
- TAK Server section in Settings with QR code for iTAK setup
- ATAK password management in Account page for OIDC users
- CoT device markers on map showing real-time positions
- Comprehensive documentation in `docs/` directory
- Environment variables: `COT_PORT`, `COT_TTL_MS`, `COT_REQUIRE_AUTH`, `COT_SSL_CERT`, `COT_SSL_KEY`, `COT_DEBUG`
- Dependencies: `fast-xml-parser`, `jszip`, `qrcode`

## Changed

- Authentication system supports CoT password management for OIDC users
- Database schema includes `cot_password_hash` field
- Test suite refactored to follow functional design principles

## Removed

- Consolidated utility modules: `authConfig.js`, `authSkipPaths.js`, `bootstrap.js`, `poiConstants.js`, `session.js`

## Security

- XML entity expansion protection in CoT parser
- Enhanced input validation and SQL injection prevention
- Authentication timeout to prevent hanging connections

## Breaking Changes

- Port 8089 must be exposed for CoT server. Update firewall rules and Docker/Kubernetes configurations.

## Migration Notes

- OIDC users must set ATAK password via Account settings before connecting
- Docker: expose port 8089 (`-p 8089:8089`)
- Kubernetes: update Helm values to expose port 8089

Co-authored-by: Madison Grubb <madison@elastiflow.com>
Reviewed-on: #6
2026-02-17 16:41:41 +00:00

184 lines
5.2 KiB
JavaScript

import { WebSocketServer } from 'ws'
import { getDb } from '../utils/db.js'
import { handleWebSocketMessage } from '../utils/webrtcSignaling.js'
import { registerCleanup } from '../utils/shutdown.js'
function parseCookie(cookieHeader) {
const cookies = {}
if (!cookieHeader) return cookies
cookieHeader.split(';').forEach((cookie) => {
const [name, ...valueParts] = cookie.trim().split('=')
if (name && valueParts.length > 0) {
cookies[name] = decodeURIComponent(valueParts.join('='))
}
})
return cookies
}
let wss = null
const connections = new Map()
export function getWebSocketServer() {
return wss
}
export function getSessionConnections(sessionId) {
return connections.get(sessionId) || new Set()
}
export function addSessionConnection(sessionId, ws) {
if (!connections.has(sessionId)) {
connections.set(sessionId, new Set())
}
connections.get(sessionId).add(ws)
}
export function removeSessionConnection(sessionId, ws) {
const conns = connections.get(sessionId)
if (conns) {
conns.delete(ws)
if (conns.size === 0) {
connections.delete(sessionId)
}
}
}
export function broadcastToSession(sessionId, message) {
const conns = getSessionConnections(sessionId)
const data = JSON.stringify(message)
for (const ws of conns) {
if (ws.readyState === 1) { // OPEN
ws.send(data)
}
}
}
export default defineNitroPlugin((nitroApp) => {
nitroApp.hooks.hook('ready', async () => {
const server = nitroApp.h3App.server || nitroApp.h3App.nodeServer
if (!server) {
console.warn('[websocket] Could not attach to HTTP server')
return
}
wss = new WebSocketServer({
server,
path: '/ws',
verifyClient: async (info, callback) => {
// Verify session cookie on upgrade request
const cookies = parseCookie(info.req.headers.cookie || '')
const sessionId = cookies.session_id
if (!sessionId) {
callback(false, 401, 'Unauthorized')
return
}
try {
const { get } = await getDb()
const session = await get('SELECT user_id, expires_at FROM sessions WHERE id = ?', [sessionId])
if (!session || new Date(session.expires_at) < new Date()) {
callback(false, 401, 'Unauthorized')
return
}
// Get user role for authorization checks
const user = await get('SELECT id, role FROM users WHERE id = ?', [session.user_id])
if (!user) {
callback(false, 401, 'Unauthorized')
return
}
// Store user_id and role in request for later use
info.req.userId = session.user_id
info.req.userRole = user.role
callback(true)
}
catch (err) {
console.error('[websocket] Auth error:', err)
callback(false, 500, 'Internal Server Error')
}
},
})
wss.on('connection', (ws, req) => {
const userId = req.userId
const userRole = req.userRole
if (!userId || !userRole) {
ws.close(1008, 'Unauthorized')
return
}
let currentSessionId = null
ws.on('message', async (data) => {
try {
const message = JSON.parse(data.toString())
const { sessionId, type } = message
if (!sessionId || !type) {
ws.send(JSON.stringify({ error: 'Invalid message format' }))
return
}
// Verify user has access to this session (authorization check per message)
const { getLiveSession } = await import('../utils/liveSessions.js')
const session = getLiveSession(sessionId)
if (!session) {
ws.send(JSON.stringify({ error: 'Session not found' }))
return
}
// Only session owner or admin/leader can access the session
if (session.userId !== userId && userRole !== 'admin' && userRole !== 'leader') {
ws.send(JSON.stringify({ error: 'Forbidden' }))
return
}
// Track session connection
if (currentSessionId !== sessionId) {
if (currentSessionId) {
removeSessionConnection(currentSessionId, ws)
}
currentSessionId = sessionId
addSessionConnection(sessionId, ws)
}
// Handle WebRTC signaling message
const response = await handleWebSocketMessage(userId, sessionId, type, message.data || {})
if (response) {
ws.send(JSON.stringify(response))
}
}
catch (err) {
console.error('[websocket] Message error:', err)
ws.send(JSON.stringify({ error: err.message || 'Internal error' }))
}
})
ws.on('close', () => {
if (currentSessionId) {
removeSessionConnection(currentSessionId, ws)
}
})
ws.on('error', (err) => {
console.error('[websocket] Connection error:', err)
})
})
console.log('[websocket] WebSocket server started on /ws')
registerCleanup(async () => {
if (wss) {
wss.close()
wss = null
}
})
})
nitroApp.hooks.hook('close', () => {
if (wss) {
wss.close()
wss = null
}
})
})