Home

Awesome

Blazor.BFF.OpenIDConnect.Template

.NET NuGet Status Change log

This template can be used to create a Blazor WASM application hosted in an ASP.NET Core Web app using OpenID Connect to authenticate using the BFF security architecture. (server authentication) This removes the tokens from the browser and uses cookies with each HTTP request, response. The template also adds the required security headers as best it can for a Blazor application.

Blazor BFF OpenID Connect

Features

Other templates

Blazor BFF Azure AD

Blazor BFF Azure B2C

Using the template

install

dotnet new install Blazor.BFF.OpenIDConnect.Template

run

dotnet new blazorbffoidc -n YourCompany.Bff --HttpsPortCustom 44348

Use the -n or --name parameter to change the name of the output created. This string is also used to substitute the namespace name in the .cs file for the project.

Setup after installation

Add the OpenID Connect registration settings

"OpenIDConnectSettings": {
    "Authority": "--your-authority--",
    "ClientId": "--client ID--",
    "ClientSecret": "--client-secret (user secrets)--"
},

uninstall

dotnet new uninstall Blazor.BFF.OpenIDConnect.Template

Development

build

https://docs.microsoft.com/en-us/dotnet/core/tutorials/create-custom-template

dotnet pack -o ./publish -c Release -p:PackageVersion=3.0.4 --no-build

install developement

Locally built nupkg:

dotnet new install Blazor.BFF.OpenIDConnect.Template.3.0.4.nupkg

Local folder:

dotnet new install <PATH>

Where <PATH> is the path to the folder containing .template.config.

Credits, Used NuGet packages + ASP.NET Core 8.0 standard packages

Links

https://documentation.openiddict.com/

https://auth0.com/

https://www.keycloak.org/

https://github.com/andrewlock/NetEscapades.AspNetCore.SecurityHeaders

https://github.com/PaulHatch/semantic-version