Introduction to Sandbox

Learn how to use Sandbox to test site and configuration changes in your development environment.

What is Sandbox?

Sandbox is an isolated environment you can use to test development versions of property configurations before deploying to the content delivery network (CDN). When coding new features and fixing bugs, you need a way to test configuration enhancements locally before promoting code changes to production. Testing at an early stage reduces the risk of finding issues later in the development cycle and increases your confidence in new builds. For a high-level overview of the benefits, refer to developer.akamai.com.

Who can benefit from Sandbox?

Sandbox is a valuable tool for:
  • CDN Admins who want to test property configuration changes in an isolated development environment without disrupting staging or production versions
  • Site reliability engineers who manage a CI/CD process and set up infrastructure for a development team
  • Developers who want to test how websites or APIs will perform when placed behind a CDN

How does Sandbox work?

This is what happens when you initiate a request from the browser in your development environment to a request hostname identified in your sandbox.
Sandbox request and response flow
Sandbox request and response flow
  1. The Sandbox Client forwards the request from the browser on your development machine to the Sandbox Network.
  2. The Sandbox Network authenticates the request and applies the sandbox configuration. When the sandbox has to go forward to an origin it routes the forward requests back to the Sandbox Client and resolves to the development origins defined in your Sandbox Client configuration file.
  3. When your dev origin responds to the request, the Sandbox Client routes the response back to your sandbox.
  4. Once the response from your dev origin is processed by the sandbox, it is returned back to your browser via the Sandbox Client.
Note: For security purposes, all HTTP requests that are sent to the Sandbox Client are upgraded to HTTPS within the Sandbox network. Therefore, CDN logic in your property configuration specific to HTTP is not applied.