ASP.NET Core 6.0 - SingleUser NuGet Package

Install KenHaggerty. Com. SingleUser. Net6.

• Manage NuGet Packages on the host.
• Search for kenhaggerty on the Browse tab.
• Select the Net6 version and install.

Edit the host web app's Program.cs or Startup.cs.

• Authorize the Admin folder.
• Add services.AddSingleUser();
• Add app.UseSingleUser();

Program.cs Template

// Configure Services with the WebApplicationBuilder.
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddRazorPages(options => { options.Conventions.AuthorizeFolder("/Admin"); });
builder.Services.AddSingleUser();

// Configure the HTTP request pipeline.
var app = builder.Build();
if (app.Environment.IsDevelopment())
{
    app.UseDeveloperExceptionPage();
}
else
{
    app.UseExceptionHandler("/Error");
    // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
    app.UseHsts();
}

app.UseHttpsRedirection();
app.UseStaticFiles();
app.UseRouting();

app.UseSingleUser();

app.UseAuthorization();
app.MapRazorPages();
app.Run();

Startup.cs Template

public void ConfigureServices(IServiceCollection services)
{
    services.AddRazorPage(options => { options.Conventions.AuthorizeFolder("/Admin"); });
    services.AddSingleUser();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    if (env.IsDevelopment())
    {
        app.UseDeveloperExceptionPage();
    }
    else
    {
        app.UseExceptionHandler("/Error");
        // The default HSTS value is 30 days. You may want to change this for production scenarios, see https://aka.ms/aspnetcore-hsts.
        app.UseHsts();
    }
    app.UseHttpsRedirection();
    app.UseStaticFiles();
    app.UseRouting();

    app.UseSingleUser();

    app.UseAuthorization();
    app.UseEndpoints(endpoints =>
    {
        endpoints.MapRazorPages();
    });
}

Edit the host Shared/_Layout. cshtml

@using KenHaggerty. Com. SingleUser. Net6. Models;

• Add the _SingleUserLoginPartial with the SingleUserLoginPartialModel into the host's navbar.
• SingleUserLoginPartialModel NavLinkClass defaults to "text-dark".
• Override the SingleUserLoginPartialModel NavLinkClass on initialization.

navbar-collapse with flex-sm-row-reverse

<div class="navbar-collapse collapse d-sm-inline-flex flex-sm-row-reverse">
    <partial name="_SingleUserLoginPartial"
        model='@@new SingleUserLoginPartialModel() { NavLinkClass = "text-primary fw-bold"}' />
    <ul class="navbar-nav flex-grow-1">
        <li class="nav-item">
            <a class="nav-link text-dark" asp-area="" asp-page="/Admin/Index">Admin</a>
        </li>
    </ul>
</div>

navbar-collapse with justify-content-between

<div class="navbar-collapse collapse d-sm-inline-flex justify-content-between">
    <ul class="navbar-nav flex-grow-1">
        <li class="nav-item">
            <a class="nav-link text-dark" asp-area="" asp-page="/Admin/Index">Admin</a>
        </li>
    </ul>
    <partial name="_SingleUserLoginPartial"
        model='@@new SingleUserLoginPartialModel() { NavLinkClass = "text-primary fw-bold"}' />
</div>

Password and SingleUserPageTitleClass (Optional)

For basic password support, add a SingleUserPassword key with your password to the host's appsettings. json's root. Use the SingleUserPageTitleClass option to match the host's css.

"SingleUserPassword": "Password",
"SingleUserPageTitleClass": "text-primary"

AddSingleUser Implements:

services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie(options =>
    {
        options.LoginPath = "/account/login";
        options.LogoutPath = "/account/logout";
        options.AccessDeniedPath = "/account/accessdenied";
        options.Cookie.SameSite = SameSiteMode.Strict;
        options.Cookie.SecurePolicy = CookieSecurePolicy.SameAsRequest;
        options.Cookie.IsEssential = true;
    });

UseSingleUser Implements:

app.UseAuthentication();

Page titles implement the optional SingleUserPageTitleClass:

@@page
@@using Microsoft.Extensions.Configuration
@@inject Microsoft.Extensions.Configuration.IConfiguration _config
@@model LogInModel
@@{
    ViewData["Title"] = "Log In";
    var singleUserPageTitleClass = _config.GetValue<string>("SingleUserPageTitleClass");
}
<div class="text-center border-bottom mb-1">
    <h1 class="@@(singleUserPageTitleClass ?? singleUserPageTitleClass)">@@ViewData["Title"]</<h1>
</<div>

The Login page Implements a Bootstrap checkbox with both V4 and V5 checkbox classes.

Login.cshtml:

<div class="custom-control custom-checkbox form-check">
    <input type="checkbox" class="custom-control-input form-check-input" asp-for="IsPersistent" />
    <label class="custom-control-label form-check-label" asp-for="IsPersistent">
        @@Html.DisplayNameFor(model => model.IsPersistent)
    </label>
</div>

SingleUserLoginPartialModel Implements:

namespace KenHaggerty.Com.SingleUser.Net6.Models;
public class SingleUserLoginPartialModel
{
    public string NavLinkClass { get; set; } = "text-dark";
}

_SingleUserLoginPartial.cshtml Implements:

@@model SingleUserLoginPartialModel
<ul class="navbar-nav">
    @@if (User.Identity!.IsAuthenticated)
    {
        <li class="nav-item">
            <form class="d-inline" asp-page="/Account/LogOut" method="post">
                <button type="submit" class="nav-link @@(Model!.NavLinkClass) btn btn-link pt-1">
                    Log Out @@User.Identity.Name
                </button>
            </<form>
        </<li>
    }
    else
    {
        <li class="nav-item">
            <a class="nav-link @@(Model!.NavLinkClass)" asp-page="/Account/LogIn">Log In</<a>
        </<li>
    }
</<ul>

References:

• MSDocs - Enums
• MSDocs - Working with Nullable Reference Types - DbContext and DbSet
• Getting attributes of Enum's value
• How to get next (or previous) enum value in C#
• .NET and .NET Core Support Policy