Stoobly Docs
  • Introduction
  • Use Cases
    • Generate Mock APIs
      • Empower Development
      • Scale API Testing
    • Enable E2E Testing
  • FAQ
    • Recording
    • Mocking
    • Terminology
  • Getting Started
    • Installing the Agent
      • Installation with pipx
      • Installation with Docker
  • Core Concepts
    • Agent
      • Intercept Modes
        • Mocking
        • Recording
      • Lifecycle Hooks
      • Proxy Settings
        • Data Rules
        • Firewall Rules
        • Rewrite Rules
        • Match Rules
    • Context
    • Mock API
      • Request
        • Response
        • Replay History
      • Scenarios
      • Snapshots
      • Fixtures
      • Public Folder
    • Scaffold
      • Service
      • Validation
      • Workflow
  • Guides
    • How to Run the Agent
      • Run with CLI
      • Run with Docker
    • How to Configure the Agent
      • Forward Proxy
        • Enable HTTPS Traffic
      • Reverse Proxy
    • How to Record Requests
      • Recording from the UI
      • Recording from the CLI
      • How to Create Contexts
      • How to Create Scenarios
        • Creating from the UI
        • Creating from the CLI
      • How to Create Requests
      • How to Customize Recordings
        • Customizing with Lifecycle Hooks
    • How to Update Requests
      • Editing from the UI
      • Editing with Snapshots
      • How to Update Scenarios
        • Updating from the UI
        • Updating from the CLI
      • Updating with Replay
        • Replaying from the UI
        • Replaying from the CLI
        • How to Customize Replays
          • Customizing with Lifecycle Hooks
      • Updating with Open API
    • How to Mock APIs
      • How to Enable Mocking
        • Enabling from the UI
        • Enabling from the CLI
      • How to Snapshot Requests
        • Deleting Snapshots
        • Sharing Snapshots
      • How to Use Fixtures
      • How to Customize Mocking
        • Customizing with Lifecycle Hooks
        • Customizing with Request Headers
      • Troubleshooting
    • How to Replay Requests
      • Replay with the UI
      • Replay with the CLI
    • How to Integrate E2E Testing
      • How to Scaffold an App
        • Scaffolding a Service
        • Customizing a Workflow
          • Customizing Container Services
          • Customizing Lifecycle Hooks
          • Customizing Init Scripts
          • Customizing Configure Scripts
          • Customizing Makefile
        • Troubleshooting
      • How to Run a Workflow
        • Running with CLI command
        • Running with Make
        • Troubleshooting
          • Validating
      • How to Stop a Workflow
        • Stopping with CLI command
        • Stopping with Make
      • How to Update a Scaffold
        • Deleting a Service
      • FAQ
  • Developer Guide
    • Installation from Source
    • Submitting Change Requests
    • Releases
  • Experimental
    • Experimental Features
      • Aliases
      • Endpoints
      • API Testing
        • Getting Started
        • Configuration
          • Assign
          • Lifecycle Hooks
          • Trace
      • Optional Components
Powered by GitBook
On this page
  • System Wide Configuration
  • Automated Setup
  • Manual Setup
  • Browser Configuration

Was this helpful?

  1. Guides
  2. How to Configure the Agent
  3. Forward Proxy

Enable HTTPS Traffic

Configure the forward proxy to intercept HTTPS traffic

PreviousForward ProxyNextReverse Proxy

Last updated 28 days ago

Was this helpful?

The following is only required if both:

  • The proxy is configured as a forward proxy

  • Recording HTTPS traffic is desired

To enable recording HTTPS traffic, we first must trust Stoobly agent to be a certificate authority. To do so, you will need to add the certificate generated by as a trusted certificate authority. uses mitmproxy internally to handle the heavy lifting of proxying requests.

System Wide Configuration

Some applications (e.g. browsers) will require additional specific configuration. Please refer to their documentation.

Automated Setup

In the terminal run the following command:

stoobly-agent ca-cert install

This installs ~/.stoobly/ca_certs/mitmproxy-ca-cert.cer under System in Keychain Access.

In the terminal run the following command:

stoobly-agent ca-cert install

This will run Linux distribution specific commands to install the CA cert. We currently support the following distributions:

  • Debian based ones, such as Ubuntu

  • RHEL based ones, such as CentOS

Manual Setup

1. Open Keychain Access and click the + button in the top left corner 2. Select ~/.stoobly/ca_certs/mitmproxy-ca-cert.cer 3. Double-click the newly added row mitmproxy 4. Click the dropdown next to When using this certificate, and select Always Trust

Please refer to the following mitmproxy docs for your specific Linux distribution:

Browser Configuration

mitmproxy
Our agent
https://docs.mitmproxy.org/stable/concepts-certificates/
https://docs.vmware.com/en/VMware-Adapter-for-SAP-Landscape-Management/2.1.0/Installation-and-Administration-Guide-for-VLA-Administrators/GUID-D60F08AD-6E54-4959-A272-458D08B8B038.html
https://docs.vmware.com/en/VMware-Adapter-for-SAP-Landscape-Management/2.1.0/Installation-and-Administration-Guide-for-VLA-Administrators/GUID-0CED691F-79D3-43A4-B90D-CD97650C13A0.html