blazor

Building a PhotoSharing Application with Blazor Web Assembly Hosted, Web API, gRPC and Duende Identity Server

We're going to build a simple web site where people can post pictures and comments.

• Everyone can browse existing pictures and comments.
• Only authenticated users can upload new pictures and comments.
• Only a picture owner can edit or delete a picture.
• Only a comment owner can delete or update a comment.

We are going to build 3 parts.

• The FrontEnd, a Blazor Client Web Application paired with its own ASP.NET Core Web Host.
• The Backend, built with .NET 7.0, will consist of
  • A REST service for the managing of the pictures
  • A gRPC service for the comments
• The Identity Provider will be our own Duende project.

1.1 - FrontEnd Client

• Blazor Client
• HTML 5
• CSS 3
• Open Id Connect Client

This project will interact with the user through a browser by dinamically constructing an HTML user interface and will talk its own server by using gRPC Web and HttpClient.

1.2 - Backend For Frontend (BFF)

• ASP.Net Core Web Host
• YARP
• Duende.Bff.Yarp

This project hosts and serves the Blazor Client application. It also acts as a reverse proxy to forward the calls to the REST and gRpc backends.

2.1 - Photos REST Service

• .NET 7 Web API Controller
• Entity Framework Core 7.0
• SqLite Database
• Duende Client Authentication

2.2 - Comments gRPC Service

• .NET 7 gRPC Service
• Entity Framework Core 7.0
• SqLite Database
• Duende Client Authentication

These projects will be responsible to store the data on the server and respond to the client requests through http, json and protobuf.

3. Authentication Server
   • Identity Server 4 (Duende)
   • Entity Framework Core

This project will take care of the authentication part. It will issue JWT tokens that will be used by the client application to gain access to the services.

What you already need to know:

• C#
• HTML 5
• CSS 3

What you're going to learn:

• REST
• gRPC
• Blazor
• ASP.NET Core 7.0 Web API Controller
• ASP.NET Core 7.0 gRPC Service
• Entity Framework Core 7.0
• Swagger / OpenAPI
• CORS
• YARP
• Authentication and Authorization
• OAuth 2 and Open Id Connect
• Identity Server 4 (Duende)
• Simple Authorization
• Resource Owner Authorization
• CLEAN Architecture
• Unit Testing with bUnit
• Javascript interoperability

Before you begin

At the time of the writing of this tutorial, .NET Core 7.0 can be used only with Visual Studio 2022. It is recommended that you install the latest version of Visual Studio 2022 in order to work with .NET Core 7.0.

• Install the latest version of Visual Studio 2022 with the ASP.NET and web development workload
• Install .NET Core 7.0 by downloading the .NET Core 7.0 SDK

You may want to go to the getting started documentation for an updated set of instructions.

---

Our workflow

We are going to follow some simple steps. Each step will focus on one task and will build on top of the previous step. We will start with simple projects that will become more and more complex along the way. For example, we will not focus on authentication and authorization at first. We will add it at a later step.

How to follow this tutorial

If you start from Lab01 and follow each readme.md, you can complete each lab and continue to the following one using your own code. No need to open neither the Start nor the Solution folders provided in this repo.

• Start folders are the starting points of each step.
• Solution folders are the final versions of each step, given to you just in case you want to check what your project is supposed to become at the end of each lab.

What you have to do is to open a Start folder corresponding to the lab you want to try (Lab01/Start in order to begin from scratch) and follow the instructions you find on the readme.md file. When you are done, feel free to compare your work with the solution provided in the Solution folder.

To START

1. Open the Labs folder
2. Navigate to the Lab01 subfolder
3. Navigate to the Start subfolder
4. Follow the instructions contained in the readme.md file to continue

If you want to see the final application

Create the Photos REST Service DataBase

• Open Lab15SolutionblazorPhotoSharingApplicationPhotoSharingApplication.sln in Visual Studio
• Build the Solution
• Ensure that you have multiple startup projects:
  • IdentityServer
  • Rest
  • gRPC
  • Frontend.Server

