page_type	sample
description	This sample demonstrates how to use the Microsoft Graph .NET SDK to access data in Office 365 from ASP.NET Core apps.
products	ms-graph office-exchange-online
languages	csharp aspx-csharp

Microsoft Graph sample ASP.NET Core app

This sample demonstrates how to use the Microsoft Graph .NET SDK to access data in Office 365 from ASP.NET Core apps.

Note

This sample was originally built from a tutorial published on the Microsoft Graph tutorials page. That tutorial has been removed.

Prerequisites

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

• The .NET Core SDK installed on your development machine.
• Either a personal Microsoft account with a mailbox on Outlook.com, or a Microsoft work or school account.

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

• You can sign up for a new personal Microsoft account.
• You can sign up for the Microsoft 365 Developer Program to get a free Office 365 subscription.

Register a web application with the Azure Active Directory admin center

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

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

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

   • Set Name to ASP.NET Core Graph Tutorial.
   • Set Supported account types to Accounts in any organizational directory and personal Microsoft accounts.
   • Under Redirect URI, set the first drop-down to Web and set the value to https://localhost:5001/.

4. Select Register. On the ASP.NET Core Graph Tutorial page, copy the value of the Application (client) ID and save it, you will need it in the next step.

5. Select Authentication under Manage. Under Redirect URIs add a URI with the value https://localhost:5001/signin-oidc.

6. Set the Logout URL to https://localhost:5001/signout-oidc.

7. Locate the Implicit grant section and enable ID tokens. Select Save.

8. 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.

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

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

Configure the sample

1. Open your command line interface (CLI) in the directory where GraphTutorial.csproj is located, and run the following commands, substituting YOUR_APP_ID with your application ID from the Azure portal, and YOUR_APP_SECRET with your application secret.

   dotnet user-secrets init
   dotnet user-secrets set"AzureAd:ClientId""YOUR_APP_ID"
   dotnet user-secrets set"AzureAd:ClientSecret""YOUR_APP_SECRET"

Run the sample

In your CLI, run the following command to start the application.

dotnet run

Code of conduct

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

Disclaimer

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