You must enable javascript in order to use Slack. You can do this in your browser settings.

Configuring a sandbox

Now that you have your sandbox, you can use these instructions to get it configured and working.

Complete the org setup

  1. Click on the "Finish Setup" link in the email invitation.
  2. Enter your name and create a password to set up a the Primary Org Owner account.
  3. Give your organization a name.
    This name can be updated later if you decide you want to change it.
    Please note that you cannot change the URL of your sandbox org.
  4. Agree the general terms of service

Create a workspace

After the Primary Org Owner creates their account, they should create at least one workspace.

  1. Click on "Manage Workspaces" and you will be guided through the process of setting up a new workspace.
  2. You will need to provide a name and a subdomain for each workspace you create.

Set up authentication

Grid requires all users use SSO, which means admins must set up an IdP. If you already have an IdP, you are welcome to use that one on your sandbox.

If you don't have access to an IdP, we offer a Slack app, Simple IdP, that mocks an IdP to enable easy creation and management of user accounts. If you opt to use Simple IdP, all user accounts for your Grid sandbox must be created with the test IdP, and it will not be possible to create and use accounts outside of the test IdP app. Instructions for managing accounts may be found below.

Install Simple IdP

Go to​ https://slack-test-idp-for-sandboxes.herokuapp.com​ and install the app. Make sure you install the app on the org, and not a workspace!

Image showing the install step where the user can select the org for installing.

Copy over the needed info into your org SSO configuration

There are some pre-configured settings from Simple IdP you need to copy into your sandbox's SSO configurations.

Image showing the where to copy and paste SSO configuration settings.

Add users

You can add as many auto-generated users as you like through Simple IdP. For the most part, these auto-generated users are good for testing your app. However, if you need more than one real person signed into your org at a time, you’ll need to take a few extra steps because of how the Simple IdP works.

Each person that you want to be able to sign into the sandbox will first need to sign in as the primary owner, authenticate the Simple IdP app, sign out, and then sign in as themselves.

First, go to "Create a custom user" and provision an account for them in the Simple IdP. They will now show in the “Organization Members” list at http://[org-domain].enterprise.slack.com/manage/organization/members

Add that user to a workspace and have them follow these steps:

a. Go to the sign-in page for the workspace you added them to (http://[workspace-domain].slack.com/)
b. Click on the “Sign in with SAML” button
c. On the page that loads, click on the “Sign in with Slack” button
d. Sign in with the primary owner’s email and password.
e. Authorize the Simple IdP app
f. Enter their email address on the resulting page, and click the “Sign In” button.
g. That will take them to the Org control panel, where they can then launch the team.

After that, they'll remain logged in.

If you have questions as you start to use your sandbox, please let us know at feedback@slack.com, and the Developer Support team will get back to you as quickly as we can.

Data Retention

The Developer Instance of Enterprise Grid is a development sandbox with limitations around data retention and user account creation. These limitations exist because the sandbox isn’t intended for normal use. Slack will retain messages and files shared in the sandbox for only three days after they’re created.