Skip to content

Commit 6f0c2e3

Browse files
author
Jim Crowley
authored
Update README.md
Updating readme with latest app registration steps and prerequisites.
1 parent f6a42d3 commit 6f0c2e3

File tree

1 file changed

+41
-10
lines changed

1 file changed

+41
-10
lines changed

README.md

Lines changed: 41 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -28,17 +28,48 @@ This Node.js sample shows how to start getting notifications from Microsoft Grap
2828
To use the Webhook sample, you need the following:
2929

3030
* [Node.js](https://nodejs.org/) version 4 or 5.
31-
* An app registered in Microsoft Azure. You can use the [App Registration Portal](https://apps.dev.microsoft.com/) with the following parameters:
32-
33-
| Parameter | Value |
34-
|----------------:|:-------------------------------|
35-
| App type | Web App |
36-
| Sign on URL | http://localhost:3000 |
37-
| Redirect URI | http://localhost:3000/callback |
38-
| App permissions | Mail.Read |
31+
* A [work or school account](http://dev.office.com/devprogram).
32+
33+
## Register the app
34+
35+
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).
36+
37+
1. Sign in to the portal using your work or school account.
38+
39+
2. Choose **Azure Active Directory** in the left-hand navigation pane.
40+
41+
3. Choose **App registrations**, and then choose **New application registration**.
42+
43+
a. Enter a friendly name for the application.
44+
45+
b. Choose 'Web app/API' as the **Application Type**.
46+
47+
c. Enter *http://localhost:3000/callback* for the **Sign-on URL**.
48+
49+
d. Click **Create**.
50+
51+
4. Choose your new application from the list of registered applications.
52+
53+
5. Copy and store the Application ID. This value is shown in the **Essentials** pane or in **Settings** > **Properties**.
54+
55+
6. To enable multi-tenanted support for the app, choose **Settings** > **Properties** and set **Multi-tenanted** to **Yes**.
56+
57+
7. Configure permissions for your application:
58+
59+
a. Choose **Settings** > **Required permissions** > **Add**.
60+
61+
b. Choose **Select an API** > **Microsoft Graph**, and then click **Select**.
3962

40-
Copy and store the **Client ID** and **Client Secret** values.
41-
63+
c. Choose **Select permissions**, scroll down to **Delegated Permissions**, choose **Read user mail**, and then click **Select**.
64+
65+
d. Click **Done**.
66+
67+
8. Choose **Settings** > **Keys**. Enter a description, choose a duration for the key, and then click **Save**.
68+
69+
9. **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.
70+
71+
You'll use the application ID and secret to configure the app.
72+
4273
## Configure a tunnel for your localhost
4374

4475
The sample uses *localhost* as the development server. For this reason, we need a tunnel that can forward requests from a URL on the Internet to our *localhost*. If for any reason, you don't want to use a tunnel, see [Hosting without a tunnel](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Hosting-the-sample-without-a-tunnel). If you want a detailed explanation about why to use a tunnel, see [Why do I have to use a tunnel?](https://github.com/OfficeDev/Microsoft-Graph-Nodejs-Webhooks/wiki/Why-do-I-have-to-use-a-tunnel)

0 commit comments

Comments
 (0)