├── .gitattributes
├── .github
    ├── ISSUE_TEMPLATE
    │   ├── ask-a-question.md
    │   └── bug_report.md
    ├── dependabot.yml
    ├── policies
    │   └── resourceManagement.yml
    └── workflows
    │   ├── auto-merge-dependabot.yml
    │   └── dotnet.yml
├── .gitignore
├── .vscode
    ├── extensions.json
    ├── launch.json
    ├── settings.json
    └── tasks.json
├── CODE_OF_CONDUCT.md
├── GraphSampleFunctions
    ├── GetMyNewestMessage.cs
    ├── GraphSampleFunctions.csproj
    ├── Models
    │   └── SetSubscriptionPayload.cs
    ├── Notify.cs
    ├── Program.cs
    ├── Services
    │   ├── GraphClientService.cs
    │   ├── IGraphClientService.cs
    │   ├── ITokenValidationService.cs
    │   ├── TokenValidationResult.cs
    │   └── TokenValidationService.cs
    ├── SetSubscription.cs
    ├── host.json
    └── local.settings.json
├── LICENSE
├── README.md
└── TestClient
    ├── auth.js
    ├── azurefunctions.js
    ├── config.example.js
    ├── g-raph.png
    ├── index.html
    ├── style.css
    └── ui.js


/.gitattributes:
--------------------------------------------------------------------------------
1 | # Set the default behavior, in case people don't have core.autocrlf set.
2 | * text=auto
3 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/ask-a-question.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Ask a question
 3 | about: Ask a question about Graph, adding features to this sample, etc.
 4 | title: ''
 5 | labels: question, needs triage
 6 | assignees: ''
 7 | 
 8 | ---
 9 | 
