Runscope API Monitoring    Learn More →

Posts filtered by tag: on-premises

How to Test Private & Local APIs with the Runscope On-Premises Agent

By Ashley Waxman on .

Different teams need to access and test APIs in different environments and stages of the development lifecycle. Being able to reuse these tests across every stage is critical for effective collaboration and efficiency, and running tests against APIs during development or APIs that live behind a firewall should be just as easy as testing APIs in the public cloud. The Runscope On-Premises Agent downloads easily to your local machine and executes requests in the location that makes the most sense for your infrastructure, all while keeping your test management in the cloud.

In the video below, Neil Mansilla, VP of Developer Relations at Runscope, provides an in-depth demo of the On-Prem Agent and how you can leverage API testing in your organization, no matter where your APIs live. This video covers:

  • How to install the Runscope On-Premises Agent and instantly begin testing APIs behind the firewall
  • Different use cases for testing APIs in a local environment, including testing private APIs and testing APIs in the beginning of the development process
  • Ways to incorporate API testing into your continuous integration (CI) processes

The On-Prem Agent is available during the Runscope free trial and on any paid plan. Give it a try today to begin testing private and local APIs in minutes.

Categories: testing, howto, product, webinar

Introducing the On-Premises Runscope Gateway Agent for Capturing and Debugging Private and Internal API Traffic

By Neil Mansilla on .

Back in September, we introduced Runscope Radar Agent, an on-premises testing agent that you download and install on a host within your network. The remote agent appears along side Runscope's global cloud-based testing locations, allowing tests to be executed against APIs behind your firewall, or even those running on the same localhost. Radar Agent has been a huge success, and we're excited to extend the hybrid on-premises deployment model to another key area of Runscope.

Today, we’re announcing the release of the Runscope Gateway Agent. The same gateway software that powers Runscope's cloud infrastructure for making and logging API calls can now be installed on your local network. Deploying the Runscope Gateway Agent within your infrastructure will help to:

  • Capture API request and response data made to private or internal APIs that reside behind a firewall
  • Troubleshoot and debug those API calls using the Runscope Traffic Inspector
  • Increase network performance by keeping API traffic within your infrastructure
  • Create Runscope URLs (on your domain name) for services running on localhost
  • Access APIs that require a fixed client IP address (IP whitelisting)

How it Works

The agent works by creating a locally-hosted instance of the Runscope Gateway with your own hostname and TLS certificate. Instead of using our cloud-based Runscope Gateways (hosted on *, requests will use the configured hostname for your agent instead.


Inspecting traffic with the Runscope Gateway Agent uses a hybrid on-premises approach. The agent runs on a host within your infrastructure, but traffic data is stored in the Runscope cloud to make searching and collaboration easier. Traffic collected with the agent is available in the Traffic Inspector along with all other traffic made in the same bucket.

All communication from the agent to the Runscope cloud is made securely over outbound requests to the Runscope API via HTTPS on port 443. See Firewall Considerations for more information.

How to Get Started

Use of the Runscope Gateway Agent requires a Trial, Starter, Team, Business or Enterprise subscription. The agent is available for Mac OS X, Windows (64/32-bit) and Linux (64/32-bit). For complete download and implementation instructions, see the Gateway Agent documentation.

Categories: announcements, product, testing, debugging

Runscope 25 Kearny St San Francisco, CA, 94108 United States

Introducing the Runscope Radar Agent for Monitoring and Testing of Private and Internal APIs and Backend Services

By John Sheehan on .

APIs live in a lot of different environments. One consistent story we've heard from customers is how many private or internal APIs they have that exist solely behind a firewall. We've been working hard to make it possible to use Runscope Radar API monitoring and testing in these situations:

  • Accessing APIs that exist solely behind a firewall without exposure to the public internet.
  • Running tests against a development version only running on localhost.
  • Monitoring APIs that require a known or fixed IP address (aka IP whitelisting).
  • Running your tests from a cloud hosting provider like Microsoft Azure, Digital Ocean, or SoftLayer or in a geographic region not currently covered by a Runscope Service Region.

In each of these cases you need the flexibility to determine which environment your API tests and monitors are run from, without losing the powerful test editor, team access, 3rd-party integrations, notifications and scripting capabilities you've come to expect from Runscope Radar.

Today we're announcing the general availability of the Runscope Radar On-premises Agent for all Team, Business and Enterprise customers. The Radar agent uses a hybrid on-premises approach keeping your test management in the cloud, but executing the requests in the location that makes the most sense for your infrastructure.

Hybrid On-premises API Monitoring and Testing

The agent is a single executable that can be downloaded and installed on a Linux, Windows or OS X host within your infrastructure. All agent communication with the Runscope API is made via standard HTTPS requests, minimizing the amount of firewall configuration needed to only allowing outbound requests on port 443.

Once installed and configured, the agent will show up as a location in the test editor along side the global cloud-based locations we support (screenshot condensed for brevity, we currently support eight global locations):

When a test run starts, the agent picks up the next request to be executed, makes the request and sends the response data back to the Runscope cloud to be processed. Anything the agent can "see" can now be tested and monitored just like the cloud-based tests!

Getting Started

Use of the agent previously required a Runscope Enterprise subscription but due to customer demand we've opened it up to customers on Team and Business plans as well. If you have a Free or Starter account, you can upgrade your subscription here.

The agent is also available to customers during the free 30-day trial, so if you haven't yet signed up for Runscope, get started now to try out the agent for yourself. If you're on the free plan, you can do a one-time restart of your trial here.

Once you're on a qualifying plan, head over to the agent docs page to download the agent for your operating system and follow the simple configuration instructions. If you need any assistance getting up and running, our support team is standing by ready to help.

Categories: announcements, product, testing, monitoring

Everything is going to be 200 OK®