Skip to main content

Check out Interactive Visual Stories to gain hands-on experience with the SSE product features. Click here.

Skyhigh Security

Troubleshoot Configuration Issues in the Skyhigh Mobile Client iOS App

If you encounter any issues or failures with the Skyhigh Mobile Client iOS app, collect the following troubleshooting information and logs before contacting Skyhigh Support

  • Skyhigh Mobile Client app version
  • iOS version
  • Error message or screenshot
  • Exported debug logs
  • Customer root CA certificate

You can use the following workaround when the Skyhigh Mobile Client iOS app fails or does not work as expected.

Challenge  Workaround
Installation 
  1. Free up device storage.
  2. Ensure the device is running ios 15 or ipadOS and above
  3. Reinstall the application.
Connection
  1. Verify the internet connection (Wi-Fi or mobile data).
  2. Switch networks (for example, from Wi-Fi to mobile data).
  3. Reconnect to the VPN.
Verify root CA trust
  1.  Manually enable trust of root CA for BYOD devices.
  2. Navigate to Settings > General > About > certificate trust settings and enable the customer tenant CA certificate.
Mobileconfig failure
  1. When creating a custom profile, iOS sometimes injects empty array formatting under the DNS keys that cause certificate validation failures
  2. Open the configuration file in a text editor and ensure the <key>DNS</key> dict matches Skyhigh specs.

Unable to Proceed with Connection

  1. Make sure you uploaded the correct user identity(.p12) file in BYOD devices.
  2. For MDM devices, make sure vpn profile pushed from MDM in device settings -> VPN and switch on the vpn 
  3. Kill and Relaunch the app
Unable to Export Log File
  1. Ensure the app has storage permissions to save files to your device.
  2. Verify that the Debug Log switch is enabled in the Settings screen of the app.
Browser — Unable to Load Private Access (PA) App
  1. Verify if the VPN is connected. Look for the key icon in the status bar at the top right. If it is missing, reconnect the VPN.
  2. Confirm there is an active internet connection.
  3. If the issue persists, capture a screenshot of the browser and collect relevant logs and information, and share with Skyhigh Support.
Browser — Common Name Mismatch Issue Certificate Error 
  1. Verify that both the Root CA certificate and the Sectigo certificate are installed on the device.
  • Download the Root CA certificate: Go to Policy > Web Policy > Feature Configuration > HTTPS Connection > Customer CA, to export and download the certificate.

  • Download the Sectigo certificate.
  1. Share the Certificate Viewer details from the browser. Click the icon on the left side of the browser’s URL bar, open the Certificate Viewer, and share all the details as a screenshot.
Verifying Server Authentication Failed Error
  1. If you encounter the specific error message Verifying server authentication failed, it is recommended to reinstall the intermediate certificate
  2. Download the Sectigo intermediate certificate.
  3. Install the certificate on the affected device and check if the connection issue is resolved.
Always on VPN Not Working 
  1. Ensure the device is supervised as always ON works only in supervised devices.
  2. Ensure the MDM always on vpn configuration is added in Intune, and check the device is added to the group having the configuration
  3. Check the success status of the configuration in Intune If error, then reconfigure in MDM with the new configuration.
Cannot see the factory rest option even after enabling in mdm
  1. Go to Configuration under Apps in MDM and check the properties.
  2. Remove the existing value and add it again with the true boolean.
  3. Sync the device and verify.
  4. If the issue still persists, share the log file.
User selected the wrong .p12 file
  • If the app connects and loads the home page, open Settings and select Change Profile.

  • If the app does not connect or load the home page, clear the app data from the phone’s settings.

 

Collect Logs
  1. Open the Settings screen in the Skyhigh Mobile Client app.
  2. Ensure the Debug Log toggle is turned on in the Settings screen.
  3. To export logs, tap Export Log from the menu on the Settings screen as needed.
Log Snippet

SUCCESS : Code - 200

  • API call successful.

HTTP_UNAUTHORIZED : Code - 401

  • Log in to get authorized.

LoginPageSaas : Code - 403

  • The user is not trusted.
  • Was this article helpful?