10 | Thank you for taking an interest in Microsoft Graph development! Please feel free to ask a question here, but keep in mind the following:
11 | 
12 | - This is not an official Microsoft support channel, and our ability to respond to questions here is limited. Questions about Graph, or questions about adding a new feature to the sample, will be answered on a best-effort basis.
13 | - Questions should be asked on [Microsoft Q&A](https://learn.microsoft.com/answers/products/graph).
14 | - Issues with Microsoft Graph itself should be handled through [support](https://developer.microsoft.com/graph/support).
15 | 


--------------------------------------------------------------------------------
/.github/ISSUE_TEMPLATE/bug_report.md:
--------------------------------------------------------------------------------
 1 | ---
 2 | name: Bug report
 3 | about: Create a report to help us improve
 4 | title: ''
 5 | labels: bug report, needs triage
 6 | assignees: ''
 7 | 
 8 | ---
 9 | 
10 | **Where did you get the code?**
11 | 
12 | - [ ] Downloaded from GitHub
13 | - [ ] Downloaded from the [Microsoft Graph quick start tool](https://developer.microsoft.com/graph/quick-start)
14 | - [ ] Followed the tutorial from [Microsoft Graph tutorials](https://learn.microsoft.com/graph/tutorials)
15 | 
16 | **Describe the bug**
17 | A clear and concise description of what the bug is.
18 | 
19 | **To Reproduce**
20 | Steps to reproduce the behavior:
21 | 
22 | 1. Go to '...'
23 | 2. Click on '....'
24 | 3. Scroll down to '....'
25 | 4. See error
26 | 
27 | **Expected behavior**
28 | A clear and concise description of what you expected to happen.
29 | 
30 | **Screenshots**
31 | If applicable, add screenshots to help explain your problem.
32 | 
33 | **Desktop (please complete the following information):**
34 | 
35 | - OS: [e.g. iOS]
36 | - Browser [e.g. chrome, safari]
37 | - Version [e.g. 22]
38 | 
39 | **Dependency versions**
40 | 
41 | - Authentication library (MSAL, etc.) version:
42 | - Graph library (Graph SDK, REST library, etc.) version:
43 | 
44 | **Additional context**
45 | Add any other context about the problem here.
46 | 


--------------------------------------------------------------------------------
/.github/dependabot.yml:
--------------------------------------------------------------------------------
 1 | # To get started with Dependabot version updates, you'll need to specify which
 2 | # package ecosystems to update and where the package manifests are located.
 3 | # Please see the documentation for all configuration options:
 4 | # https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
 5 | 
 6 | version: 2
 7 | updates:
 8 |   - package-ecosystem: nuget # See documentation for possible values
 9 |     directory: /GraphSampleFunctions # Location of package manifests
10 |     schedule:
11 |       interval: weekly
12 |   - package-ecosystem: github-actions
13 |     directory: /
14 |     schedule:
15 |       interval: weekly
16 | 


--------------------------------------------------------------------------------
/.github/policies/resourceManagement.yml:
--------------------------------------------------------------------------------
  1 | id: 
  2 | name: GitOps.PullRequestIssueManagement
  3 | description: GitOps.PullRequestIssueManagement primitive
  4 | owner: 
  5 | resource: repository
  6 | disabled: false
  7 | where: 
  8 | configuration:
  9 |   resourceManagementConfiguration:
 10 |     scheduledSearches:
 11 |     - description: 
 12 |       frequencies:
 13 |       - hourly:
 14 |           hour: 6
 15 |       filters:
 16 |       - isIssue
 17 |       - isOpen
 18 |       - hasLabel:
 19 |           label: needs author feedback
 20 |       - hasLabel:
 21 |           label: no recent activity
 22 |       - noActivitySince:
 23 |           days: 3
 24 |       actions:
 25 |       - closeIssue
 26 |     - description: 
 27 |       frequencies:
 28 |       - hourly:
 29 |           hour: 6
 30 |       filters:
 31 |       - isIssue
 32 |       - isOpen
 33 |       - hasLabel:
 34 |           label: needs author feedback
 35 |       - noActivitySince:
 36 |           days: 4
 37 |       - isNotLabeledWith:
 38 |           label: no recent activity
 39 |       actions:
 40 |       - addLabel:
 41 |           label: no recent activity
 42 |       - addReply:
 43 |           reply: This issue has been automatically marked as stale because it has been marked as requiring author feedback but has not had any activity for **4 days**. It will be closed if no further activity occurs **within 3 days of this comment**.
 44 |     - description: 
 45 |       frequencies:
 46 |       - hourly:
 47 |           hour: 6
 48 |       filters:
 49 |       - isIssue
 50 |       - isOpen
 51 |       - hasLabel:
 52 |           label: duplicate
 53 |       - noActivitySince:
 54 |           days: 1
 55 |       actions:
 56 |       - addReply:
 57 |           reply: This issue has been marked as duplicate and has not had any activity for **1 day**. It will be closed for housekeeping purposes.
 58 |       - closeIssue
 59 |     - description: 
 60 |       frequencies:
 61 |       - hourly:
 62 |           hour: 3
 63 |       filters:
 64 |       - isOpen
 65 |       - isIssue
 66 |       - hasLabel:
 67 |           label: graph question
 68 |       actions:
 69 |       - removeLabel:
 70 |           label: 'needs attention :wave:'
 71 |       - removeLabel:
 72 |           label: needs author feedback
 73 |       - removeLabel:
 74 |           label: 'needs triage :mag:'
 75 |       - removeLabel:
 76 |           label: no recent activity
 77 |       - addLabel:
 78 |           label: out of scope
 79 |       - addReply:
 80 |           reply: >-
 81 |             It looks like you are asking a question about using Microsoft Graph or one of the Microsoft Graph SDKs that is not directly related to this sample. Unfortunately we are not set up to answer general questions in this repository, so this issue will be closed.
 82 | 
 83 | 
 84 |             Please try asking your question on [Stack Overflow](https://stackoverflow.com/questions/tagged/microsoft-graph-api), tagging your question with `microsoft-graph-api`.
 85 |       - closeIssue
 86 |     - description: 
 87 |       frequencies:
 88 |       - hourly:
 89 |           hour: 3
 90 |       filters:
 91 |       - isOpen
 92 |       - isIssue
 93 |       - hasLabel:
 94 |           label: graph issue
 95 |       actions:
 96 |       - removeLabel:
 97 |           label: 'needs attention :wave:'
 98 |       - removeLabel:
 99 |           label: needs author feedback
100 |       - removeLabel:
101 |           label: 'needs triage :mag:'
102 |       - removeLabel:
103 |           label: no recent activity
104 |       - addLabel:
105 |           label: out of scope
106 |       - addReply:
107 |           reply: >-
108 |             It looks like you are reporting an issue with Microsoft Graph or one of the Microsoft Graph SDKs that is not fixable by changing code in this sample. Unfortunately we are not set up to provide product support in this repository, so this issue will be closed.
109 | 
110 | 
111 |             Please visit one of the following links to report your issue.
112 | 
113 | 
114 |             - Issue with Microsoft Graph service: [Microsoft Graph support](https://developer.microsoft.com/graph/support#report-issues-with-the-service), choose one of the options under **Report issues with the service**
115 | 
116 |             - Issue with a Microsoft Graph SDK: Open an issue in the SDK's GitHub repository. See [microsoftgraph on GitHub](https://github.com/microsoftgraph?q=sdk+in%3Aname&type=public&language=) for a list of SDK repositories.
117 |       - closeIssue
118 |     eventResponderTasks:
119 |     - if:
120 |       - payloadType: Issue_Comment
121 |       - isAction:
122 |           action: Created
123 |       - isActivitySender:
124 |           issueAuthor: True
125 |       - hasLabel:
126 |           label: needs author feedback
127 |       - isOpen
128 |       then:
129 |       - addLabel:
130 |           label: 'needs attention :wave:'
131 |       - removeLabel:
132 |           label: needs author feedback
133 |       description: 
134 |     - if:
135 |       - payloadType: Issues
136 |       - not:
137 |           isAction:
138 |             action: Closed
139 |       - hasLabel:
140 |           label: no recent activity
141 |       then:
142 |       - removeLabel:
143 |           label: no recent activity
144 |       description: 
145 |     - if:
146 |       - payloadType: Issue_Comment
147 |       - hasLabel:
148 |           label: no recent activity
149 |       then:
150 |       - removeLabel:
151 |           label: no recent activity
152 |       description: 
153 |     - if:
154 |       - payloadType: Pull_Request
155 |       then:
156 |       - inPrLabel:
157 |           label: in pr
158 |       description: 
159 | onFailure: 
160 | onSuccess: 
161 | 


--------------------------------------------------------------------------------
/.github/workflows/auto-merge-dependabot.yml:
--------------------------------------------------------------------------------
 1 | name: Auto-merge dependabot updates
 2 | 
 3 | on:
 4 |   pull_request:
 5 |     branches: [ main ]
 6 |     
 7 | permissions:
 8 |   pull-requests: write
 9 |   contents: write
10 | 
11 | jobs:
12 | 
13 |   dependabot-merge:
14 | 
15 |     runs-on: ubuntu-latest
16 |     
17 |     if: ${{ github.actor == 'dependabot[bot]' }}
18 | 
19 |     steps:
20 |       - name: Dependabot metadata
21 |         id: metadata
22 |         uses: dependabot/fetch-metadata@v1.6.0
23 |         with:
24 |           github-token: "${{ secrets.GITHUB_TOKEN }}"
25 |       
26 |       - name: Enable auto-merge for Dependabot PRs
27 |         if: ${{steps.metadata.outputs.update-type != 'version-update:semver-major'}}
28 |         run: gh pr merge --auto --merge "$PR_URL"
29 |         env:
30 |           PR_URL: ${{github.event.pull_request.html_url}}
31 |           GITHUB_TOKEN: ${{secrets.GITHUB_TOKEN}}
32 | 


--------------------------------------------------------------------------------
/.github/workflows/dotnet.yml:
--------------------------------------------------------------------------------
 1 | name: .NET
 2 | 
 3 | on:
 4 |   push:
 5 |     branches: [ main ]
 6 |   pull_request:
 7 |     branches: [ main ]
 8 | 
 9 | jobs:
10 |   build:
11 |     defaults:
12 |       run:
13 |         working-directory: GraphSampleFunctions/
14 | 
15 |     runs-on: ubuntu-latest
16 | 
17 |     steps:
18 |     - uses: actions/checkout@v4
19 |     - name: Setup .NET
20 |       uses: actions/setup-dotnet@v4
21 |       with:
22 |         dotnet-version: 7.x
23 |     - name: Restore dependencies
24 |       run: dotnet restore
25 |     - name: Build
26 |       run: dotnet build --no-restore
27 | 


--------------------------------------------------------------------------------
/.gitignore:
--------------------------------------------------------------------------------
1 | obj/
2 | bin/
3 | 
4 | config.js
5 | 


--------------------------------------------------------------------------------
/.vscode/extensions.json:
--------------------------------------------------------------------------------
1 | {
2 |   "recommendations": [
3 |     "ms-azuretools.vscode-azurefunctions",
4 |     "ms-dotnettools.csharp"
5 |   ]
6 | }
7 | 


--------------------------------------------------------------------------------
/.vscode/launch.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   // Use IntelliSense to learn about possible attributes.
 3 |   // Hover to view descriptions of existing attributes.
 4 |   // For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
 5 |   "version": "0.2.0",
 6 |   "configurations": [
 7 |     {
 8 |       "name": "Attach to .NET Functions",
 9 |       "type": "coreclr",
10 |       "request": "attach",
11 |       "processId": "${command:azureFunctions.pickProcess}"
12 |     }
13 |   ]
14 | }
15 | 


--------------------------------------------------------------------------------
/.vscode/settings.json:
--------------------------------------------------------------------------------
 1 | {
 2 |   "cSpell.ignoreWords": [
 3 |     "pkce",
 4 |     "raph"
 5 |   ],
 6 |   "azureFunctions.deploySubpath": "GraphSampleFunctions/bin/Release/net7.0/publish",
 7 |   "azureFunctions.projectLanguage": "C#",
 8 |   "azureFunctions.projectRuntime": "~4",
 9 |   "debug.internalConsoleOptions": "neverOpen",
10 |   "azureFunctions.preDeployTask": "publish (functions)",
11 |   "cSpell.words": [
12 |     "MSAL"
13 |   ]
14 | }


--------------------------------------------------------------------------------
/.vscode/tasks.json:
--------------------------------------------------------------------------------
  1 | {
  2 |   // See https://go.microsoft.com/fwlink/?LinkId=733558
  3 |   // for the documentation about the tasks.json format
  4 |   "version": "2.0.0",
  5 |   "tasks": [
  6 |     {
  7 |       "label": "clean",
  8 |       "command": "dotnet",
  9 |       "options": {
 10 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
 11 |       },
 12 |       "args": [
 13 |         "clean",
 14 |         "/property:GenerateFullPaths=true",
 15 |         "/consoleloggerparameters:NoSummary"
 16 |       ],
 17 |       "type": "process",
 18 |       "problemMatcher": "$msCompile"
 19 |     },
 20 |     {
 21 |       "label": "build",
 22 |       "command": "dotnet",
 23 |       "options": {
 24 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
 25 |       },
 26 |       "args": [
 27 |         "build",
 28 |         "/property:GenerateFullPaths=true",
 29 |         "/consoleloggerparameters:NoSummary"
 30 |       ],
 31 |       "type": "process",
 32 |       "dependsOn": "clean",
 33 |       "group": {
 34 |         "kind": "build",
 35 |         "isDefault": true
 36 |       },
 37 |       "problemMatcher": "$msCompile"
 38 |     },
 39 |     {
 40 |       "label": "clean (functions)",
 41 |       "command": "dotnet",
 42 |       "args": [
 43 |         "clean",
 44 |         "/property:GenerateFullPaths=true",
 45 |         "/consoleloggerparameters:NoSummary"
 46 |       ],
 47 |       "type": "process",
 48 |       "problemMatcher": "$msCompile",
 49 |       "options": {
 50 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
 51 |       }
 52 |     },
 53 |     {
 54 |       "label": "build (functions)",
 55 |       "command": "dotnet",
 56 |       "args": [
 57 |         "build",
 58 |         "/property:GenerateFullPaths=true",
 59 |         "/consoleloggerparameters:NoSummary"
 60 |       ],
 61 |       "type": "process",
 62 |       "dependsOn": "clean (functions)",
 63 |       "group": {
 64 |         "kind": "build",
 65 |         "isDefault": true
 66 |       },
 67 |       "problemMatcher": "$msCompile",
 68 |       "options": {
 69 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
 70 |       }
 71 |     },
 72 |     {
 73 |       "label": "clean release (functions)",
 74 |       "command": "dotnet",
 75 |       "args": [
 76 |         "clean",
 77 |         "--configuration",
 78 |         "Release",
 79 |         "/property:GenerateFullPaths=true",
 80 |         "/consoleloggerparameters:NoSummary"
 81 |       ],
 82 |       "type": "process",
 83 |       "problemMatcher": "$msCompile",
 84 |       "options": {
 85 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
 86 |       }
 87 |     },
 88 |     {
 89 |       "label": "publish (functions)",
 90 |       "command": "dotnet",
 91 |       "args": [
 92 |         "publish",
 93 |         "--configuration",
 94 |         "Release",
 95 |         "/property:GenerateFullPaths=true",
 96 |         "/consoleloggerparameters:NoSummary"
 97 |       ],
 98 |       "type": "process",
 99 |       "dependsOn": "clean release (functions)",
100 |       "problemMatcher": "$msCompile",
101 |       "options": {
102 |         "cwd": "${workspaceFolder}/GraphSampleFunctions"
103 |       }
104 |     },
105 |     {
106 |       "type": "func",
107 |       "dependsOn": "build (functions)",
108 |       "options": {
109 |         "cwd": "${workspaceFolder}/GraphSampleFunctions/bin/Debug/net7.0"
110 |       },
111 |       "command": "host start",
112 |       "isBackground": true,
113 |       "problemMatcher": "$func-dotnet-watch"
114 |     }
115 |   ]
116 | }
117 | 


--------------------------------------------------------------------------------
/CODE_OF_CONDUCT.md:
--------------------------------------------------------------------------------
 1 | # Microsoft Open Source Code of Conduct
 2 | 
 3 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/).
 4 | 
 5 | Resources:
 6 | 
 7 | - [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/)
 8 | - [Microsoft Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/)
 9 | - Contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with questions or concerns
10 | - Employees can reach out at [aka.ms/opensource/moderation-support](https://aka.ms/opensource/moderation-support)
11 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/GetMyNewestMessage.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using System.Net;
 5 | using Microsoft.Azure.Functions.Worker;
 6 | using Microsoft.Azure.Functions.Worker.Http;
 7 | using Microsoft.Extensions.Logging;
 8 | using Microsoft.Graph.Models;
 9 | using GraphSampleFunctions.Services;
10 | 
11 | namespace GraphSampleFunctions
12 | {
13 |     public class GetMyNewestMessage
14 |     {
15 |         private readonly ITokenValidationService _tokenValidationService;
16 |         private readonly IGraphClientService _graphClientService;
17 |         private readonly ILogger _logger;
18 | 
19 |         public GetMyNewestMessage(
20 |             ITokenValidationService tokenValidationService,
21 |             IGraphClientService graphClientService,
22 |             ILoggerFactory loggerFactory)
23 |         {
24 |             _tokenValidationService = tokenValidationService;
25 |             _graphClientService = graphClientService;
26 |             _logger = loggerFactory.CreateLogger<GetMyNewestMessage>();
27 |         }
28 | 
29 |         [Function("GetMyNewestMessage")]
30 |         public async Task<HttpResponseData> RunAsync(
31 |             [HttpTrigger(AuthorizationLevel.Function, "get")] HttpRequestData req)
32 |         {
33 |             _logger.LogInformation("GetMyNewMessage function triggered.");
34 | 
35 |             // Validate the bearer token
36 |             var bearerToken = await _tokenValidationService
37 |                 .ValidateAuthorizationHeaderAsync(req);
38 |             if (string.IsNullOrEmpty(bearerToken))
39 |             {
40 |                 // If token wasn't returned it isn't valid
41 |                 return req.CreateResponse(HttpStatusCode.Unauthorized);
42 |             }
43 | 
44 |             var graphClient = _graphClientService.GetUserGraphClient(bearerToken);
45 |             if (graphClient == null)
46 |             {
47 |                 _logger.LogError("Could not create a Graph client for the user");
48 |                 return req.CreateResponse(HttpStatusCode.InternalServerError);
49 |             }
50 | 
51 |             // Get the user's newest message in inbox
52 |             // GET /me/mailFolders/inbox/messages
53 |             var messagePage = await graphClient.Me
54 |                 .MailFolders["Inbox"]
55 |                 .Messages
56 |                 .GetAsync(config =>
57 |                 {
58 |                     // Limit the fields returned
59 |                     config.QueryParameters.Select = new[] { "from", "receivedDateTime", "subject" };
60 |                     // Sort by received time, newest on top
61 |                     config.QueryParameters.Orderby = new[] { "receivedDateTime DESC" };
62 |                     // Only get back one (the newest) message
63 |                     config.QueryParameters.Top = 1;
64 |                 });
65 | 
66 |             if (messagePage?.Value?.Count > 0)
67 |             {
68 |                 var response = req.CreateResponse(HttpStatusCode.OK);
69 |                 // Return the message in the response
70 |                 await response.WriteAsJsonAsync<Message>(messagePage.Value.First());
71 |                 return response;
72 |             }
73 | 
74 |             return req.CreateResponse(HttpStatusCode.NoContent);
75 |         }
76 |     }
77 | }
78 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/GraphSampleFunctions.csproj:
--------------------------------------------------------------------------------
 1 | <Project Sdk="Microsoft.NET.Sdk">
 2 |   <PropertyGroup>
 3 |     <TargetFramework>net7.0</TargetFramework>
 4 |     <AzureFunctionsVersion>v4</AzureFunctionsVersion>
 5 |     <OutputType>Exe</OutputType>
 6 |     <ImplicitUsings>enable</ImplicitUsings>
 7 |     <Nullable>enable</Nullable>
 8 |     <UserSecretsId>08b88a61-2524-42f0-94ef-b578337333ec</UserSecretsId>
 9 |   </PropertyGroup>
10 |   <ItemGroup>
11 |     <PackageReference Include="Azure.Identity" Version="1.13.2" />
12 |     <PackageReference Include="Microsoft.Azure.Functions.Worker.Extensions.Http" Version="3.2.0" />
13 |     <PackageReference Include="Microsoft.Azure.Functions.Worker.Sdk" Version="1.18.1" OutputItemType="Analyzer" />
14 |     <PackageReference Include="Microsoft.Azure.Functions.Worker" Version="1.23.0" />
15 |     <PackageReference Include="Microsoft.Extensions.Configuration.UserSecrets" Version="7.0.0" />
16 |     <PackageReference Include="Microsoft.Graph" Version="5.77.0" />
17 |   </ItemGroup>
18 |   <ItemGroup>
19 |     <None Update="host.json">
20 |       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
21 |     </None>
22 |     <None Update="local.settings.json">
23 |       <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
24 |       <CopyToPublishDirectory>Never</CopyToPublishDirectory>
25 |     </None>
26 |   </ItemGroup>
27 |   <ItemGroup>
28 |     <Using Include="System.Threading.ExecutionContext" Alias="ExecutionContext" />
29 |   </ItemGroup>
30 | </Project>


--------------------------------------------------------------------------------
/GraphSampleFunctions/Models/SetSubscriptionPayload.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | namespace GraphSampleFunctions.Models
 5 | {
 6 |     // Class to represent the payload sent to the
 7 |     // SetSubscription function
 8 |     public class SetSubscriptionPayload
 9 |     {
10 |         // "subscribe" or "unsubscribe"
11 |         public string? RequestType { get;set; }
12 |         // If unsubscribing, the subscription to delete
13 |         public string? SubscriptionId { get;set; }
14 |         // If subscribing, the user ID to subscribe to
15 |         // Can be object ID of user, or userPrincipalName
16 |         public string? UserId { get;set; }
17 |     }
18 | }
19 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Notify.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using System.Net;
 5 | using Microsoft.Azure.Functions.Worker;
 6 | using Microsoft.Azure.Functions.Worker.Http;
 7 | using Microsoft.Extensions.Logging;
 8 | using Microsoft.Graph;
 9 | using Microsoft.Graph.Models;
10 | using Microsoft.Graph.Me.Messages.Item;
11 | using Microsoft.Kiota.Abstractions.Serialization;
12 | using GraphSampleFunctions.Services;
13 | 
14 | namespace GraphSampleFunctions
15 | {
16 |     public class Notify
17 |     {
18 |         private readonly IGraphClientService _graphClientService;
19 |         private readonly ILogger _logger;
20 | 
21 |         public Notify(
22 |             IGraphClientService graphClientService,
23 |             ILoggerFactory loggerFactory)
24 |         {
25 |             _graphClientService = graphClientService;
26 |             _logger = loggerFactory.CreateLogger<Notify>();
27 |         }
28 | 
29 |         [Function("Notify")]
30 |         public async Task<HttpResponseData> RunAsync(
31 |             [HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequestData req)
32 |         {
33 |             _logger.LogInformation("Notify function triggered.");
34 | 
35 |             // Is this a validation request?
36 |             // https://learn.microsoft.com/graph/webhooks#notification-endpoint-validation
37 |             if (req.FunctionContext.BindingContext.BindingData
38 |                 .TryGetValue("validationToken", out object? validationToken))
39 |             {
40 |                 // Return the validation token in a plain text body
41 |                 var validationResponse = req.CreateResponse(HttpStatusCode.OK);
42 |                 validationResponse.Headers.Add("Content-Type", "text/plain; charset=utf-8");
43 |                 validationResponse.WriteString(validationToken?.ToString() ?? string.Empty);
44 |                 return validationResponse;
45 |             }
46 | 
47 |             var graphClient = _graphClientService.GetAppGraphClient();
48 |             if (graphClient == null)
49 |             {
50 |                 _logger.LogError("Could not create a Graph client for the app");
51 |                 return req.CreateResponse(HttpStatusCode.InternalServerError);
52 |             }
53 | 
54 |             var notifications = GetNotificationsFromRequest(req);
55 |             if (notifications?.Value != null)
56 |             {
57 |                 foreach (var notification in notifications?.Value!)
58 |                 {
59 |                     await ProcessNotificationAsync(graphClient, notification);
60 |                 }
61 |             }
62 | 
63 |             // Return 202 per docs
64 |             return req.CreateResponse(HttpStatusCode.Accepted);
65 |         }
66 | 
67 |         private ChangeNotificationCollectionResponse? GetNotificationsFromRequest(HttpRequestData req)
68 |         {
69 |             return ParseNodeFactoryRegistry.DefaultInstance
70 |                 .GetRootParseNode("application/json", req.Body)
71 |                 .GetObjectValue<ChangeNotificationCollectionResponse>(
72 |                     ChangeNotificationCollectionResponse.CreateFromDiscriminatorValue);
73 |         }
74 | 
75 |         private async Task ProcessNotificationAsync(
76 |             GraphServiceClient graphClient,
77 |             ChangeNotification notification)
78 |         {
79 |             // The resource field in the notification has the URL to the
80 |             // message, including the user ID and message ID. Since we
81 |             // have the URL, use a MessageRequestBuilder instead of the fluent
82 |             // API
83 |             var msgRequestBuilder = new MessageItemRequestBuilder(
84 |                 $"https://graph.microsoft.com/v1.0/{notification.Resource}",
85 |                 graphClient.RequestAdapter);
86 | 
87 |             var message = await msgRequestBuilder.GetAsync(config =>
88 |             {
89 |                 config.QueryParameters.Select = new[] { "subject" };
90 |             });
91 | 
92 |             _logger.LogInformation($"The following message was {notification.ChangeType}:");
93 |             _logger.LogInformation($"Subject: {message?.Subject}, ID: {message?.Id}");
94 |         }
95 |     }
96 | }
97 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Program.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using System.Reflection;
 5 | using System.Text.Json;
 6 | using Azure.Core.Serialization;
 7 | using Microsoft.Extensions.Configuration;
 8 | using Microsoft.Extensions.DependencyInjection;
 9 | using Microsoft.Extensions.Hosting;
10 | using GraphSampleFunctions.Services;
11 | 
12 | var host = new HostBuilder()
13 |     .ConfigureFunctionsWorkerDefaults(configureOptions: options =>
14 |     {
15 |         options.Serializer = new JsonObjectSerializer(
16 |             new JsonSerializerOptions
17 |             {
18 |                 PropertyNamingPolicy = JsonNamingPolicy.CamelCase,
19 |             }
20 |         );
21 |     })
22 |     .ConfigureAppConfiguration(config => {
23 |         config.AddUserSecrets(Assembly.GetExecutingAssembly(), false);
24 |     })
25 |     .ConfigureServices(services => {
26 |         services.AddSingleton<ITokenValidationService, TokenValidationService>();
27 |         services.AddSingleton<IGraphClientService, GraphClientService>();
28 |     })
29 |     .Build();
30 | 
31 | host.Run();
32 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Services/GraphClientService.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using Azure.Identity;
 5 | using Microsoft.Extensions.Configuration;
 6 | using Microsoft.Extensions.Logging;
 7 | using Microsoft.Graph;
 8 | 
 9 | namespace GraphSampleFunctions.Services
10 | {
11 |     public class GraphClientService : IGraphClientService
12 |     {
13 |         private readonly IConfiguration _config;
14 |         private readonly ILogger _logger;
15 |         private GraphServiceClient? _appGraphClient;
16 | 
17 |         public GraphClientService(IConfiguration config, ILoggerFactory loggerFactory)
18 |         {
19 |             _config = config;
20 |             _logger = loggerFactory.CreateLogger<GraphClientService>();
21 |         }
22 | 
23 |         public GraphServiceClient? GetUserGraphClient(string userAssertion)
24 |         {
25 |             var tenantId = _config["tenantId"];
26 |             var clientId = _config["apiClientId"];
27 |             var clientSecret = _config["apiClientSecret"];
28 | 
29 |             if (string.IsNullOrEmpty(tenantId) ||
30 |                 string.IsNullOrEmpty(clientId) ||
31 |                 string.IsNullOrEmpty(clientSecret))
32 |             {
33 |                 _logger.LogError("Required settings missing: 'tenantId', 'apiClientId', and 'apiClientSecret'.");
34 |                 return null;
35 |             }
36 | 
37 |             var onBehalfOfCredential = new OnBehalfOfCredential(
38 |                 tenantId, clientId, clientSecret, userAssertion);
39 | 
40 |             return new GraphServiceClient(onBehalfOfCredential);
41 |         }
42 | 
43 |         public GraphServiceClient? GetAppGraphClient()
44 |         {
45 |             if (_appGraphClient == null)
46 |             {
47 |                 var tenantId = _config["tenantId"];
48 |                 var clientId = _config["webhookClientId"];
49 |                 var clientSecret = _config["webhookClientSecret"];
50 | 
51 |                 if (string.IsNullOrEmpty(tenantId) ||
52 |                     string.IsNullOrEmpty(clientId) ||
53 |                     string.IsNullOrEmpty(clientSecret))
54 |                 {
55 |                     _logger.LogError("Required settings missing: 'tenantId', 'webhookClientId', and 'webhookClientSecret'.");
56 |                     return null;
57 |                 }
58 | 
59 |                 var clientSecretCredential = new ClientSecretCredential(
60 |                     tenantId, clientId, clientSecret);
61 | 
62 |                 _appGraphClient = new GraphServiceClient(clientSecretCredential);
63 |             }
64 | 
65 |             return _appGraphClient;
66 |         }
67 |     }
68 | }
69 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Services/IGraphClientService.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using Microsoft.Graph;
 5 | 
 6 | namespace GraphSampleFunctions.Services
 7 | {
 8 |     public interface IGraphClientService
 9 |     {
10 |         public GraphServiceClient? GetUserGraphClient(string userAssertion);
11 |         public GraphServiceClient? GetAppGraphClient();
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Services/ITokenValidationService.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | using Microsoft.Azure.Functions.Worker.Http;
 5 | 
 6 | namespace GraphSampleFunctions.Services
 7 | {
 8 |     public interface ITokenValidationService
 9 |     {
10 |         public Task<string?> ValidateAuthorizationHeaderAsync(
11 |             HttpRequestData request);
12 |     }
13 | }
14 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Services/TokenValidationResult.cs:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation. All rights reserved.
 2 | // Licensed under the MIT license.
 3 | 
 4 | namespace GraphSampleFunctions.Services
 5 | {
 6 |     public class TokenValidationResult
 7 |     {
 8 |         // User ID
 9 |         public string UserId { get; private set; }
10 | 
11 |         // The extracted token - used to build user assertion
12 |         // for OBO flow
13 |         public string Token { get; private set; }
14 | 
15 |         public TokenValidationResult(string userId, string token)
16 |         {
17 |             UserId = userId;
18 |             Token = token;
19 |         }
20 |     }
21 | }
22 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/Services/TokenValidationService.cs:
--------------------------------------------------------------------------------
  1 | // Copyright (c) Microsoft Corporation. All rights reserved.
  2 | // Licensed under the MIT license.
  3 | 
  4 | using System.Globalization;
  5 | using System.IdentityModel.Tokens.Jwt;
  6 | using System.Net.Http.Headers;
  7 | using Microsoft.Extensions.Configuration;
  8 | using Microsoft.Extensions.Logging;
  9 | using Microsoft.IdentityModel.Protocols;
 10 | using Microsoft.IdentityModel.Protocols.OpenIdConnect;
 11 | using Microsoft.IdentityModel.Tokens;
 12 | 
 13 | namespace GraphSampleFunctions.Services
 14 | {
 15 |     public class TokenValidationService : ITokenValidationService
 16 |     {
 17 |         private TokenValidationParameters? _validationParameters;
 18 |         private readonly IConfiguration _config;
 19 | 
 20 |         private readonly ILogger _logger;
 21 | 
 22 |         public TokenValidationService(IConfiguration config, ILoggerFactory loggerFactory)
 23 |         {
 24 |             _config = config;
 25 |             _logger = loggerFactory.CreateLogger<TokenValidationService>();
 26 |         }
 27 | 
 28 |         public async Task<string?> ValidateAuthorizationHeaderAsync(
 29 |             Microsoft.Azure.Functions.Worker.Http.HttpRequestData request)
 30 |         {
 31 |             // The incoming request should have an Authorization header
 32 |             if (request.Headers.TryGetValues("authorization", out IEnumerable<string>? authValues))
 33 |             {
 34 |                 var authHeader = AuthenticationHeaderValue.Parse(authValues.ToArray().First());
 35 | 
 36 |                 // Make sure that the value is "Bearer token-value"
 37 |                 if (authHeader != null &&
 38 |                     string.Compare(authHeader.Scheme, "bearer", true, CultureInfo.InvariantCulture) == 0 &&
 39 |                     !string.IsNullOrEmpty(authHeader.Parameter))
 40 |                 {
 41 |                     var validationParameters = await GetTokenValidationParametersAsync();
 42 |                     if (validationParameters == null)
 43 |                     {
 44 |                         return null;
 45 |                     }
 46 | 
 47 |                     var tokenHandler = new JwtSecurityTokenHandler();
 48 |                     try
 49 |                     {
 50 |                         // Validate the token
 51 |                         var result = tokenHandler.ValidateToken(authHeader.Parameter,
 52 |                             _validationParameters, out SecurityToken jwtToken);
 53 | 
 54 |                         // If ValidateToken did not throw an exception, token is valid.
 55 |                         return authHeader.Parameter;
 56 |                     }
 57 |                     catch (Exception exception)
 58 |                     {
 59 |                         _logger.LogError(exception, "Error validating bearer token");
 60 |                     }
 61 |                 }
 62 |             }
 63 | 
 64 |             return null;
 65 |         }
 66 | 
 67 |         private async Task<TokenValidationParameters?> GetTokenValidationParametersAsync()
 68 |         {
 69 |             if (_validationParameters == null)
 70 |             {
 71 |                 // Get tenant ID and client ID
 72 |                 var tenantId = _config["tenantId"];
 73 |                 var apiClientId = _config["apiClientId"];
 74 |                 if (string.IsNullOrEmpty(tenantId) ||
 75 |                     string.IsNullOrEmpty(apiClientId))
 76 |                 {
 77 |                     _logger.LogError("Required settings missing: 'tenantId' and 'apiClientId'.");
 78 |                     return null;
 79 |                 }
 80 | 
 81 |                 // Load the tenant-specific OpenID config from Azure
 82 |                 var configManager = new ConfigurationManager<OpenIdConnectConfiguration>(
 83 |                 $"https://login.microsoftonline.com/{tenantId}/.well-known/openid-configuration",
 84 |                 new OpenIdConnectConfigurationRetriever());
 85 | 
 86 |                 var config = await configManager.GetConfigurationAsync();
 87 | 
 88 |                 _validationParameters = new TokenValidationParameters
 89 |                 {
 90 |                     // Use signing keys retrieved from Azure
 91 |                     IssuerSigningKeys = config.SigningKeys,
 92 |                     ValidateAudience = true,
 93 |                     // Audience MUST be the app ID for the Web API
 94 |                     ValidAudience = apiClientId,
 95 |                     ValidateIssuer = true,
 96 |                     // Use the issuer retrieved from Azure
 97 |                     ValidIssuer = config.Issuer,
 98 |                     ValidateLifetime = true
 99 |                 };
100 |             }
101 | 
102 |             return _validationParameters;
103 |         }
104 |     }
105 | }
106 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/SetSubscription.cs:
--------------------------------------------------------------------------------
  1 | // Copyright (c) Microsoft Corporation. All rights reserved.
  2 | // Licensed under the MIT license.
  3 | 
  4 | using System.Globalization;
  5 | using System.Net;
  6 | using System.Text.Json;
  7 | using Microsoft.Azure.Functions.Worker;
  8 | using Microsoft.Azure.Functions.Worker.Http;
  9 | using Microsoft.Extensions.Configuration;
 10 | using Microsoft.Extensions.Logging;
 11 | using Microsoft.Graph.Models;
 12 | using GraphSampleFunctions.Models;
 13 | using GraphSampleFunctions.Services;
 14 | 
 15 | namespace GraphSampleFunctions
 16 | {
 17 |     public class SetSubscription
 18 |     {
 19 |         public static readonly string ClientState = "GraphSampleFunctionState";
 20 |         private readonly ITokenValidationService _tokenValidationService;
 21 |         private readonly IGraphClientService _graphClientService;
 22 |         private readonly IConfiguration _config;
 23 |         private readonly ILogger _logger;
 24 | 
 25 |         public SetSubscription(
 26 |             ITokenValidationService tokenValidationService,
 27 |             IGraphClientService graphClientService,
 28 |             IConfiguration config,
 29 |             ILoggerFactory loggerFactory)
 30 |         {
 31 |             _tokenValidationService = tokenValidationService;
 32 |             _graphClientService = graphClientService;
 33 |             _config = config;
 34 |             _logger = loggerFactory.CreateLogger<SetSubscription>();
 35 |         }
 36 | 
 37 |         [Function("SetSubscription")]
 38 |         public async Task<HttpResponseData> RunAsync(
 39 |             [HttpTrigger(AuthorizationLevel.Function, "post")] HttpRequestData req)
 40 |         {
 41 |             _logger.LogInformation("SetSubscription function triggered.");
 42 | 
 43 |             // Validate the bearer token
 44 |             var validationResult = await _tokenValidationService
 45 |                 .ValidateAuthorizationHeaderAsync(req);
 46 |             if (validationResult == null)
 47 |             {
 48 |                 // If token wasn't returned it isn't valid
 49 |                 return req.CreateResponse(HttpStatusCode.Unauthorized);
 50 |             }
 51 | 
 52 |             var graphClient = _graphClientService.GetAppGraphClient();
 53 |             if (graphClient == null)
 54 |             {
 55 |                 _logger.LogError("Could not create a Graph client for the app");
 56 |                 return req.CreateResponse(HttpStatusCode.InternalServerError);
 57 |             }
 58 | 
 59 |             // Get the POST body
 60 |             var payload = await req.ReadFromJsonAsync<SetSubscriptionPayload>();
 61 |             if (payload == null)
 62 |             {
 63 |                 var response = req.CreateResponse(HttpStatusCode.BadRequest);
 64 |                 response.WriteString("Invalid request payload");
 65 |                 return response;
 66 |             }
 67 | 
 68 |             if (string.Compare(payload.RequestType, "subscribe", true, CultureInfo.InvariantCulture) == 0)
 69 |             {
 70 |                 if (string.IsNullOrEmpty(payload.UserId))
 71 |                 {
 72 |                     var badRequest = req.CreateResponse(HttpStatusCode.BadRequest);
 73 |                     badRequest.WriteString("Required field 'userId' missing in payload.");
 74 |                     return badRequest;
 75 |                 }
 76 | 
 77 |                 // Get ngrok URL if set (for local development)
 78 |                 var notificationHost = _config["ngrokUrl"] ?? req.Url.Host;
 79 | 
 80 |                 // Create a new subscription object
 81 |                 var subscription = new Subscription
 82 |                 {
 83 |                     ChangeType = "created,updated",
 84 |                     NotificationUrl = $"{notificationHost}/api/Notify",
 85 |                     Resource = $"/users/{payload.UserId}/mailFolders/inbox/messages",
 86 |                     ExpirationDateTime = DateTimeOffset.UtcNow.AddDays(2),
 87 |                     ClientState = SetSubscription.ClientState
 88 |                 };
 89 | 
 90 |                 _logger.LogInformation($"Creating subscription for user ${payload.UserId}");
 91 | 
 92 |                 // POST /subscriptions
 93 |                 var createdSubscription = await graphClient.Subscriptions
 94 |                     .PostAsync(subscription);
 95 | 
 96 |                 var response = req.CreateResponse(HttpStatusCode.OK);
 97 |                 await response.WriteAsJsonAsync<Subscription?>(createdSubscription);
 98 |                 return response;
 99 |             }
100 |             else
101 |             {
102 |                 if (string.IsNullOrEmpty(payload.SubscriptionId))
103 |                 {
104 |                     var badRequest = req.CreateResponse(HttpStatusCode.BadRequest);
105 |                     badRequest.WriteString("Required field 'subscriptionId' missing in payload.");
106 |                     return badRequest;
107 |                 }
108 | 
109 |                 _logger.LogInformation($"Deleting subscription with ID {payload.SubscriptionId}");
110 | 
111 |                 // DELETE /subscriptions/subscriptionId
112 |                 await graphClient.Subscriptions[payload.SubscriptionId]
113 |                     .DeleteAsync();
114 | 
115 |                 return req.CreateResponse(HttpStatusCode.Accepted);
116 |             }
117 |         }
118 |     }
119 | }
120 | 


--------------------------------------------------------------------------------
/GraphSampleFunctions/host.json:
--------------------------------------------------------------------------------
 1 | {
 2 |     "version": "2.0",
 3 |     "logging": {
 4 |         "applicationInsights": {
 5 |             "samplingSettings": {
 6 |                 "isEnabled": true,
 7 |                 "excludedTypes": "Request"
 8 |             }
 9 |         }
10 |     }
11 | }


--------------------------------------------------------------------------------
/GraphSampleFunctions/local.settings.json:
--------------------------------------------------------------------------------
1 | {
2 |     "IsEncrypted": false,
3 |     "Values": {
4 |         "FUNCTIONS_WORKER_RUNTIME": "dotnet-isolated"
5 |     },
6 |     "Host": {
7 |         "CORS": "http://localhost:8080"
8 |     }
9 | }


--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
 1 | # MIT License
 2 | 
 3 | Copyright (c) 2023 Microsoft
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
  1 | ---
  2 | page_type: sample
  3 | description: This sample demonstrates how to use the Microsoft Graph .NET SDK to access data in Office 365 from Azure Functions.
  4 | products:
  5 | - ms-graph
  6 | - office-exchange-online
  7 | - azure-functions
  8 | languages:
  9 | - csharp
 10 | ---
 11 | 
 12 | # Microsoft Graph sample Azure Function
 13 | 
 14 | [![.NET](https://github.com/microsoftgraph/msgraph-sample-azurefunction-csharp/actions/workflows/dotnet.yml/badge.svg)](https://github.com/microsoftgraph/msgraph-sample-azurefunction-csharp/actions/workflows/dotnet.yml)![License.](https://img.shields.io/badge/license-MIT-green.svg)
 15 | 
 16 | This sample demonstrates how to use the Microsoft Graph .NET SDK to access data in Office 365 from Azure Functions.
 17 | 
 18 | > **NOTE:** This sample was originally built from a tutorial published on the [Microsoft Graph tutorials](https://learn.microsoft.com/graph/tutorials) page. That tutorial has been removed.
 19 | 
 20 | ## Prerequisites
 21 | 
 22 | - [.NET SDK](https://dotnet.microsoft.com/download)
 23 | - [Azure Functions Core Tools](https://learn.microsoft.com/azure/azure-functions/functions-run-local)
 24 | - [ngrok](https://ngrok.com/)
 25 | 
 26 | ## App registrations
 27 | 
 28 | This sample requires three Azure AD application registrations:
 29 | 
 30 | - An app registration for the single-page application so that it can sign in users and get tokens allowing the application to call the Azure Function.
 31 | - An app registration for the Azure Function that allows it to use the [on-behalf-of flow](https://learn.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow) to exchange the token sent by the SPA for a token that will allow it to call Microsoft Graph.
 32 | - An app registration for the Azure Function webhook that allows it to use the [client credential flow](https://learn.microsoft.com/azure/active-directory/develop/v2-oauth2-client-creds-grant-flow) to call Microsoft Graph without a user.
 33 | 
 34 | > **NOTE**
 35 | > This example requires three app registrations because it is implementing both the on-behalf-of flow and the client credential flow. If your Azure Function only uses one of these flows, you would only need to create the app registrations that correspond to that flow.
 36 | 
 37 | 1. Open a browser and navigate to the [Azure Active Directory admin center](https://aad.portal.azure.com) and login using an Microsoft 365 tenant organization admin.
 38 | 
 39 | 1. Select **Azure Active Directory** in the left-hand navigation, then select **App registrations** under **Manage**.
 40 | 
 41 | ### Register an app for the single-page application
 42 | 
 43 | 1. Select **New registration**. On the **Register an application** page, set the values as follows.
 44 | 
 45 |     - Set **Name** to `Graph Azure Function Test App`.
 46 |     - Set **Supported account types** to **Accounts in this organizational directory only**.
 47 |     - Under **Redirect URI**, change the dropdown to **Single-page application (SPA)** and set the value to `http://localhost:8080`.
 48 | 
 49 | 1. Select **Register**. On the **Graph Azure Function Test App** page, copy the values of the **Application (client) ID** and **Directory (tenant) ID** and save them, you will need them in the later steps.
 50 | 
 51 | ### Register an app for the Azure Function
 52 | 
 53 | 1. Return to **App Registrations**, and select **New registration**. On the **Register an application** page, set the values as follows.
 54 | 
 55 |     - Set **Name** to `Graph Azure Function`.
 56 |     - Set **Supported account types** to **Accounts in this organizational directory only**.
 57 |     - Leave **Redirect URI** blank.
 58 | 
 59 | 1. Select **Register**. On the **Graph Azure Function** page, copy the value of the **Application (client) ID** and save it, you will need it in the next step.
 60 | 
 61 | 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 select **Add**.
 62 | 
 63 | 1. Copy the client secret value before you leave this page. You will need it in the next step.
 64 | 
 65 |     > **IMPORTANT**
 66 |     > This client secret is never shown again, so make sure you copy it now.
 67 | 
 68 | 1. Select **API Permissions** under **Manage**. Choose **Add a permission**.
 69 | 
 70 | 1. Select **Microsoft Graph**, then **Delegated Permissions**. Add **Mail.Read** and select **Add permissions**.
 71 | 
 72 | 1. Select **Expose an API** under **Manage**, then choose **Add a scope**.
 73 | 
 74 | 1. Accept the default **Application ID URI** and choose **Save and continue**.
 75 | 
 76 | 1. Fill in the **Add a scope** form as follows:
 77 | 
 78 |     - **Scope name:** Mail.Read
 79 |     - **Who can consent?:** Admins and users
 80 |     - **Admin consent display name:** Read all users' inboxes
 81 |     - **Admin consent description:** Allows the app to read all users' inboxes
 82 |     - **User consent display name:** Read your inbox
 83 |     - **User consent description:** Allows the app to read your inbox
 84 |     - **State:** Enabled
 85 | 
 86 | 1. Select **Add scope**.
 87 | 
 88 | 1. Copy the new scope, you'll need it in later steps.
 89 | 
 90 | 1. Select **Manifest** under **Manage**.
 91 | 
 92 | 1. Locate `knownClientApplications` in the manifest, and replace it's current value of `[]` with `["TEST_APP_ID"]`, where `TEST_APP_ID` is the application ID of the **Graph Azure Function Test App** app registration. Select **Save**.
 93 | 
 94 | > **NOTE**
 95 | > Adding the test application's app ID to the `knownClientApplications` property in the Azure Function's manifest allows the test application to trigger a [combined consent flow](https://learn.microsoft.com/azure/active-directory/develop/v2-oauth2-on-behalf-of-flow#default-and-combined-consent). This is necessary for the on-behalf-of flow to work.
 96 | 
 97 | ### Add Azure Function scope to test application registration
 98 | 
 99 | 1. Return to the **Graph Azure Function Test App** registration, and select **API Permissions** under **Manage**. Select **Add a permission**.
100 | 
101 | 1. Select **My APIs**, then select **Load more**. Select **Graph Azure Function**.
102 | 
103 | 1. Select the **Mail.Read** permission, then select **Add permissions**.
104 | 
105 | 1. In the **Configured permissions**, remove the **User.Read** permission under **Microsoft Graph** by selecting the **...** to the right of the permission and selecting **Remove permission**. Select **Yes, remove** to confirm.
106 | 
107 | ### Register an app for the Azure Function webhook
108 | 
109 | 1. Return to **App Registrations**, and select **New registration**. On the **Register an application** page, set the values as follows.
110 | 
111 |     - Set **Name** to `Graph Azure Function Webhook`.
112 |     - Set **Supported account types** to **Accounts in this organizational directory only**.
113 |     - Leave **Redirect URI** blank.
114 | 
115 | 1. Select **Register**. On the **Graph Azure Function webhook** page, copy the value of the **Application (client) ID** and save it, you will need it in the next step.
116 | 
117 | 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 select **Add**.
118 | 
119 | 1. Copy the client secret value before you leave this page. You will need it in the next step.
120 | 
121 | 1. Select **API Permissions** under **Manage**. Choose **Add a permission**.
122 | 
123 | 1. Select **Microsoft Graph**, then **Application Permissions**. Add **User.Read.All** and **Mail.Read**, then select **Add permissions**.
124 | 
125 | 1. In the **Configured permissions**, remove the delegated **User.Read** permission under **Microsoft Graph** by selecting the **...** to the right of the permission and selecting **Remove permission**. Select **Yes, remove** to confirm.
126 | 
127 | 1. Select the **Grant admin consent for...** button, then select **Yes** to grant admin consent for the configured application permissions. The **Status** column in the **Configured permissions** table changes to **Granted for ...**.
128 | 
129 | ## Configure the sample
130 | 
131 | 1. Run ngrok using the following command. (Only required if using the change notification webhook portion of the sample)
132 | 
133 |     ```bash
134 |     ngrok http 7071
135 |     ```
136 | 
137 | 1. Rename [config.example.js](/TestClient/config.example.js) to **config.js** and replace the following values:
138 | 
139 |     - `YOUR_TEST_APP_CLIENT_ID_HERE` - replace with the client ID for **Graph Azure Function Test App**
140 |     - `YOUR_TENANT_ID_HERE` - replace with your tenant ID
141 |     - `YOUR_AZURE_FUNCTION_CLIENT_ID_HERE` - replace with the client ID for **Graph Azure Function**
142 | 
143 | 1. Use `dotnet user-secrets set` in the **GraphSampleFunctions** directory to set the following values.
144 | 
145 |     - apiClientId - the client ID for **Graph Azure Function**
146 |     - apiClientSecret - the client secret for **Graph Azure Function**
147 |     - ngrokUrl - your ngrok URL (copy from ngrok output)
148 |     - tenantId - your tenant ID
149 |     - webhookClientId - the client ID for **Graph Azure Function Webhook**
150 |     - webhookClientSecret - the client secret for **Graph Azure Function Webhook**
151 | 
152 | > **NOTE**
153 | > If you restart ngrok, you will need to update the `ngrokUrl` value in user secrets with the new ngrok URL and restart the Azure Function project.
154 | 
155 | ## Run the sample
156 | 
157 | The following command (run in the **GraphSampleFunctions** directory) will start the Azure Function project locally on your machine.
158 | 
159 | ```bash
160 | func start
161 | ```
162 | 
163 | To serve the test client, run your favorite command-line HTTP server in the **TestClient** directory. For example, you can use [dotnet-serve](https://github.com/natemcmaster/dotnet-serve).
164 | 
165 | ```bash
166 | dotnet serve -h "Cache-Control: no-cache, no-store, must-revalidate" -p 8080
167 | ```
168 | 
169 | Open your browser to `http://localhost:8080` and sign in with a user in your tenant.
170 | 
171 | ## Code of conduct
172 | 
173 | This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
174 | 
175 | ## Disclaimer
176 | 
177 | **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.**
178 | 


--------------------------------------------------------------------------------
/TestClient/auth.js:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation.
 2 | // Licensed under the MIT License.
 3 | 
 4 | // Create the main MSAL instance
 5 | // configuration parameters are located in config.js
 6 | const msalClient = new msal.PublicClientApplication(msalConfig);
 7 | 
 8 | async function signIn() {
 9 |   // Login
10 |   try {
11 |     // Use MSAL to login
12 |     const authResult = await msalClient.loginPopup(msalRequest);
13 |     // Save the account username, needed for token acquisition
14 |     sessionStorage.setItem('msal-userName', authResult.account.username);
15 |     // Refresh home page
16 |     updatePage(Views.home);
17 |   } catch (error) {
18 |     console.log(error);
19 |     updatePage(Views.error, {
20 |       message: 'Error logging in',
21 |       debug: error
22 |     });
23 |   }
24 | }
25 | 
26 | function signOut() {
27 |   account = null;
28 |   sessionStorage.removeItem('msal-userName');
29 |   msalClient.logout();
30 | }
31 | 
32 | async function getToken() {
33 |   let account = sessionStorage.getItem('msal-userName');
34 |   if (!account){
35 |     throw new Error(
36 |       'User account missing from session. Please sign out and sign in again.');
37 |   }
38 | 
39 |   try {
40 |     // First, attempt to get the token silently
41 |     const silentRequest = {
42 |       scopes: msalRequest.scopes,
43 |       account: msalClient.getAccountByUsername(account)
44 |     };
45 | 
46 |     const silentResult = await msalClient.acquireTokenSilent(silentRequest);
47 |     return silentResult.accessToken;
48 |   } catch (silentError) {
49 |     // If silent requests fails with InteractionRequiredAuthError,
50 |     // attempt to get the token interactively
51 |     if (silentError instanceof msal.InteractionRequiredAuthError) {
52 |       const interactiveResult = await msalClient.acquireTokenPopup(msalRequest);
53 |       return interactiveResult.accessToken;
54 |     } else {
55 |       throw silentError;
56 |     }
57 |   }
58 | }
59 | 


--------------------------------------------------------------------------------
/TestClient/azurefunctions.js:
--------------------------------------------------------------------------------
  1 | // Copyright (c) Microsoft Corporation.
  2 | // Licensed under the MIT License.
  3 | 
  4 | async function getLatestMessage() {
  5 |   const token = await getToken();
  6 |   if (!token) {
  7 |     updatePage(Views.error, {
  8 |       message: 'Could not retrieve token for user'
  9 |     });
 10 |     return;
 11 |   }
 12 | 
 13 |   try {
 14 |     const response = await fetch('http://localhost:7071/api/GetMyNewestMessage', {
 15 |       headers: {
 16 |         Authorization: `Bearer ${token}`
 17 |       }
 18 |     });
 19 | 
 20 |     if (response.status === 200) {
 21 |       const message = await response.json();
 22 |       updatePage(Views.message, message);
 23 |     } else if (response.status === 204) {
 24 |       updatePage(Views.message, null);
 25 |     } else {
 26 |       updatePage(Views.error, {
 27 |         message: `Error getting message: ${response.status} ${response.statusText}`
 28 |       });
 29 |     }
 30 |   } catch (error) {
 31 |     updatePage(Views.error, {
 32 |       message: 'Error getting message',
 33 |       debug: error
 34 |     });
 35 |   }
 36 | }
 37 | 
 38 | async function createSubscription()
 39 | {
 40 |   // Get the user to subscribe for
 41 |   const userId = document.getElementById('subscribe-user').value;
 42 |   if (!userId) {
 43 |     updatePage(Views.error, {
 44 |       message: 'Please provide a user ID or userPrincipalName'
 45 |     });
 46 |     return;
 47 |   }
 48 | 
 49 |   const token = await getToken();
 50 |   if (!token) {
 51 |     updatePage(Views.error, {
 52 |       message: 'Could not retrieve token for user'
 53 |     });
 54 |     return;
 55 |   }
 56 | 
 57 |   // Build the JSON payload for the subscribe request
 58 |   const payload = {
 59 |     requestType: 'subscribe',
 60 |     userId: userId
 61 |   };
 62 | 
 63 |   const response = await fetch('http://localhost:7071/api/SetSubscription', {
 64 |     method: 'POST',
 65 |     headers: {
 66 |       Authorization: `Bearer ${token}`
 67 |     },
 68 |     body: JSON.stringify(payload)
 69 |   });
 70 | 
 71 |   if (response.ok) {
 72 |     // Get the new subscription from the response
 73 |     const subscription = await response.json();
 74 | 
 75 |     // Add the new subscription to the array of subscriptions
 76 |     // in the session
 77 |     let existingSubscriptions =
 78 |       JSON.parse(sessionStorage.getItem('graph-subscriptions')) || [];
 79 | 
 80 |     existingSubscriptions.push({
 81 |       userId: userId,
 82 |       subscriptionId: subscription.id
 83 |     });
 84 | 
 85 |     sessionStorage.setItem('graph-subscriptions',
 86 |       JSON.stringify(existingSubscriptions));
 87 | 
 88 |     // Refresh the subscriptions page to display the new
 89 |     // subscription
 90 |     updatePage(Views.subscriptions);
 91 |     return;
 92 |   }
 93 | 
 94 |   updatePage(Views.error, {
 95 |     message: `Call to SetSubscription returned ${response.status}`,
 96 |     debug: response.statusText
 97 |   });
 98 | }
 99 | 
100 | async function deleteSubscription(subscriptionId) {
101 |   const token = await getToken();
102 |   if (!token) {
103 |     updatePage(Views.error, {
104 |       message: 'Could not retrieve token for user'
105 |     });
106 |     return;
107 |   }
108 | 
109 |   // Build the JSON payload for the unsubscribe request
110 |   const payload = {
111 |     requestType: 'unsubscribe',
112 |     subscriptionId: subscriptionId
113 |   };
114 | 
115 |   const response = await fetch('http://localhost:7071/api/SetSubscription', {
116 |     method: 'POST',
117 |     headers: {
118 |       Authorization: `Bearer ${token}`
119 |     },
120 |     body: JSON.stringify(payload)
121 |   });
122 | 
123 |   if (response.ok) {
124 |     // Remove the subscription from the array
125 |     let existingSubscriptions =
126 |       JSON.parse(sessionStorage.getItem('graph-subscriptions')) || [];
127 | 
128 |     const subscriptionIndex = existingSubscriptions.findIndex((item) => {
129 |       return item.subscriptionId === subscriptionId;
130 |     });
131 | 
132 |     existingSubscriptions.splice(subscriptionIndex, 1);
133 | 
134 |     sessionStorage.setItem('graph-subscriptions',
135 |       JSON.stringify(existingSubscriptions));
136 | 
137 |     // Refresh the subscriptions page
138 |     updatePage(Views.subscriptions);
139 |     return;
140 |   }
141 | 
142 |   updatePage(Views.error, {
143 |     message: `Call to SetSubscription returned ${response.status}`,
144 |     debug: response.statusText
145 |   });
146 | }
147 | 


--------------------------------------------------------------------------------
/TestClient/config.example.js:
--------------------------------------------------------------------------------
 1 | // Copyright (c) Microsoft Corporation.
 2 | // Licensed under the MIT License.
 3 | 
 4 | const msalConfig = {
 5 |   auth: {
 6 |     clientId: 'YOUR_TEST_APP_CLIENT_ID_HERE',
 7 |     authority: 'https://login.microsoftonline.com/YOUR_TENANT_ID_HERE'
 8 |   }
 9 | };
10 | 
11 | const msalRequest = {
12 |   // Scope of the Azure Function
13 |   scopes: [
14 |     'YOUR_AZURE_FUNCTION_CLIENT_ID_HERE/.default'
15 |   ]
16 | }
17 | 


--------------------------------------------------------------------------------
/TestClient/g-raph.png:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/microsoftgraph/msgraph-sample-azurefunction-csharp/8129e0ddd764f24c908dc09a3b19cad5afbe5753/TestClient/g-raph.png


--------------------------------------------------------------------------------
/TestClient/index.html:
--------------------------------------------------------------------------------
 1 | <!-- Copyright (c) Microsoft Corporation.
 2 |      Licensed under the MIT License. -->
 3 | 
 4 | <!DOCTYPE html>
 5 | <html lang="en">
 6 | <head>
 7 |   <meta charset="utf-8">
 8 |   <meta name="viewport" content="width=device-width, initial-scale=1.0, shrink-to-fit=no">
 9 |   <title>Azure Functions Graph Tutorial Test Client</title>
10 | 
11 |   <link rel="shortcut icon" href="g-raph.png">
12 |   <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/css/bootstrap.min.css"
13 |         integrity="sha384-0evHe/X+R7YkIZDRvuzKMRqM+OrBnVFBL6DOitfPri4tjfHxaWutUpFmBp4vmVor"
14 |         crossorigin="anonymous">
15 |   <link href="style.css" rel="stylesheet" type="text/css" />
16 | </head>
17 | 
18 | <body>
19 |   <nav class="navbar navbar-expand-md navbar-dark fixed-top bg-dark">
20 |     <div class="container">
21 |       <a href="/" class="navbar-brand">Azure Functions Graph Test Client</a>
22 |       <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarCollapse"
23 |         aria-controls="navbarCollapse" aria-expanded="false" aria-label="Toggle navigation">
24 |         <span class="navbar-toggler-icon"></span>
25 |       </button>
26 |       <div class="collapse navbar-collapse" id="navbarCollapse">
27 |           <ul id="authenticated-nav" class="navbar-nav me-auto flex-grow-1"></ul>
28 |           <ul class="navbar-nav">
29 |             <li class="nav-item">
30 |               <a class="btn btn-link nav-link" href="https://learn.microsoft.com/graph/overview" target="_blank">Docs</a>
31 |             </li>
32 |             <li id="account-nav" class="nav-item"></li>
33 |           </ul>
34 |       </div>
35 |     </div>
36 |   </nav>
37 | 
38 |   <main id="main-container" role="main" class="container">
39 | 
40 |   </main>
41 | 
42 |   <!-- Bootstrap -->
43 |   <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.2.0-beta1/dist/js/bootstrap.bundle.min.js"
44 |           integrity="sha384-pprn3073KE6tl6bjs2QrFaJGz5/SUsLqktiwsUTF55Jfv3qYSDhgCecCxMW52nD2"
45 |           crossorigin="anonymous"></script>
46 | 
47 |   <!-- MSAL -->
48 |   <script src="https://alcdn.msauth.net/browser/2.26.0/js/msal-browser.min.js"
49 |           integrity="sha384-VdtLJ4gW9+dszXDbJEzdUFYI+xq4hXfOGntgGlDve3qz/5WEzWjLeN1voiro74af"
50 |           crossorigin="anonymous"></script>
51 | 
52 | 
53 |   <script src="config.js"></script>
54 |   <script src="ui.js"></script>
55 |   <script src="auth.js"></script>
56 |   <script src="azurefunctions.js"></script>
57 | </body>
58 | </html>
59 | 


--------------------------------------------------------------------------------
/TestClient/style.css:
--------------------------------------------------------------------------------
1 | body {
2 |   padding-top: 70px;
3 | }
4 | 


--------------------------------------------------------------------------------
/TestClient/ui.js:
--------------------------------------------------------------------------------
  1 | // Copyright (c) Microsoft Corporation.
  2 | // Licensed under the MIT License.
  3 | 
  4 | // Select DOM elements to work with
  5 | const authenticatedNav = document.getElementById('authenticated-nav');
  6 | const accountNav = document.getElementById('account-nav');
  7 | const mainContainer = document.getElementById('main-container');
  8 | 
  9 | const Views = { error: 1, home: 2, message: 3, subscriptions: 4 };
 10 | 
 11 | // Helper function to create an element, set class, and add text
 12 | function createElement(type, className, text) {
 13 |   const element = document.createElement(type);
 14 |   element.className = className;
 15 | 
 16 |   if (text) {
 17 |     const textNode = document.createTextNode(text);
 18 |     element.appendChild(textNode);
 19 |   }
 20 | 
 21 |   return element;
 22 | }
 23 | 
 24 | // Show the navigation items that should only show if
 25 | // the user is signed in
 26 | function showAuthenticatedNav(user, view) {
 27 |   authenticatedNav.innerHTML = '';
 28 | 
 29 |   if (user) {
 30 |     // Add message link
 31 |     const messageNav = createElement('li', 'nav-item');
 32 | 
 33 |     const messageLink = createElement('button',
 34 |       `btn btn-link nav-link${view === Views.message ? ' active' : '' }`,
 35 |       'Latest Message');
 36 |     messageLink.setAttribute('onclick', 'getLatestMessage();');
 37 |     messageNav.appendChild(messageLink);
 38 | 
 39 |     authenticatedNav.appendChild(messageNav);
 40 | 
 41 |     // Add subscriptions link
 42 |     const subscriptionNav = createElement('li', 'nav-item');
 43 | 
 44 |     const subscriptionLink = createElement('button',
 45 |       `btn btn-link nav-link${view === Views.message ? ' active' : '' }`,
 46 |       'Subscriptions');
 47 |     subscriptionLink.setAttribute('onclick', `updatePage(${Views.subscriptions});`);
 48 |     subscriptionNav.appendChild(subscriptionLink);
 49 | 
 50 |     authenticatedNav.appendChild(subscriptionNav);
 51 |   }
 52 | }
 53 | 
 54 | // Show the sign in button or the dropdown to sign-out
 55 | function showAccountNav(user) {
 56 | 
 57 |   accountNav.innerHTML = '';
 58 | 
 59 |   if (user) {
 60 |     // Show the "signed-in" nav
 61 |     accountNav.className = 'nav-item dropdown';
 62 | 
 63 |     const dropdown = createElement('a', 'nav-link dropdown-toggle');
 64 |     dropdown.setAttribute('data-bs-toggle', 'dropdown');
 65 |     dropdown.setAttribute('role', 'button');
 66 |     accountNav.appendChild(dropdown);
 67 | 
 68 |     const userIcon = createElement('i',
 69 |       'far fa-user-circle fa-lg rounded-circle align-self-center');
 70 |     userIcon.style.width = '32px';
 71 |     dropdown.appendChild(userIcon);
 72 | 
 73 |     const menu = createElement('div', 'dropdown-menu dropdown-menu-end');
 74 |     accountNav.appendChild(menu);
 75 | 
 76 |     const userName = createElement('h5', 'dropdown-item-text mb-0', user);
 77 |     menu.appendChild(userName);
 78 | 
 79 |     const divider = createElement('div', 'dropdown-divider');
 80 |     menu.appendChild(divider);
 81 | 
 82 |     const signOutButton = createElement('button', 'dropdown-item', 'Sign out');
 83 |     signOutButton.setAttribute('onclick', 'signOut();');
 84 |     menu.appendChild(signOutButton);
 85 |   } else {
 86 |     // Show a "sign in" button
 87 |     accountNav.className = 'nav-item';
 88 | 
 89 |     const signInButton = createElement('button', 'btn btn-link nav-link', 'Sign in');
 90 |     signInButton.setAttribute('onclick', 'signIn();');
 91 |     accountNav.appendChild(signInButton);
 92 |   }
 93 | }
 94 | 
 95 | // Renders the home view
 96 | function showWelcomeMessage(user) {
 97 |   // Create jumbotron
 98 |   const jumbotron = createElement('div', 'p-5 mb-4 bg-light rounded-5')
 99 | 
100 |   const jumbotronContainer = createElement('div', 'container-fluid py-5');
101 |   jumbotron.appendChild(jumbotronContainer);
102 | 
103 |   const heading = createElement('h1', null, 'Azure Functions Graph Tutorial Test Client');
104 |   jumbotronContainer.appendChild(heading);
105 | 
106 |   const lead = createElement('p', 'lead',
107 |     'This sample app is used to test the Azure Functions in the Azure Functions Graph Tutorial');
108 |     jumbotronContainer.appendChild(lead);
109 | 
110 |   if (user) {
111 |     // Welcome the user by name
112 |     const welcomeMessage = createElement('h4', null, `Welcome ${user}!`);
113 |     jumbotronContainer.appendChild(welcomeMessage);
114 | 
115 |     const callToAction = createElement('p', null,
116 |       'Use the navigation bar at the top of the page to get started.');
117 |       jumbotronContainer.appendChild(callToAction);
118 |   } else {
119 |     // Show a sign in button in the jumbotron
120 |     const signInButton = createElement('button', 'btn btn-primary btn-large',
121 |       'Click here to sign in');
122 |     signInButton.setAttribute('onclick', 'signIn();')
123 |     jumbotronContainer.appendChild(signInButton);
124 |   }
125 | 
126 |   mainContainer.innerHTML = '';
127 |   mainContainer.appendChild(jumbotron);
128 | }
129 | 
130 | // Renders an email message
131 | function showLatestMessage(message) {
132 |   if (!message) {
133 |     const noMessage = createElement('h1', 'mt-3', 'No messages in your inbox');
134 | 
135 |     mainContainer.innerHTML = '';
136 |     mainContainer.appendChild(noMessage);
137 |     return;
138 |   }
139 | 
140 |   // Show message
141 |   const messageCard = createElement('div', 'card');
142 | 
143 |   const cardBody = createElement('div', 'card-body');
144 |   messageCard.appendChild(cardBody);
145 | 
146 |   const subject = createElement('h1', 'card-title', `${message.subject || '(No subject)'}`);
147 |   cardBody.appendChild(subject);
148 | 
149 |   const fromLine = createElement('div', 'd-flex');
150 |   cardBody.appendChild(fromLine);
151 | 
152 |   const fromLabel = createElement('div', 'me-3');
153 |   fromLabel.appendChild(createElement('strong', '', 'From:'));
154 |   fromLine.appendChild(fromLabel);
155 | 
156 |   fromLine.appendChild(createElement('div', '', message.from.emailAddress.name));
157 | 
158 |   const receivedLine = createElement('div', 'd-flex');
159 |   cardBody.appendChild(receivedLine);
160 | 
161 |   const receivedLabel = createElement('div', 'me-3');
162 |   receivedLabel.appendChild(createElement('strong', '', 'Received:'));
163 |   receivedLine.appendChild(receivedLabel);
164 | 
165 |   receivedLine.appendChild(createElement('div', '', message.receivedDateTime));
166 | 
167 |   mainContainer.innerHTML = '';
168 |   mainContainer.appendChild(messageCard);
169 | }
170 | 
171 | // Renders current subscriptions from the session, and allows the user
172 | // to add new subscriptions
173 | function showSubscriptions() {
174 |   const subscriptions = JSON.parse(sessionStorage.getItem('graph-subscriptions'));
175 | 
176 |   // Show new subscription form
177 |   const form = createElement('form', 'form-inline mb-3');
178 | 
179 |   const userInput = createElement('input', 'form-control mb-2 me-2 flex-grow-1');
180 |   userInput.setAttribute('id', 'subscribe-user');
181 |   userInput.setAttribute('type', 'text');
182 |   userInput.setAttribute('placeholder', 'User to subscribe to (user ID or UPN)');
183 |   form.appendChild(userInput);
184 | 
185 |   const subscribeButton = createElement('button', 'btn btn-primary mb-2', 'Subscribe');
186 |   subscribeButton.setAttribute('type', 'button');
187 |   subscribeButton.setAttribute('onclick', 'createSubscription();');
188 |   form.appendChild(subscribeButton);
189 | 
190 |   const card = createElement('div', 'card');
191 | 
192 |   const cardBody = createElement('div', 'card-body');
193 |   card.appendChild(cardBody);
194 | 
195 |   cardBody.appendChild(createElement('h2', 'card-title mb-4', 'Existing subscriptions'));
196 | 
197 |   const subscriptionTable = createElement('table', 'table');
198 |   cardBody.appendChild(subscriptionTable);
199 | 
200 |   const thead = createElement('thead', '');
201 |   subscriptionTable.appendChild(thead);
202 | 
203 |   const theadRow = createElement('tr', '');
204 |   thead.appendChild(theadRow);
205 | 
206 |   theadRow.appendChild(createElement('th', ''));
207 |   theadRow.appendChild(createElement('th', '', 'User'));
208 |   theadRow.appendChild(createElement('th', '', 'Subscription ID'))
209 | 
210 |   if (subscriptions) {
211 |     // List subscriptions
212 |     for (const subscription of subscriptions) {
213 |       const row = createElement('tr', '');
214 |       subscriptionTable.appendChild(row);
215 | 
216 |       const deleteButtonCell = createElement('td', 'py-2');
217 |       row.appendChild(deleteButtonCell);
218 | 
219 |       const deleteButton = createElement('button', 'btn btn-sm btn-outline-primary', 'Delete');
220 |       deleteButton.setAttribute('onclick', `deleteSubscription("${subscription.subscriptionId}");`);
221 |       deleteButtonCell.appendChild(deleteButton);
222 | 
223 |       row.appendChild(createElement('td', '', subscription.userId));
224 |       row.appendChild(createElement('td', '', subscription.subscriptionId));
225 |     }
226 |   }
227 | 
228 |   mainContainer.innerHTML = '';
229 |   mainContainer.appendChild(form);
230 |   mainContainer.appendChild(card);
231 | }
232 | 
233 | // Renders an error
234 | function showError(error) {
235 |   const alert = createElement('div', 'alert alert-danger');
236 | 
237 |   const message = createElement('p', 'mb-3', error.message);
238 |   alert.appendChild(message);
239 | 
240 |   if (error.debug)
241 |   {
242 |     const pre = createElement('pre', 'alert-pre border bg-light p-2');
243 |     alert.appendChild(pre);
244 | 
245 |     const code = createElement('code', 'text-break text-wrap',
246 |       JSON.stringify(error.debug, null, 2));
247 |     pre.appendChild(code);
248 |   }
249 | 
250 |   mainContainer.innerHTML = '';
251 |   mainContainer.appendChild(alert);
252 | }
253 | 
254 | // Re-renders the page with the selected view
255 | function updatePage(view, data) {
256 |   if (!view) {
257 |     view = Views.home;
258 |   }
259 | 
260 |   // Get the user name from the session
261 |   const user = sessionStorage.getItem('msal-userName');
262 |   if (!user && view !== Views.error)
263 |   {
264 |     view = Views.home;
265 |   }
266 | 
267 |   showAccountNav(user);
268 |   showAuthenticatedNav(user, view);
269 | 
270 |   switch (view) {
271 |     case Views.error:
272 |       showError(data);
273 |       break;
274 |     case Views.home:
275 |       showWelcomeMessage(user);
276 |       break;
277 |     case Views.message:
278 |       showLatestMessage(data);
279 |       break;
280 |     case Views.subscriptions:
281 |       showSubscriptions();
282 |       break;
283 |   }
284 | }
285 | 
286 | updatePage(Views.home);
287 | 


--------------------------------------------------------------------------------