Start the application

To Logon

• Username: alice
• Password: Pass123$

Or

• Username: bob
• Password: Pass123$

One last note before we begin

I assume you're a C# programmer interested in building a web application. Depending on how old you are, you may have already used asp, aspx, mvc and / or razor pages and now you want to try blazor. You may be already familiar with HTML and CSS and maybe you even played with some javascript framwork such as Angular, React or Vue.

I am going to link a ton of documentation about web concepts and technologies, so don't worry if you're not a web developer expert, you can learn everything along the way. You should at least be fluent in C#, though, or this tutorial will be hard to follow. Most of the code that we're going to write will be, in fact, C#. We are also going to write some HTML, but that's easy to learn so that is not going to be a problem.

The Labs

• Lab 01 - The Blazor Frontend
  • Exploring the structure of a Blazor Web Assembly project and creating our first page
• Lab 02 - Frontend: Additional Views
  • CLEAN Architecture
  • Dependency Injection
  • Using additional Blazor Libraries through NuGet Packages
  • Routes
  • Data Binding
  • Event Handling
• Lab 03 - Frontend: Styling the UI with MatBlazor
  • Material Design
  • MatBlazor
  • Layout Pages
• Lab 04 - Frontend - Razor Class Libraries and Components
  • Creating a Razor Class Library
  • Using a Razor Class Library from within a project
  • Razor Components
  • Parent and Child Components
  • Properties
  • EventCallbacks
• Lab 05 - Backend: Web API with ASP.NET Core 7.0 and Visual Studio 2022
  • REST Protocol
  • Asp.NET Core Web Api
  • Controllers
  • Actions
  • Routes
  • Binding
  • Entity Framework Core
  • JSON
  • Swagger / OpenAPI
• Lab 06 - Frontend: Connecting with the Backend
  • HttpClient
  • HttpClient Configuration
  • GetFromJsonAsync
  • PostAsJsonAsync
  • PutAsJsonAsync
  • DeleteAsync
  • ReadFromJsonAsync
  • CORS
  • YARP
• Lab 07 - Frontend: Comments
  • More CLEAN architecture
  • More Components
• Lab 08 - Backend: gRPC with ASP.NET Core 7.0 and Visual Studio 2022
  • More CLEAN architecture
  • gRPC
  • protobuf
  • gRPC in Asp.Net Core
• Lab 09 - Frontend: Connecting with the Backend
  • gRPC Web
  • gRPC Client Web in .NET Core
  • Configuration
  • CORS
  • YARP
• Lab 10 - Security: Authentication and Authorization
  • Duende Identity Server
  • Configuring the REST Service for JWT Bearer Authentication
  • Configuring the gRPC Service for JWT Bearer Authentication
  • Configuring the Blazor Client for JWT Bearer Authentication
  • Simple Authorization with the Authorize Attribute
  • Retrieving and passing JWT Bearer Tokens by using the Duende.Bff.Yarp framework
• Lab 11 - Security: Resource Based Authorization
  • AuthorizationService
  • Policies
  • Requirements
  • Handlers
• Lab 12 - Performance Optimization
  • Entity Framework Table Splitting
  • Download a File from a REST Web Api Service
  • Browser Caching
• Lab 13 - Validation
  • Data Annotations
  • Fluent Validation in the Core Service
  • Fluent Validation in ASP.NET Core REST Service
  • Fluent Validation in Blazor with Blazored.FluentValidation
• Lab 14 - Unit Testing Blazor Components with bUnit
  • Unit Testing
  • Mocking
  • xUnit
  • Moq
  • bUnit
• Lab 15 - Blazor / Javascript interoperability
  • IJSRuntime
  • Call a JavaScript function in ASP.NET Core Blazor
  • Call .NET methods from JavaScript functions in ASP.NET Core Blazor
  • Blazor JavaScript isolation and object references
  • Leaflet
  • exif.js