Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.



A Node-RED node to perform an OAuth2 Authentication with Microsoft Graph.

Quick Start

To use the Microsoft Graph Connect Sample for Node.js, you need either a Microsoft account or a work or school account

npm install node-red-contrib-viseo-ms-graph

Register the Application

  1. Sign into the App Registration Portal using either your personal or work or school account.
  2. Choose Add an app.
  3. Enter a name for the app, and choose Create application. The registration page displays, listing the properties of your app.
  4. Copy the Application Id. This is the unique identifier for your app.
  5. Under Application Secrets, choose Generate New Password. Copy the password from the New password generated dialog. You'll use the application ID and password (secret) to configure the sample app in the next section.
  6. Under Platforms, choose Add Platform.
  7. Choose Web. (You already should have Native Platform, otherwise add it too)
  8. Enter https://server.url:1880/callback-auth as the Redirect URI.
  9. Choose Save.

Build the Node-RED Flow

This sample demonstrate an authentication throught a ChatBot.



The first row build an URL to https://login.microsoftonline.com/common with credentials then send a ChatBot Sign-In Card

Callback URL

The second row

  • handle HTTP GET Request to /callback-auth and answer a "Thank You" message.
  • the callback code is resolved into a refreshToken and accessToken.
  • the callback state is resolved to fetch the ChatBot user, save the credential and send back a message.

API Testing

The third row try to retrieve the microsoft profile with an HTTP request to https://graph.microsoft.com/v1.0/me

Getting Help

For further help, or general discussion, please use the github issue tracker and in order to be labeled with question tag please specify :

  • Your message is a question / discussion
  • The module or node name


Before raising a pull-request, please read our contributing guide.

This project adheres to the Contributor Covenant 1.4. By participating, you are expected to uphold this code. Please report unacceptable behavior to any of the project's core team.


This project is a creation of Jean-Philippe Encausse for the SARAH home automation project.

Copyright and license

Copyright 2012-2017 SARAH under the Apache 2.0 license. Copyright 2016-2017 VISEO under the Apache 2.0 license.