Developer sandboxes provide Box administrators with a sanctioned and traceable way to manage sandbox environments where developers can build and test applications on Box.
What is a developer sandbox?
Sandboxes are distinct environments associated with the parent enterprise. They are not clones, copies, or representations of a Box production environment. Each sandbox is a new, blank environment based on your existing plan that's ready for custom development and testing applications without any risk of it affecting the main production instance.
Note
Sandboxes are included as part of a Box business plan or above. Your sandbox environment reflects your existing plan that does not include any add-on products such as Shield or Zones. You can have up to ten developer sandboxes in your enterprise. To create more, contact your Customer Support Manager.
Enterprise Admin vs Sandbox Admin
- The enterprise admin is responsible for managing your company's main Box instance. The enterprise admin creates a developer sandbox within the main enterprise for custom app development and/or app testing purposes.
- The sandbox's primary admin is the primary admin for the developer sandbox. Sandbox primary admins manage the sandbox and can add additional developers to the sandbox environment.
Creating a developer sandbox
If you're an enterprise admin or co-admin, use the Admin Console's Sandboxes page to create and manage your enterprise's developer sandbox environments.
To create a developer sandbox:
- In the Admin Console's left sidebar, click Platform.
- In the top-right corner, click Create Sandbox. .If you have no sandboxes, click Get Started on an interstitial informational page first.
- In the Create New Sandbox window, provide the following:
- Sandbox Name: a unique name for the sandbox.
- Primary Admin Name: the name of the primary admin who acts as the sandbox's admin.
-
Primary Admin Email: the primary admin's email address. Each sandbox you create must have a unique Primary Admin Email. The Primary Admin Email cannot belong to multiple sandboxes or to an existing Box managed user. This would require your organization to create a new email address to use for the sandbox. If this is not possible, a personal email can be used, though Box doesn't recommend this.
- Click Create Sandbox. You will be prompted to accept terms and conditions to proceed. By accepting, you are stating that you are an authorized representative of your company, and that you agree to enter into the Sandbox Account Service Agreement on behalf of your company. Accepting the legal terms is required once only, so the message won’t appear when managing an existing sandbox.
- After creating the developer sandbox, Box sends a log-in email to the developer who you assigned as the sandbox's primary admin, and the sandbox appears in the sandbox management page. The email notification provides the user ID and prompts the sandbox's primary admin to create a new password to set up the sandbox account
After the sandbox's primary admin sets up the password, they can use the new sandbox credentials to log in by clicking Developer Console in the email, or by going to developer.box.com.
The sandbox's primary admin can then create individual sandbox user accounts, giving developers access to a new Box environment that reflects the same plan as their parent Box enterprise.
Sandbox developer console
Developers access the sandbox through the sandbox's developer console. The sandbox badge in the bottom-left corner of the developer console displays the name of the sandbox environment, letting developers know they're in a sandbox.
Deleting a developer sandbox
As an enterprise admin or co-admin, you can also delete a sandbox. Once the sandbox is deleted:
- it automatically becomes inactive and is archived,
- developers can no longer log in to the developer sandbox, and
- all data from the developer sandbox will no longer be accessible.
To delete a developer sandbox:
- In the Admin Console's left sidebar, click Platform. Box displays the Sandboxes window.
- In the Sandboxes window, hover on the sandbox's name and click "...".
- Select Delete Sandbox.