How to Configure the Agent
How to configure Stoobly to intercept HTTP(s) traffic
Before we can record or mock requests, they must first be intercepted by the agent. To do this, we can either setup the agent as a forward or reverse proxy.
Configuration Setups
We support two different setups for intercepting requests:
Reverse Proxy
Use a reverse proxy when you have one upstream API service to intercept. This is the simplest setup as it routes all traffic for a specific domain through Stoobly.
Best for:
Single API service
Simple, straightforward routing
When you want all requests to a domain intercepted
Forward Proxy with Firewall Rules
Use a forward proxy with firewall rules when you need to intercept requests to multiple different services or want fine-grained control over which requests are intercepted.
Best for:
Multiple upstream API services
Selective request interception
Applications that make requests to various domains
When you need to filter or exclude specific requests
With firewall rules, you can:
Include or exclude specific URL patterns
Filter by HTTP method (GET, POST, etc.)
Apply rules to specific modes (record, mock, replay)
Control which requests get intercepted
Verifying Setup
To verify successful setup of the agent, send a requests and check the logs to see if it was intercepted. For example, send a request with curl https://docs.stoobly.com, then in the agent logs you should see:
Last updated
Was this helpful?