This Node.js app will give you with a quick and easy way to set up a Web application in node.js with Express usind OpenID Connect. The sample server included in the download are designed to run on any platform.
We've released all of the source code for this example in GitHub under an MIT 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 an Azure AD tenant? or Sign up for Azure as an organization. These docs should get you started on your way to using Windows Azure AD.
To successfully use this sample, you need a working installation of Node.js.
Next, clone the sample repo and install the NPM.
From your shell or command line:
$ git clone [email protected]:AzureADQuickStarts/WebApp-OpenIDConnect-NodeJS.git
$ npm install
- Provide the parameters in
exports.creds
in config.js as instructed. The key three parameters are defined as environment variables in a file namedhidden.env
.
CLIENT_ID=xyz
CLIENT_SECRET=xyz
REDIRECT_URL=http://azure-ad-authn-example.dev.services.ec2.dmtio.net/auth/openid/return
-
Update
exports.destroySessionUrl
in config.js, if you want to use a differentpost_logout_redirect_uri
. -
Set
exports.useMongoDBSessionStore
in config.js to false, if you want to use the default session store forexpress-session
. Note that the default session store is not suitable for production, you must use mongoDB or other compatible session stores. -
Update
exports.databaseUri
, if you want to use mongoDB session store and a different database uri. -
Update
exports.mongoDBSessionMaxAge
. Here you can specify how long you want to keep a session in mongoDB. The unit is second(s).
-
Start mongoDB service. If you are using mongoDB session store in this app, you have to install mongoDB and start the service first. If you are using the default session store, you can skip this step.
-
Run the app. Use the following command in terminal.
$ node app.js
Is the server output hard to understand?: We use bunyan
for logging in this sample. The console won't make much sense to you unless you also install bunyan and run the server like above but pipe it through the bunyan binary:
$ npm install -g bunyan
$ node app.js | bunyan
You will have a server successfully running on http://localhost:3000
.
To run in Harbor:
Provision shipment infrastructure
terraform apply
Build the image and push it to a registry
docker-compose build
docker-compose push
Deploy the image and environment variables to harbor
harbor-compose up
We would like to acknowledge the folks who own/contribute to the following projects for their support of 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!
Code hosted on GitHub under MIT license