Skip to content

Commit 04591ec

Browse files
committed
- fixes #24: removes links to nodejs sample wiki
1 parent 3519d5d commit 04591ec

File tree

2 files changed

+21
-3
lines changed

2 files changed

+21
-3
lines changed

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ extensions:
2626

2727
![.NET Core](https://github.com/microsoftgraph/aspnetcore-webhooks-sample/workflows/.NET%20Core/badge.svg?branch=master)
2828

29-
Subscribe for [Microsoft Graph webhooks](https://docs.microsoft.com/graph/api/resources/webhooks) to be notified when your user's data changes, so you don't have to poll for changes.
29+
Subscribe for [Microsoft Graph change notifications](https://docs.microsoft.com/graph/api/resources/webhooks) to be notified when your user's data changes, so you don't have to poll for changes.
3030

3131
This sample ASP.NET Core web application shows how to subscribe for change notifications as well as how to validate and decrypt change notifications with resource data (preview) when supported by the resource.
3232

@@ -162,7 +162,7 @@ You can use the ngrok web interface (http://127.0.0.1:4040) to inspect the HTTP
162162

163163
Keep the console open while testing. If you close it, the tunnel also closes and you'll need to generate a new URL and update the sample.
164164

165-
>See [Hosting without a tunnel](https://github.com/microsoftgraph/nodejs-webhooks-rest-sample/wiki/Hosting-the-sample-without-a-tunnel) and [Why do I have to use a tunnel?](https://github.com/microsoftgraph/nodejs-webhooks-rest-sample/wiki/Why-do-I-have-to-use-a-tunnel) for more information about using tunnels.
165+
>See [troubleshooting](./TROUBLESHOOTING.md) for more information about using tunnels.
166166
167167
## Configure and run the sample
168168

@@ -299,7 +299,7 @@ You can suggest changes for Microsoft Graph on [UserVoice](https://microsoftgrap
299299

300300
## Additional resources
301301

302-
- [Microsoft Graph Webhooks sample for Node.js](https://github.com/microsoftgraph/nodejs-webhooks-rest-sample) (Delegated permissions)
302+
- [Microsoft Graph Webhooks sample for Node.js](https://github.com/microsoftgraph/nodejs-webhooks-rest-sample)
303303
- [Microsoft Graph Webhooks sample for Java Spring](https://github.com/microsoftgraph/java-spring-webhooks-sample)
304304
- [Working with Webhooks in Microsoft Graph](https://docs.microsoft.com/graph/api/resources/webhooks)
305305
- [Subscription resource](https://docs.microsoft.com/graph/api/resources/subscription)

TROUBLESHOOTING.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,3 +30,21 @@ Make sure the local path where you placed the solution is not too long/deep. Mov
3030
**The resource cannot be found.* browser page.**
3131

3232
Make sure that a CSHTML view file isn't the active tab when you run the app from Visual Studio.
33+
34+
## Hosting the sample without a tunnel
35+
36+
Microsoft Graph (or any other webhook provider) needs a notification URL that it can reach to deliver notifications. The sample uses localhost as the development server.
37+
38+
Localhost just means this host. If any webhook provider would deliver a notification to localhost, it would be delivering it to itself. Not very useful.
39+
40+
Microsoft Graph can't deliver notifications to localhost. For this reason, we need a tunnel that can forward requests from a URL on the Internet to our localhost.
41+
42+
There are some alternatives that you can consider to try this sample without a tunnel.
43+
44+
### Host the sample on a cloud service
45+
46+
You can host the sample using a cloud service such as Microsoft Azure. Cloud services allow you to expose the notification URL to the Internet. Microsoft Graph can deliver notifications to the URL in the cloud.
47+
48+
Note that in some cases, you'll be able to deploy the sample to a website hosted in the cloud. In other cases, you'll need to set up a virtual machine and install a development environment with the prerequisites listed in the [ReadMe](./README.md#prerequisites).
49+
50+
See your cloud provider's documentation for details about how to host a web application or virtual machine using the cloud service.

0 commit comments

Comments
 (0)