Network guard verification and test suite
Trust in software privacy cannot rely on marketing statements alone; it must be backed by verifiable architectural constraints. Oyma includes an automated network guard system backed by continuous integration test suites.
How the network guard enforces isolation
When Local-only mode is enabled, Oyma enforces two layers of network interception:
- Renderer Process Interception: Monkey-patches native
fetch,XMLHttpRequest, andWebSocketinterfaces to immediately reject outbound calls before network dispatch. - Main Process Socket Interception: Overrides Electron/Node net session handlers, immediately aborting any HTTP/HTTPS requests originating from internal modules.
Outgoing Request Attempt
│
▼
[Local-Only Mode Flag Active?]
├──► YES ──► [Immediate Abort Error: ERR_NETWORK_GUARD_BLOCKED]
└──► NO ──► [Dispatch to Egress Log for Real-Time Auditing]
Running the self-diagnostic test
In Settings › Privacy › Network Guard Diagnostics, click Run Verification Suite:
The diagnostic suite runs four automated security probes:
- Public IP Ping: Attempts an HTTP request to
https://1.1.1.1/dns-query. - Analytics Beacon Probe: Verifies telemetry endpoints reject payload transmission.
- DNS Resolution Check: Asserts that background host lookups are suspended.
- WebSocket Connection Probe: Attempts an external socket handshake.
All four probes must return BLOCKED (PASS) to confirm that your Mac remains completely isolated.
Related guides
- Mode setup in Local-only mode.
- Real-time ledger in Egress log.
- Air-gapped guide in Air-gapped Mac deployment protocol.
Questions
What is the network guard?
The network guard is an architectural security layer that intercepts and blocks outbound socket requests when Local-only mode is active.
How is the network guard tested?
An automated integration test suite attempts outbound socket connections and verifies that requests are rejected with immediate errors.
Can I run the network guard tests myself?
Yes. Open Settings › Privacy › Diagnostics and click 'Verify Network Guard' to run the automated socket isolation test.