Skip to main content

Running tests over mabl Link

Molly Exten
  • Updated

With mabl Link, you can securely run tests from the mabl cloud against applications in private networks. Once the mabl Link Agent is set up to create a secure tunnel to the mabl cloud, you can configure your mabl workspace for testing over mabl Link.

This article explains how to…

Routing test traffic through mabl Link

Before configuring tests to run over mabl Link, make sure the Link Agent has a "Connected" status on the networking page in the app: Settings > Networking. If you do not see an active Link Agent, refer to the articles on Link Agent setup and troubleshooting mabl Link issues for more details.

mabl Link is configured at the environment level. Follow these steps to add the Link Agent to an environment:

  1. Go to the applications page in the mabl app: Configuration > Applications
  2. Open settings for the environment you want to configure:
    • To add Link to an existing environment, hover your mouse over the environment name and click on the edit pencil that appears.
    • To add Link to a new environment, click on the + New environment button.
  3. Check the "Use Link Agent" box.
  4. Select the Link Agent from the dropdown menu.
  5. Save your settings.

Configuring mabl Link for an environment

Routing test traffic through mabl Link

When you associate a Link Agent with an environment, all plans associated with that environment will have their traffic routed through the selected Link Agent. If only some of your testing environments are private, create a dedicated environment in mabl for the tests that require access through mabl Link. 

Make sure that the tests and plans that access the private network are configured to use the Link-enabled environment in mabl. When tests run in the mabl cloud, the URLs are resolved by the Link Agent host in your network.

At the start of test output, tests running over mabl Link show a log line similar to this:

Found active mabl Link with name ""

If there are issues with your Link-enabled test and plan runs, see the article on troubleshooting mabl Link for tips on how to isolate the issue.

Disabling mabl Link for a test environment

To stop routing test traffic through mabl Link, disable the Link Agent at the environment level:

  1. Go to the applications page in the mabl app: Configuration > Applications
  2. Hover your mouse over the environment you want to update.
  3. Click on the edit pencil that appears.
  4. Uncheck the "Use Link Agent" box.
  5. Save your settings.

Tests and plans that run in this environment will no longer connect to the application under test through mabl Link. Addresses will be resolved in the mabl cloud.

Overriding the Link Agent name in a deployment event

In some scenarios, such as when a developer needs to test against a local development environment, it may be necessary to temporarily override the Link Agent used for some tests and plans. With mabl deployment events, you can dynamically override the configured Link Agent for an environment by passing a new Link Agent name.

To override the Link Agent used in a deployment event, add the following parameter to the JSON request body:

"plan_overrides":{"link_agent_label":"your-agent-name-here"}

Related articles