# jasontaylordev/flexible-aspnetcore-authorization architecture

> Architecture diagram of the GitHub repository jasontaylordev/flexible-aspnetcore-authorization, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-24). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/jasontaylordev/flexible-aspnetcore-authorization
- Repository: https://github.com/jasontaylordev/flexible-aspnetcore-authorization

## Overview

##### Project type and purpose
- This is a full-stack ASP.NET Core sample application demonstrating two authorization approaches: “BasicAuth” for simple role-based auth and “FlexibleAuth” for fine-grained, permission-based policies.
- It uses Blazor WebAssembly for the client, an ASP.NET Core Web API with Identity (Entity Framework Core) on the server, and a Shared library for DTOs and common models.

##### File structure
Top-level solutions:
- BasicAuth/BasicAuth.sln
– Client (Blazor WASM)
– Server (ASP.NET Core API + Identity)
– Shared (DTOs)
- FlexibleAuth/FlexibleAuth.sln
– Client (Blazor WASM with custom authorize view)
– Server (API + Identity + custom authorization hooks)
– Shared (DTOs, custom Authorization attributes, policy providers)
Common patterns:
- Client/Pages and Shared/ components → UI layer
- Server/Controllers → API endpoints
- Server/Data → EF Core DbContext, migrations, seeders
- Shared/Authorization → extensibility points (attributes, handlers)

##### README
- Confirms focus on “Developing Flexible Authorization Capabilities with ASP.NET Core.”
- Implies comparison between a basic role-based approach and a flexible permission-based approach.

