Configuration

In this article we'll discuss about how to configure Fiddler Everywhere in your system.

By default, the Fiddler Everywhere client intercepts insecure traffic (HTTP) only and needs an account with administrative rights to capture secure traffic (HTTPS). The Fiddler Everywhere client acts as a man-in-the-middle (against the HTTPS traffic). To enable capturing and decrypting HTTPS traffic, you will need to explicitly install a root trust certificate via the HTTPS sub-menu in Settings.

Configure on macOS

  1. Start Fiddler Everywhere on the device that will capture the traffic.

  2. Go to Settings > HTTPS

  3. Click the Trust Root Certificate button.

  4. A keychain user & password box appears. Enter your machine administrative credentials.

    Enter Keychain credentials to trust the root certificate

  5. The Capture HTTPS traffic checkbox is now active. Check the box to enable capturing HTTPS traffic.

  6. Click the Save button to save the changes.

    default https settings

Configure on Windows

  1. Start Fiddler Everywhere on the device that will capture the traffic.

  2. Go to Settings > HTTPS

  3. Click the Trust Root Certificate button.

  4. Trust certificate popup appears to confirm and add the certificate.

    Enter Keychain credentials to trust the root certificate

  5. The Capture HTTPS traffic checkbox is now active. Check the box to enable capturing HTTPS traffic.

  6. Click the Save button to save the changes.

    default https settings

Configure on Linux

Some Linux distributions are using different security features and different ways of adding a root certificate. For such cases, the Fiddler Everywhere provides means to export the root trust certificate so that it could be manually imported in your Linux OS. Use the Export Root Certificate to Desktop and Trust Certificate option as follows:

  1. Start Fiddler Everywhere on the device that will capture the traffic.

  2. Go to Settings > HTTPS

  3. Expand the Advanced Settings sub-menu

  4. Click the Export Root Certificate to Desktop button.

    Export root certificate

  5. Import and trust the exported certificate. To be able to install the FE certificate, you need to follow some additional steps on Linux:

    • Create a directory and copy the certificate (exported in the previous steps). The last command will start the tool to upgrade the certificates.

      $ sudo mkdir /usr/share/ca-certificates/extra
      $ sudo cp ~/Desktop/FiddlerRootCertificate.crt /usr/share/ca-certificates/extra
      $ sudo dpkg-reconfigure ca-certificates
      
    • From the prompt select Yes to install new certificates

      Add new certificate

    • Choose the FiddlerRootCertificate.crt and press OK

      Add Fiddler certificate

    • The certificates are being updated

      Add Fiddler certificate

  6. The Capture HTTPS traffic checkbox is now active. Check the box to enable capturing HTTPS traffic.

    Enable capturing HTTPS traffic

  7. Click the Save button to save the changes.

    Some Linux distributions like Ubuntu will use localized paths (for example, the Desktop folder is renamed with the related word used in the locale language). That might cause for step 3 to fail due to a missing folder named Desktop with an error message of type Could not find a part of the path .... Until an out-of-the-box solution is implemented, you could easily workaround this issue by creating a folder called Desktop at your root directory (mkdir ~/Desktop) and then export the certificate to the newly-created directory. Once the certificate is installed, you could safely remove the directory.

For more information about Fiddler Everywhere settings, visit Settings page.

Additional Resources

Once the client is configured, you can start using its features. Get to know how to:

In this article