Network Diagnostics

WebSocket & WSS Connection Diagnostics

If your Android Spoofer reports Status: DISCONNECTED, or refuses to connect with a security warning, use this diagnostic guide to isolate transport and authentication failures.

Automated Diagnostic Tool

Run "Test Connection" First

Inside the Mockery Android app (under Settings > Profile Manager), tap Test Connection. The diagnostic engine tests four discrete stages:

1. WebSocket Handshake & TLS ✓ PASS
2. Spoofer Authentication Token ✓ PASS
3. Location Poll Request ($GET_LOCATION) ✓ PASS
4. Valid JSON Coordinate Response ✓ PASS

If any stage fails, the diagnostic report pinpoints the exact failure reason below.

1. "Authentication credentials require a secure WebSocket connection (WSS)"

Security Rule

The Cause: You entered a username and password in your provider profile, but selected an unencrypted ws:// connection.

Why Mockery Enforces This: Transmitting plaintext credentials over unencrypted WebSockets allows anyone on public Wi-Fi to intercept your device password. Mockery strictly refuses to connect until TLS is enabled.
The Solution:
  • Change protocol from ws:// to wss://.
  • Set port to 443.
  • Ensure the hostname is set to www.tool3.com.

2. Corporate Firewall Blocking Outbound WebSockets

Certain enterprise office networks, university Wi-Fi systems, and hotel captive portals inspect HTTPS traffic and block persistent WebSocket upgrades (Upgrade: websocket).

Verification Test:
  1. Temporarily disconnect your phone from office Wi-Fi and switch to mobile cellular data (5G/4G).
  2. Tap Test Connection again in Mockery Spoofer.
  3. If the connection succeeds on cellular, your local Wi-Fi router or firewall is dropping WebSocket packets.

3. Authentication Rejection (HTTP 401 / Invalid Credentials)

If the WebSocket connects but Stage 2 fails with "Invalid credentials", the device username or password does not match MySQL records:

  1. Log into your account at Mockery Controller.
  2. Open the Devices panel and locate your phone.
  3. Click Reset Password to generate a fresh password.
  4. Update the password in your Android Spoofer profile and tap Save.

Need Help with Other Issues?

Check our guide on preventing simulated location jumping or review master troubleshooting topics.