Developing with Heroku and Microsoft Azure PAAS Services

This recipe discusses how to use the free versions of the popular Heroku and Microsoft Azure PAAS (Platform As A Service) products to run DocuSign recipe examples.


The Heroku PAAS product includes support for the “Heroku button.” It enables quick deployment of a GitHub repository to the free tier of Heroku.

Heroku supports Java, Node.JS, PHP, Python and other languages.

Getting ready

Sign up for a free Heroku account.

How to do it...

Step 1: Click the recipe’s Deploy to Heroku link. Your browser will switch to the Heroku site. Register or Login to Heroku if prompted to do so.

Step 2: Fill in the recipe’s configuration form on the Heroku dashboard with your DocuSign Developer Sandbox credentials.

Step 3: Scroll down the Heroku dashboard and press the Deploy for Free button.

Step 4: Scroll down further and press the View button when it is enabled. The recipe example will be opened in a new browser tab.

Note: If the browser shows a generic Heroku page instead of the recipe, refresh the browser to see the recipe example.

Microsoft Azure App Service

The Microsoft Azure App Service is a PAAS product that includes an on-line development environment, “Monaco.” After importing a project into Monaco, you can update the project files on-line, then restart your project to see the results.

The Azure App Service supports C#, Java, Node.JS, PHP, Python, and other languages.

Getting ready

The MS Azure App Service free usage tier does not require a sign up, you can authenticate via a Google or Facebook account. You can also sign up for a free Azure account which provides some additional features.

How to do it...

Step 1: Open the Try App Service site.

Step 2: Select app type: Web App, Click Next

Step 3: Select a template: Change the language to match the recipe’s example language. For PHP examples:

  • Change Language: PHP
  • Choose PHP Empty Site
Click: Create

You may get a popup to sign in. You can use an Google account if you wish. No credit card is needed.

Step 4: Next, you'll see a web page with the message "Your web app has been created!"

Click the page's left most icon to Edit with Visual Studio Online "Monaco"

Install, configure, and run the example

Now that your free Azure App Service is running, delete the existing files, import the example from GitHub, configure and run it.

Step 5: In the Online Editor, Click the Files Explorer icon. Delete all existing files (favicon.ico, index.php, etc) by using the right mouse button or the Delete key on your keyboard.

Step 6: Clone the example's Git repo. Refer to the recipe's page for the url address of the repo. Click Github controls icon. Enter the url. Click Clone from a git URL

Step 7: Add your DocuSign credentials. This step is specific to each recipe since different recipes can use different techniques for storing the credentials in an example.

Step 8: Try out the example! Go to the example's website by using the "Show website" icon.


A new tab is opened in your browser. You should see the welcome screen for the recipe example.

There’s more

Information Security: For the best security, it is recommended that credentials used during development should always be changed before production. For example, switch to a new integration key when your app is certified for use with the production platform.

Modern PAAS services enable developers to quickly run and test applications on the public internet for free or at a low cost. The same services can then be used to quickly place an app into production on modern platforms, accessible from anywhere.