.NET v7.0 Blazor Server app connected to Microsoft Graph. Used Microsoft Azure Active Directory to register Application.

This is a template for a Blazor app built using .NET v7.0 that connects to Microsoft Graph. This apps hows calendar events for one week and Email messages.

Minimal Path to Awesome 🚀

Follow the instructions to successfully run your Blazor Server app with Microsoft Graph.

1. Register an Azure Active Directory app

Every app that uses Azure AD for authentication must be registered with Azure AD. You can register app through Azure Portal or by using Azure CLI. Please follow one of the options to register your app:

Option 1: Register an app by using Azure CLI

• Install Azure CLI if you haven't already.
• Register your app on Microsoft Azure, by creating a new Azure AD app registration:
  • On macOS/Linux/in Bash

    • Open terminal and change the working directory to the root of this project
    • To make the setup script executable, run chmod +x ./setup.sh
    • To register the app, run ./setup.sh
    • When prompted, sign in with your Microsoft 365 developer sandbox account
  • On Windows/in PowerShell

    • Open PowerShell and change the working directory to the root of this project
    • To register the app, run .\setup.ps1
    • When prompted, sign in with your Microsoft 365 developer sandbox account

Option 2: Register an app through Azure Portal

• Go to Azure Portal and login with your testing account that has Application developer or administrator permissions.
• Select Azure Active Directory, and select App Registrations from the left side bar. Then select + New registration.
• Give any name to your app. For Supported account types, select Accounts in any organizational directory (Any Azure AD directory - Multitenant) and personal Microsoft accounts (e.g. Skype, Xbox).
• Set the Redirect URI drop down to Web and enter https://localhost:5001/signin-oidc. Then, select Register.
• Select Certificates & secrets tab in your registered app, and then Client secrets. Create a New client secret that never expires.

Make note of the secret's value as you'll use it in the next step. Also, navigate to Overview tab and make a note of the Application (client) ID and Directory (tenant) ID. You'll use them in the next steps.

2. Run your Blazor Server app

• Clone the Hack Together repository to your local workspace or directly download the source code.

• Update app and secret (only if in the previous step you registered your app manually)

  • Open the project folder dotner-blazor-server-app-microsoft-graph with the editor of your choice. (Visual Studio Code is recommended.)
  • Navigate to your Blazor app in your editor, and select appsettings.json file, replace:
    • "CLIENT_ID" with Secret's value
    • "CLIENT_SECRET" with Application (client) ID

• If you haven't done it previously, register a developer SSL certificate for dotnet apps. In your terminal, run the following command:

  dotnet dev-certs https --trust
  

• In your terminal, run the following command:

  dotnet run