Capturing a Fiddler trace helps Okta Customer Support troubleshoot Hypertext Transfer Protocol Secure (HTTPS) traffic issues. Install and configure Fiddler on a Windows or macOS workstation to capture and export the browser session traffic for analysis.
- Okta Classic Engine
- Okta Identity Engine (OIE)
- Troubleshooting HTTPS traffic
- Third-Party Apps (Fiddler)
What are the steps to capture a Fiddler trace on Windows?
Download, install, and configure Fiddler on a Windows workstation to capture and export the browser session traffic by following these steps.
- Download Fiddler.
- Install Fiddler on a Windows workstation or server where the browser session capture occurs.
- Launch Fiddler.
- From the Fiddler menu, select TOOLS > OPTIONS. For Fiddler Everywhere, navigate to Settings > HTTPS > Capture HTTPS Traffic.
- Change to the HTTPS tab.
- Enable the following settings:
- Capture HTTPS CONNECTs.
- Decrypt HTTPS traffic.
- Select .....from all processes.
The Fiddler Options dialog box displays the HTTPS tab with the Capture HTTPS CONNECTs and Decrypt HTTPS traffic options enabled.
- Accept the prompts to trust and install the Fiddler Root Certificate. This step decrypts HTTPS traffic.
- In the Fiddler traffic pane, select one of the current traces and press Ctrl+X to clear the list.
- Reproduce the scenario requested by Okta Customer Support.
- Once the sequence reproduction completes, export the file as HTTP Archive v1.1.
NOTE: Exporting the Fiddler trace as HTTPArchive v1.1 or v1.2 allows the file to undergo redaction upon upload to a support case. Upload the HAR file on the Support Portal to sanitize the HTTP traces automatically. Refer to How to Sanitize a HTTP Trace File Automatically. Do not share Fiddler SAZ files with Support.
What are the steps to capture a Fiddler trace on macOS?
Download, install, and configure Fiddler Everywhere on a macOS workstation to capture and export the browser session traffic by following these steps.
- Download Fiddler Everywhere and follow the steps detailed in First Steps with Fiddler Everywhere on macOS.
- Select Fiddler Everywhere > Settings.
The Fiddler Everywhere interface displays the Settings option in the dropdown menu.
- In the HTTPS section, select Trust CA Certificate.
The Settings menu displays the HTTPS section with the Trust CA Certificate button highlighted.
- Follow the macOS screen prompts. Trusting the certificate enables the Capture HTTPS traffic option.
The Settings menu displays the Capture HTTPS traffic option enabled.
- Close the window.
- Select the Fiddler icon and choose Start Capturing.
The Fiddler interface displays the Start Capturing option.
- A window displays the enabled System proxy. Select Ok.
A prompt displays indicating the enabled system proxy.
- Reproduce the scenario requested by Okta Customer Support.
- Select Save. Save the file as Fiddler Archive (SAZ) or as HTTPArchive v1.1.
The Save dialog box displays options to save the trace as a Fiddler Archive or HTTPArchive.
