Skip to content

Commit f23bcbd

Browse files
authored
Merge pull request #27 from nicolesigei/master
Updates to README file and Extend and Lodash dependancies
2 parents cefeb56 + db7264f commit f23bcbd

File tree

11 files changed

+1080
-12
lines changed

11 files changed

+1080
-12
lines changed

.vs/ProjectSettings.json

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,3 @@
1+
{
2+
"CurrentProjectSetting": null
3+
}

.vs/VSWorkspaceState.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,7 @@
1+
{
2+
"ExpandedNodes": [
3+
""
4+
],
5+
"SelectedNode": "\\constants.js",
6+
"PreviewInSolutionExplorer": false
7+
}

.vs/nodejs-webhooks-rest-sample/config/applicationhost.config

Lines changed: 1027 additions & 0 deletions
Large diffs are not rendered by default.

.vs/slnx.sqlite

15.2 MB
Binary file not shown.

README.md

Lines changed: 41 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,29 @@
22

33
[![Build Status](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample.svg)](https://travis-ci.org/microsoftgraph/nodejs-webhooks-rest-sample)
44

5+
## Table Of Contents. ##
6+
* [Introduction](#introduction)
7+
8+
* [Screenshots](#screenshots)
9+
10+
* [Prerequisites](#prerequisites)
11+
12+
* [Register the app](#Register-the-app)
13+
14+
* [Configure a tunnel for your localhost](#Configure-a-tunnel-for-your-localhost)
15+
16+
* [Configure and run the web app](#Configure-and-run-the-web-app)
17+
18+
* [Contributing](#contributing)
19+
20+
* [Questions and Comments](#Questions-and-Comments)
21+
22+
* [Additional resources](#Additional-resources)
23+
24+
25+
## Introduction
26+
<a name="introduction"></a>
27+
528
This Node.js sample shows how to start getting notifications from Microsoft Graph. The following are common tasks that a web application performs with Microsoft Graph webhooks.
629

730
- Sign-in your users with their work or school account to get an access token.
@@ -11,6 +34,7 @@ This Node.js sample shows how to start getting notifications from Microsoft Grap
1134
- Request for more information in Microsoft Office 365 using data in the notification.
1235

1336
## Screenshots
37+
<a name="screenshots"></a>
1438

1539
1. First you need sign in.
1640

@@ -25,43 +49,49 @@ This Node.js sample shows how to start getting notifications from Microsoft Grap
2549
![email](https://user-images.githubusercontent.com/3375461/31968754-0ce4dafc-b8c7-11e7-8458-8152d598228e.png)
2650

2751
## Prerequisites
52+
<a name="prerequisites"></a>
2853

2954
To use the Webhook sample, you need the following:
3055

3156
- [Node.js](https://nodejs.org/) version 4 or 5.
3257
- A [work or school account](http://dev.office.com/devprogram).
3358

3459
## Register the app
60+
<a name="Register-the-app"></a>
3561

3662
This app uses the Azure AD endpoint, so you'll register it in the [Azure Portal](https://ms.portal.azure.com/#blade/Microsoft_AAD_IAM/ApplicationsListBlade).
3763

38-
1. Sign in to the portal using your work or school account.
64+
1. Sign in to the Azure portal using either a work or school account or a personal Microsoft account.
65+
1. If your account gives you access to more than one tenant, select your account in the top right corner, and set your portal session to the desired Azure AD tenant (using Switch Directory).
66+
1. In the left-hand navigation pane, select the **Azure Active Directory service** , and then select **App registrations.**
67+
![](readme-images/registrations.png)
3968

4069
1. Choose **New application registration**.
4170

4271
1. Enter a friendly name for the application.
4372
1. Choose 'Web app/API' as the **Application Type**.
4473
1. Enter `http://localhost:3000/callback` for the **Sign-on URL**.
74+
1. In the Supported account types section, select Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox, Outlook.com).
4575
1. Click **Create**.
4676

4777
1. Choose your new application from the list of registered applications.
48-
49-
1. Copy and store the Application ID. This value is shown in the **Essentials** pane or in **Settings** > **Properties**.
50-
51-
1. To enable multi-tenanted support for the app, choose **Settings** > **Properties** and set **Multi-tenanted** to **Yes**.
52-
78+
On the app **Overview** page, find the **Application (client) ID** value and record it for later. You'll need it to configure the Visual Studio configuration file for this project.
79+
![](readme-images/client.png)
5380
1. Configure permissions for your application:
5481

5582
1. Choose **Settings** > **Required permissions** > **Add**.
5683
1. Choose **Select an API** > **Microsoft Graph**, and then click **Select**.
57-
1. Choose **Select permissions**, scroll down to **Delegated Permissions**, choose **Read user mail**, and then click **Select**.
84+
1. Choose **Select permissions**, scroll down to **Delegated Permissions**, choose **Mail.Read**, and then click **Select**.
5885
1. Click **Done**.
86+
![](readme-images/permissions.png)
87+
88+
1. 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.**
5989

60-
1. Choose **Settings** > **Keys**. Enter a description, choose a duration for the key, and then click **Save**.
90+
![](readme-images/secrets.png)
6191

6292
1. **Important**: Copy the key value--this is your app's secret. You won't be able to access this value again after you leave this blade.
6393

64-
You'll use the application ID and secret to configure the app.
94+
You'll use the **application ID** and **secret** to configure the app.
6595

6696
## Configure a tunnel for your localhost
6797

@@ -90,6 +120,7 @@ You'll need the `NGROK_ID` value in the next section.
90120
1. Replace `ENTER_YOUR_CLIENT_ID` with the client ID of your registered Azure application.
91121
1. Replace `ENTER_YOUR_SECRET` with the client secret of your registered Azure application.
92122
1. Replace `NGROK_ID` with the value in *https public URL* from the previous section.
123+
![](const)
93124
1. Install the dependencies running the following command:
94125
95126
```Shell
@@ -129,4 +160,4 @@ Office 365 development questions? Post them to [Stack Overflow](http://stackover
129160
130161
## Copyright
131162
132-
Copyright (c) 2016 Microsoft. All rights reserved.
163+
Copyright (c) 2019 Microsoft. All rights reserved.

package-lock.json

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

readme-images/client.png

25 KB
Loading

readme-images/const.png

21.1 KB
Loading

readme-images/permissions.png

26.2 KB
Loading

readme-images/registrations.png

79.4 KB
Loading

0 commit comments

Comments
 (0)