已有数据库下，带SSO与页面级角色权限的Blazor Server App搭建咨询

一、项目初始化与基础配置 #

• 新建Blazor Server项目时选择空模板，避开自带身份认证模块，避免与现有SSO逻辑冲突。
• 在Program.cs中先注册核心依赖：数据库上下文、HttpClient（用于SSO交互）、自定义身份状态服务等。

二、SSO集成与用户身份获取 #

• 不使用Blazor自带身份验证体系，通过SSO回调机制获取用户标识：
  • 实现自定义UserIdentityService服务，用于存储从SSO拿到的用户ID、角色/组权限数据。
  • 新增SSOCallback.razor页面处理SSO回调：接收SSO返回的用户凭证，调用后端接口验证后，将用户信息存入UserIdentityService。
  • 全局路由拦截：自定义CustomRouteView组件，在路由跳转前检查用户是否完成SSO认证，未认证则直接重定向到SSO登录页。

三、现有数据库对接 #

• 用EF Core反向生成实体：针对已有的users、groups、roles、sitemap及关联表，执行脚手架命令生成实体类与DbContext：

  Scaffold-DbContext "你的数据库连接字符串" Microsoft.EntityFrameworkCore.SqlServer -OutputDir Models -Tables users,groups,roles,sitemap,user_roles,user_groups
  

• 在Program.cs注册DbContext：

  builder.Services.AddDbContext<AppDbContext>(options =>
      options.UseSqlServer(builder.Configuration.GetConnectionString("DefaultConnection")));
  

• 封装权限数据访问服务：创建IUserPermissionService接口及实现类，封装“根据用户ID查询角色/组/可访问站点地图”的逻辑，禁止页面直接操作DbContext。

四、动态导航生成 #

• 新建DynamicNavMenu.razor组件，注入IUserPermissionService与UserIdentityService：
  • 在OnInitializedAsync方法中，根据当前用户ID从数据库拉取对应的sitemap数据，过滤出用户有权限访问的节点。
  • 循环渲染个性化导航：

    <div class="top-row ps-3 navbar navbar-dark">
        <div class="container-fluid">
            <a class="navbar-brand" href="">Your App</a>
            <button title="Navigation menu" class="navbar-toggler" @onclick="ToggleNavMenu">
                <span class="navbar-toggler-icon"></span>
            </button>
        </div>
    </div>
    
    <div class="@NavMenuCssClass" @onclick="ToggleNavMenu">
        <nav class="flex-column">
            @foreach (var menu in accessibleMenus)
            {
                <NavLink class="nav-link" href="@menu.Url" Match="NavLinkMatch.All">
                    <span class="oi @menu.IconClass" aria-hidden="true"></span> @menu.MenuName
                </NavLink>
            }
        </nav>
    </div>
    

• 替换默认NavMenu组件，确保用户仅看到自身权限范围内的导航项。

五、权限控制实现 #

• 页面级权限拦截：自定义PermissionView组件，接收权限标识（角色名/组名/站点节点ID），根据用户权限决定渲染内容或跳转至无权限页面：

  @inject IUserPermissionService PermissionService
  @inject UserIdentityService IdentityService
  
  @if (PermissionService.HasAccess(IdentityService.CurrentUserId, RequiredPermission))
  {
      @ChildContent
  }
  else
  {
      <div class="alert alert-danger">无访问权限</div>
      @* 或导航至403页面：NavigationManager.NavigateTo("/403") *@
  }
  
  @code {
      [Parameter] public string RequiredPermission { get; set; }
      [Parameter] public RenderFragment ChildContent { get; set; }
  }
  

• 操作级权限控制：在按钮、功能模块上添加权限判断逻辑：

  @if (PermissionService.HasRole(IdentityService.CurrentUserId, "Admin") || 
       PermissionService.HasGroup(IdentityService.CurrentUserId, "Editor"))
  {
      <button class="btn btn-primary" @onclick="SaveContent">保存内容</button>
  }
  

• 全局权限校验：在CustomRouteView中，除了检查登录状态，还要验证当前页面是否在用户可访问站点列表中，无权限则拦截跳转。

六、测试与优化 #

• 针对不同角色/组的用户，逐一验证导航显示、页面访问、操作权限是否符合预期。
• 缓存权限数据：用户登录后，将角色、组、导航列表缓存至服务器会话内存，避免重复查询数据库。
• 添加全局异常处理：捕获SSO认证失败、数据库查询异常等场景，返回友好提示。

内容的提问来源于stack exchange，提问作者Daniel Carriveau