Microsoft Graph sample Node.js Express app

Node.js build License.

This sample demonstrates how to use the Microsoft Graph JavaScript SDK to access data in Office 365 from Node.js Express apps.

Prerequisites

To run the completed project in this folder, you need the following:

  • Node.js installed on your development machine. If you do not have Node.js, visit the previous link for download options.
  • Either a personal Microsoft account with a mailbox on Outlook.com, or a Microsoft work or school account.

If you don't have a Microsoft account, there are a couple of options to get a free account:

Register a web application with the Azure Active Directory admin center

  1. Open a browser and navigate to the Azure Active Directory admin center. Login using a personal account (aka: Microsoft Account) or Work or School Account.

  2. Select Azure Active Directory in the left-hand navigation, then select App registrations under Manage.

  3. Select New registration. On the Register an application page, set the values as follows.

    • Set Name to Node.js Graph Sample.
    • Set Supported account types to Accounts in any organizational directory and personal Microsoft accounts.
    • Under Redirect URI, set the first drop-down to Web and set the value to http://localhost:3000/auth/callback.
  4. Choose Register. On the Node.js Graph Sample page, copy the value of the Application (client) ID and save it, you will need it in the next step.

  5. Select Certificates & secrets under Manage. Select the New client secret button. Enter a value in Description and select one of the options for Expires and choose Add.

  6. Copy the client secret value before you leave this page. You will need it in the next step.

    Important

    This client secret is never shown again, so make sure you copy it now.

Configure the sample

  1. Rename the example.env file to .env.

  2. Edit the .env file and make the following changes.

    1. Replace YOUR_CLIENT_ID_HERE with the Application Id you got from the App Registration Portal.
    2. Replace YOUR_CLIENT_SECRET_HERE with the client secret you got from the App Registration Portal.
  3. In your command-line interface (CLI), navigate to the graph-sample directory and run the following command to install requirements.

    npm install
    

Run the sample

  1. Run the following command in your CLI to start the application.

    npm start
    
  2. Open a browser and browse to http://localhost:3000.

Code of conduct

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Disclaimer

THIS CODE IS PROVIDED AS IS WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESS OR IMPLIED, INCLUDING ANY IMPLIED WARRANTIES OF FITNESS FOR A PARTICULAR PURPOSE, MERCHANTABILITY, OR NON-INFRINGEMENT.