Troubleshoot: JumpCloud Protect

This article contains troubleshooting steps for common issues with JumpCloud Protect.

My users cannot receive push notifications.

Here are some troubleshooting hints to ensure your users receive push notifications: 

  • Verify that the device is not in "Do Not Disturb" mode.
  • Ensure that the device is connected to a strong Wi-Fi or cellular data signal.
  • If using iOS, ensure that the JumpCloud Protect app has permission to receive push notifications in Settings. 
  • Restart the device and see if notifications have resumed.
  • Contact JumpCloud's Support team.

Tip:

A rare scenario can occur (for example after an OS update) where the token used for push notifications can change and cause users to not receive further notifications. In this case, users can open the Protect app to refresh the token, and notifications should resume. If the notifications still aren't working, the IT Admin can remove enrollment and re-enroll the user.

Focus Modes (e.g., Do Not Disturb, Work, Sleep) or incorrect notification settings on iOS can block JumpCloud Protect push notifications.

Solution:

  1. On your iOS device, open Settings > Focus.
    • Check if any Focus modes are active.
    • If a Focus mode is on, click it to disable it temporarily or allow JumpCloud Protect notifications within its settings.
  2. Verify JumpCloud Protect's notification permissions:
    • Go to Settings > Notifications.
    • Scroll down and select JumpCloud Protect.
    • Ensure Allow Notifications is ON.
    • Check that Alerts (Lock Screen, Notification Center, Banners) are enabled as desired.
    • Enable Sounds and Badges if you want those indicators.
  3. Test JumpCloud Protect notifications by triggering an MFA login prompt.
My JumpCloud Protect notification did not display on my Android device.

On Android devices, Push notifications do not wake the device from sleep, though a sound may play if enabled. Your users will need to wake the device before interacting with the Push notification. Also, notifications get grouped, so a user must drag down on the notifications from the top to view all of them.

What if one of my users wiped their device or got a new device?

If your users have configured an alternate MFA method such as TOTP or WebAuthn, they can use that method to log into their User Portal and remove Push enrollment and re-enroll. If they have not set up an alternative factor, the IT admin can remove Push enrollment.

Mobile Biometric authentication is not working.

For Apple devices:

If biometrics still aren't working, use a different MFA factor such as TOTP or webauthn.

Apple’s iCloud Private Relay feature may interfere with push notifications for some apps, including JumpCloud Protect.

To prevent this, disable the private relay by following these steps:

  1. On your iOS device, go to Settings > [Your Name/Apple ID] > iCloud.
  2. Select Private Relay.
  3. Click the toggle key to turn Private Relay OFF.
  4. Restart your iOS device.
  5. Test JumpCloud Protect notifications again.

Disabling Private Relay may affect browsing privacy. You can re-enable it after testing if this does not fix the issue.

If the JumpCloud Protect app is inactive or closed by the OS, push notifications may be delayed or may not arrive.

To fix this, follow these steps:

  1. Restart your iOS device to fix temporary glitches.
  2. After restarting, open the JumpCloud Protect app to run it in the foreground.
  3. While the app is open, try logging into a service that requires JumpCloud Protect MFA.
  4. Check if the push notification arrives in the app or as a system notification.
Your JumpCloud Protect enrollment may be corrupted, out of sync, or linked to an old device, blocking authentication.

Solution:

  1. Log in to your JumpCloud User Portal.
  2. Go to the Security tab.
  3. Under MFA Devices or Two-Factor Authentication, find your JumpCloud Protect enrollment.
  4. Click to Remove or Delete this instance.
  5. Follow prompts to re-add JumpCloud Protect as an MFA method by scanning a QR code with the app on your iOS device.
  6. After re-enrolling, test login to confirm notifications and authentication work.

For detailed setup guidance, see Users: JumpCloud Protect® to learn more.

Restoring or replacing your iOS device from backup does not transfer unique MFA security keys. The app may appear but its enrollment is invalid.

Treat the restored or new device as a fresh JumpCloud Protect setup. Follow the steps in the previous solution to remove and re-add JumpCloud Protect MFA. This deregisters the old instance and enrolls the current device.

Back to Top

Still Have Questions?

If you cannot find an answer to your question in our FAQ, you can always contact us.

Submit a Case