Panduan Integrasi Tactical RMM
Hermes Network 360 Guard — Desktop Client (Windows & macOS)
Mulai dari Pendahuluan Lihat Arsitektur
Tentang Dokumen Ini
Dokumen ini adalah panduan lengkap untuk merefactor integrasi Tactical RMM di aplikasi desktop Hermes Network 360 Guard (HermesNetwork360-Avalonia) — dari pendekatan ad-hoc berbasis IPC custom yang ada saat ini, menjadi arsitektur tiga-lapis yang bersih, terstandar, dan mudah dipelihara.
Audiens
Dokumen ini ditulis untuk:
- Engineer .NET / Avalonia yang akan mengimplementasikan refactor di sisi desktop client
- Backend engineer yang akan menyiapkan Supabase Edge Function sebagai proxy ke TRMM API
- DevOps / SRE yang mengelola server TRMM dan agent deployment
- Tech lead yang perlu memahami trade-off arsitektur sebelum approve scope kerja
Prasyarat pengetahuan
Anda diharapkan sudah familiar dengan:
- Pemrograman C# dan ekosistem .NET 8
- Konsep dasar REST API, JSON, HTTP
- Operasi systemctl/launchctl pada level dasar
- Konsep dasar TRMM (Tactical Remote Monitoring & Management)
Tidak perlu paham TRMM secara mendalam — bagian-bagian penting akan dijelaskan kembali di tempat yang relevan.
Daftar Isi
| # | Bab | Ringkasan |
|---|---|---|
| 1 | Pendahuluan | Konteks, masalah saat ini, tujuan refactor |
| 2 | Arsitektur | Diagram before/after, tiga lapis terpisah |
| 3 | Prasyarat | Setup TRMM server, NuGet, environment |
| 4 | Layer 1 — TrmmApiClient | HTTP client typed untuk TRMM REST API |
| 5 | Layer 2 — AgentSupervisor | Service lifecycle lokal, Win + Mac |
| 6 | Layer 3 — Enrollment Flow | Deployment URL, install, polling |
| 7 | Authentication & Keamanan | JWT exchange, token rotation, threat model |
| 8 | Dukungan macOS | LaunchDaemon, signing, notarization |
| 9 | TRMM API Reference | Endpoint cheat-sheet |
| 10 | Rencana Migrasi | Phase 0–6, rollback |
| 11 | Troubleshooting | Error umum + debugging |
| 12 | FAQ | Pertanyaan & keputusan desain |
Konvensi
Sepanjang dokumen ini:
- Kode contoh dalam C# ditarget untuk .NET 8 (TFM
net8.0). - Kode Python untuk Edge Function / utilitas server menggunakan Python 3.10+.
- Path Windows menggunakan format
C:\Path\To\File.exe. - Path macOS / Linux menggunakan format
/Library/...atau/etc/.... - Block dengan
bashadalah perintah shell yang bisa dijalankan di server. - Block dengan
csharpadalah snippet untuk drop-in ke project Avalonia.
Catatan: kalau Anda baru menemukan dokumen ini, mulai dari Pendahuluan dan baca berurutan. Kalau Anda hanya butuh referensi cepat, langsung ke API Reference atau Troubleshooting.
Versi & Pembaruan
| Tanggal | Versi | Catatan |
|---|---|---|
| 2026-04-21 | 1.0 | Versi awal — refactor arsitektur tiga-lapis |
Saran perbaikan dokumen → buka issue di repo GitHub Pages atau hubungi tim engineering Hermes Network Inc.