ASIDE.IO New Instance

It's now possible to spin up your own instance of ASIDE in just a few steps. Follow the guide below to deploy a new version of the app and then configure the OAuth login.

Before you can setup a new instance of ASIDE you're going to need a couple things:

• A Heroku account
  • Sign up is free at: https://www.heroku.com
• A Salesforce org that you are a system administrator in
  • This org will be used to contain the Connected App that facilitates the OAuth login ASIDE uses. This should probably be a developer edition or production organization, but any org will work. It's not necessarily the same org that you plan on logging into ASIDE with. It can be, but it does not need to be.

Click the button below to begin the deployment process for ASIDE. It will open a new page which contains a form with a couple fields relating to the deployment.


Fill out the App name field. The App name will dictate what the URL is to access the application. For example, if the App name is "my-aside" then the URL is "https://my-aside.herokuapp.com". Click the Deploy app button.

From within Salesforce (and in the Lightning Experience UI), go to the setup menu. Type App Manager in the Quick Find search, and click the App Manager setup item. In the top right of the screen, you should see a button, New Connected App. Click the button to begin creating the Connected App.

From the New Connected App screen, populate the first three required fields (Connected App Name, API Name, Contact Email); their values are not important. Scroll down to the "API (Enable OAuth Settings)" section and check the Enable OAuth Settings checkbox. A handful of additional fields should now be displaying in this section.

Populate the required field Callback URL with the URL to the instance of ASIDE you just deployed with "/auth" added to the end. For example, if your new instance of ASIDE is available at "https://my-aside.herokuapp.com" then the Callback URL is "https://my-aside.herokuapp.com/auth".

The last field you have to fill out to finish configuring the Connected App is the Selected OAuth Scopes field. Choose a value of "Full access (full)" and click the save button to finish configuring the Connected App.

Now that you have created a Connected App it has two fields which are populated by Salesforce on it's detail page: Consumer Key and Consumer Secret. Their values will be used to finish configuring the application in the next step.

As a final step, you will need to populate the Config Vars within Heroku in order for ASIDE's OAuth based login to work. When logged into Heroku and viewing the application dashboard for the Heroku app you deployed earlier, click the Settings tab. Within the Config Vars section click Reveal Config Vars. Add the three new Config Vars detailed below.

• CID
  • This is the Consumer Key from the Connected App you created in Salesforce.
• SEC
  • This is the Consumer Secret from the Connected App you created in Salesforce.
• URL
  • This is the URL where the version of ASIDE is hosted at. The App name defined earlier will dictate what the URL is to access the application. For example, if the App name is "my-aside" then the URL is "https://my-aside.herokuapp.com".

After adding these three Config Vars you should be able to login to your new instance of ASIDE.

You have now deployed your own copy of ASIDE and configured OAuth to work. Your copy of ASIDE should be fully operational at this point. If you still can't login, wait 10 minutes. The Connected App can sometimes take a bit to be available for use. Thanks for using ASIDE!

Below are some questions that might be on your mind after reading through this guide: