omercs / azuread-node-sample Goto Github PK

#Windows Azure Active Directory SDK for node.js

This Node.js package will give you with a quick and easy way to set up your first app that's integrated with Windows Azure Active Directory. The sample apps included in download are designed to run on any platform. It also provides libraries so you can build your own node.js applications using Passport.js.

Start with either the WS-Federation or SAML-P passport.js strategy, and then access the Windows Azure Active Directory Graph API. By the end of these walkthroughs, you should be able to build a running HTTP server with the following features:

• WebSSO using WS-Federation or SAML-P
• Graph API query capabiltiy using OpenAuth 2.0

Refer to our Wiki for detailed walkthroughs on how to use this package.

We've released all of the source code for this running example in GitHub under an Apache 2.0 license, so feel free to clone (or even better, fork!) and provide feedback on the forums.

Getting started with the sample is easy. It is configured to run out of the box with minimal setup.

To use this sample you will need a Windows Azure Active Directory Tenant. If you're not sure what a tenant is or how you would get one, read What is a Windows Azure AD tenant? or Sign up for Windows Azure as an organization. These docs should get you started on your way to using Windows Azure AD.

After you get your Windows Azure AD tenant, add this sample app to your tenant so it can access your tenant information. If you need help with this step, see: Learn how to register and integrate an application with Windows Azure AD and Adding, Updating, and Removing an App.

To successfully use this sample, you need a working installation of Node.js.

Install Node.js from http://nodejs.org.

Next, clone the sample repo and install the NPM.

From your shell or command line:

• $ git clone https://github.com/MSOpenTech/AzureAD-Node-Sample
• $ npm install

For using the WS-Federation protocol:

• $ cd login-wsfed
• $ node app.js

For using the SAML-P protocol:

• $ cd login-saml
• $ node app.js

The login credentials for the sample application are:

Username: [email protected]

Password: P@ssword1

The configuration values you'll need to edit are found in app.js and documented in the code. As much as possible they will match the fields in the Azure Management Portal as discussed in Adding, Updating, and Removing an App.

###The Technologies In This Demo

The website in this sample app demonstrates the following technologies from the Windows Azure AD from Microsoft, and includes open source modules for each scenario.

• Web Single Sign-In (WebSSO): passport-azure-ad
• Access to Windows Azure Active Directory through a RESTful Graph API: node-waad

With Windows Azure AD Web Single Sign-On (WebSSO) you will have the ability to seamlessly integrate your node.js application in to your existing identity platform while using the same credentials you use in the office and online.

For more information on how this module works, refer to the README in the provided module or read it online.

Windows Azure AD Graph API lets you build data-driven applications using a REST-based API. You can use this REST API to query your customer data, find relationships in the directory, and customize your apps based on customer data.

For more information on how this module works, see the README in the module or read it online.

Code hosted on GitHub under Apache 2.0 license

We would like to acknowledge the folks who own/contribute to the following projects for their support of Windows Azure Active Directory and their libraries that were used to build this sample. In places where we forked these libraries to add additional functionality, we ensured that the chain of forking remains intact so you can navigate back to the original package. Working with such great partners in the open source community clearly illustrates what open collaboration can accomplish. Thank you!

• Auth0's WS-Federation and SAML parsing library
• Auth0's Graph API Javascript library
• Auth0's SAML-P Library