a. Main components
– Browser running Blazor WebAssembly (Client)
– ASP.NET Core API server (Server)
– SQL database for Identity and permissions (DbContext)
– Shared library (models, DTOs, auth policies)
– External OAuth/OIDC configuration endpoint (optional, via OidcConfigurationController)
b. Relationships & interactions
– User → Browser UI
– UI HTTP(S) calls → API endpoints (Authentication, User Admin, WeatherForecast)
– API ↔ Database (Identity tables, Permissions table for FlexibleAuth)
– Client retrieves OIDC metadata from server’s OidcConfigurationController
– Server’s Authorization handlers evaluate roles or permissions (BasicAuth vs. FlexibleAuth)
c. Architectural patterns
– Layered architecture (UI, API, Data, Shared)
– Separation of concerns (Client vs. Server vs. Shared)
– Extensible policy provider pattern in FlexibleAuth
d. Key technologies & frameworks
– Blazor WebAssembly, .razor pages, CustomAccountClaimsPrincipalFactory
– ASP.NET Core Identity, Entity Framework Core Migrations
– NSwag for API client generation
– Custom authorization attributes and handlers (FlexibleAuth)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% BasicAuth Solution
    subgraph "BasicAuth Solution"
        subgraph "Client (Blazor WASM)" 
            BA_UI["Blazor WASM Client"]:::ui
            BA_Claims["CustomAccountClaimsPrincipalFactory"]:::ui
            BA_Pages["Pages"]:::ui
            BA_SharedUI["Shared Components"]:::ui
        end
        subgraph "Server (ASP.NET Core API + Identity)"
            BA_API["API Services"]:::api
            BA_Controllers["Controllers (Auth, Admin, Weather)"]:::api
            BA_OIDC["OidcConfigurationController"]:::api
            BA_Data["EF Core DbContext & Seeders"]:::api
            BA_Migrations["EF Core Migrations"]:::api
            BA_IdentityUI["Identity UI (Razor Pages)"]:::api
        end
        BA_SharedLibBA["Shared DTO Library"]:::shared
    end

    %% FlexibleAuth Solution
    subgraph "FlexibleAuth Solution"
        subgraph "Client (Blazor WASM)"
            FA_UI["Blazor WASM Client"]:::ui
            FA_Claims["CustomAccountClaimsPrincipalFactory"]:::ui
            FA_FlexView["FlexibleAuthorizeView"]:::ui
            FA_Pages["Pages (Admin, etc.)"]:::ui
        end
        subgraph "Server (API + Identity + Custom Auth Hooks)"
            FA_API["API Services"]:::api
            FA_Controllers["Controllers (Auth, Admin, Weather)"]:::api
            FA_ACCtrl["AccessControlController"]:::api
            FA_OIDC["OidcConfigurationController"]:::api
            FA_Data["EF Core DbContext & Seeders"]:::api
            FA_Migrations["EF Core Migrations"]:::api
            FA_AuthHooks["Authorization Hooks (Policy Provider & Handlers)"]:::api
        end
        FA_SharedLibFA["Shared DTO & Models Library"]:::shared
        FA_SharedAuth["Shared Authorization Abstractions"]:::shared
    end

    %% External and Database
    Browser["Browser (User)"]:::ext
    DB["SQL Database (Identity & Permissions)"]:::db

    %% Relationships
    Browser -->|"interacts with UI"| BA_UI
    Browser -->|"interacts with UI"| FA_UI

    BA_UI -->|"HTTP calls to API"| BA_API
    FA_UI -->|"HTTP calls to API"| FA_API

    BA_UI -->|"uses DTOs"| BA_SharedLibBA
    BA_API -->|"uses DTOs"| BA_SharedLibBA

    FA_UI -->|"uses DTOs & models"| FA_SharedLibFA
    FA_UI -->|"uses auth abstractions"| FA_SharedAuth
    FA_API -->|"uses DTOs & models"| FA_SharedLibFA
    FA_API -->|"uses auth abstractions"| FA_SharedAuth

    BA_API -->|"reads/writes"| DB
    FA_API -->|"reads/writes"| DB

    BA_UI -->|"fetch OIDC metadata"| BA_OIDC
    FA_UI -->|"fetch OIDC metadata"| FA_OIDC

    %% Click Events BasicAuth
    click BA_UI "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Client"
    click BA_Claims "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/BasicAuth/BasicAuth/Client/Authorization/CustomAccountClaimsPrincipalFactory.cs"
    click BA_Pages "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Client/Pages"
    click BA_SharedUI "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Client/Shared"
    click BA_API "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Server"
    click BA_Controllers "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Server/Controllers"
    click BA_OIDC "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/BasicAuth/BasicAuth/Server/Controllers/OidcConfigurationController.cs"
    click BA_Data "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Server/Data"
    click BA_Migrations "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Server/Data/Migrations"
    click BA_IdentityUI "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Server/Areas/Identity"
    click BA_SharedLibBA "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/BasicAuth/BasicAuth/Shared"

    %% Click Events FlexibleAuth
    click FA_UI "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Client"
    click FA_Claims "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/FlexibleAuth/FlexibleAuth/Client/Authorization/CustomAccountClaimsPrincipalFactory.cs"
    click FA_FlexView "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/FlexibleAuth/FlexibleAuth/Client/Shared/FlexibleAuthorizeView.cs"
    click FA_Pages "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Client/Pages"
    click FA_API "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Server"
    click FA_Controllers "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Server/Controllers"
    click FA_ACCtrl "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/FlexibleAuth/FlexibleAuth/Server/Controllers/Admin/AccessControlController.cs"
    click FA_OIDC "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/blob/main/FlexibleAuth/FlexibleAuth/Server/Controllers/OidcConfigurationController.cs"
    click FA_Data "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Server/Data"
    click FA_Migrations "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Server/Data/Migrations"
    click FA_AuthHooks "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Server/Authorization"
    click FA_SharedLibFA "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Shared"
    click FA_SharedAuth "https://github.com/jasontaylordev/flexible-aspnetcore-authorization/tree/main/FlexibleAuth/FlexibleAuth/Shared/Authorization"

    %% Styles
    classDef ui fill:#E8F0FE,stroke:#1E4E8C,color:#000
    classDef api fill:#FEF3E8,stroke:#8C4E1E,color:#000
    classDef db fill:#E8F6E8,stroke:#1E8C4E,color:#000
    classDef shared fill:#F3E8FE,stroke:#4E1E8C,color:#000
    classDef ext fill:#F0F0F0,stroke:#999,color:#000
```
