Wednesday, October 7, 2015

How to deploy an Online Vorlon.js Server with Authentication

When our team of engineers and tech evangelists at Microsoft set out to create Vorlon.js — an open source, extensible, platform-agnostic tool for remotely debugging and testing your JavaScript—we wanted to keep it as simple as possible. It is our main concern, our mojo. That is why you only have to run npm install –g vorlon to get a Vorlon server and that you only have to add ONE line of code in your client to connect it to the Vorlon dashboard. This is why in the early version we did not implement any kind of authentication.

[author_more]

In this article I will explain to you why we added authentication and how to activate it.

If you never used Vorlon.js, please read this article to learn why we made Vorlon.js and how to use it.

Why we implemented authentication

Dashboard credentials

When we did our first demos in public we published our own Vorlon server instance in a Microsoft Azure website. At this time we didn’t have a way to specify a login and password for the dashboard.

This once led to a huge fail :)

Someone in the public copied the url displayed on my screen and accessed the dashboard from his computer. This messed up with the one displayed on my computer and totally screwed our demo. YAY! \o/

From this fail we made the decision to implement a simple authentication. This is obviously helping us for our demos, but it also helps you in the case you want to publish a publicly accessible version of the dashboard.

How to deploy Vorlon.js online easily?

Vorlon is really easy to install. All you need to do is have Node.js Package Manager (npm) on your box and run the correct command line. Everything is available to you from the npm platform and you can start your instance by typing vorlon in your command line.

From there you need to make your server accessible through the internet and open the correct TCP port, etc. This can be a bit complicated. If you do not want to manage that yourself, you can use a feature we added for you in our Github repository.

At the bottom of the repo, in the readme section, you will find a Deploy to Azure button.

readme file deploy on Azure

By clicking on this, we automatically get you through a 3-step process which will:

  • Create an Azure website on your Azure subscription*
  • Deploy the latest version of Vorlon on it

*if you do not have an Azure subscription, and want to get one (with free options), see the More Information section at the end of this article.

All of this is automated. You can see a quick video of this here:

[embed src="https://www.youtube.com/embed/vkAeBU-YdNo" width="600" height="400"]

How to activate authentication

PLEASE NOTE: For now, the authentication is only available in the development-0.0.16 branch on the GitHub repo. To get it, you need to deploy the code from this branch (manually somewhere you want or using Azure deploy). It will be available on the npm package in the 0.0.16 version we should release by the end of September.

We implemented authentication using passport.js. We chose to activate a simple mode which lets you specify a login and password. For now ,you can only specify one account. We may implement a more sophisticated version of this later (including Twitter and Facebook auth and multiple accounts management).

Continue reading %How to deploy an Online Vorlon.js Server with Authentication%


by Etienne Margraff via SitePoint

No comments:

Post a Comment