Generate a HAR Capture on an iOS Device for Okta Troubleshooting
Last Updated:
Overview
Generating an HTTP Archive (HAR) file on an iOS device captures web requests to identify potential issues related to performance and page rendering. Administrators can generate a HAR file by enabling the Web Inspector on the iOS device and connecting it to a Mac running Safari.
Applies To
- Okta Identity Engine (OIE)
- Okta Classic Engine
- Apple iOS
- Apple iPadOS
- Apple macOS
Solution
What steps are required to generate a HAR file on an iOS device?
Enable the Web Inspector on the iOS device, activate the Develop menu in Safari on a Mac, and connect the device to capture and export the HTTP traffic.
- On an iOS 18 or newer device, navigate to Settings > Apps > Safari > Advanced and enable Web Inspector. For iOS 17 or older, navigate to Settings > Safari > Advanced and enable Web Inspector.
- Open Safari on the Mac.
- Navigate to Safari > Settings in the top menu bar and select Advanced.
- Select the Show features for web developers checkbox.
- Connect the iOS device to the Mac using a Universal Serial Bus (USB) cable and trust the computer if the device prompts for confirmation.
- Open Safari on the iOS device and reproduce the issue.
- On the Mac, open Safari, select Develop in the menu bar, select the connected iOS device, and select the active web page session to open the Web Inspector window.
- Navigate to the Network tab in the Web Inspector window.
- Select the Export button at the top-right of the Network tab to export the HAR file.
- Upload the HAR file to the Support Portal to automatically sanitize the HTTP traces.
NOTE: Other alternatives to capture HTTP and Secure Sockets Layer (SSL) traffic include using a web debugging proxy tool (Charles Proxy or Fiddler Everywhere) for advanced troubleshooting scenarios. Sanitize the files before sending any HTTP traces from other tools to Okta for analysis.
