【Azure Developer】.NET 10 搭建登录认证示例(续):接入中国区 Microsoft Entra ID

在上一篇 【Azure Developer】.NET 10搭建登录认证示例(Identity + JWT + Refresh Token) 中,使用本地账户登录。这次在同一个项目里加一个入口:用中国区 Microsoft Entra ID 中已有的组织账户登录并认证授权。

本地登录仍然可用。API 和 MCP 不重写,只调整页面如何取得令牌、服务端如何验证令牌。

最终效果:一张动态图看完整流程

切换到 Entra 登录入口,再演示本地注册、登录、获取天气和退出

动态图: 首页选择登录方式 → 查看 Entra 登录入口 → 切回本地注册、登录 → 获取API数据 → 退出并重新选择登录方式。

。下文单独说明如何用真实的中国区租户完成 Entra 验证。

两条链路在 API 前汇合:

本地账户 → Identity / SQLite → 项目签发的 Access Token ──┐
                                                        ├─→ 天气 API / MCP
组织账户 → 中国区 Entra ID → Entra 签发的 Access Token ───┘

本地用户不用迁移;Entra 用户不用在项目里注册。 选择 Entra 登录时,应用不会调用本地注册或登录接口,也不会为该用户写入 AspNetUsers 或本地 RefreshTokens 表。

一:先把上一篇的项目跑起来

从包含 lbMcpJwtDemo.csproj 的目录开始。准备 .NET 10 SDK、中国区 Entra 测试租户和一个组织账户。前端新增了 MSAL 打包步骤,修改前端时还需要 Node.js LTS 和 npm。

dotnet --version
node --version
npm --version
dotnet dev-certs https --trust
dotnet run --launch-profile https

接下来只改这些地方:

文件 改什么
appsettings.json 增加 Entra 节点,不改本地 Jwt 或数据库连接
Program.cs 注册两个 JWT 验证方案,调整 /mcp 权限检查,返回两种登录来源
wwwroot/index.html、wwwroot/styles.css 给原表单加一个登录方式切换区
wwwroot/app.js、package.json 接入 MSAL,按登录来源取得 Access Token、处理退出

AuthController.cs、AppDbContext.cs、JwtTokenService.cs、TokenHasher.cs 和 WeatherTool.cs 保持不变。原来的 Jwt:Secret 继续通过开发机 User Secrets 或 Jwt__Secret 环境变量提供,不要写进源码。后端沿用已有的 JwtBearer 包,不需要引入新的认证框架。

如果手头已经是改造完成的项目,不要重复添加代码,可以直接完成第二、三节的配置,再到第六节验证。

二:在中国区 Entra 中只注册一个应用

1. 创建应用并记录两个 ID

打开 Azure 中国区门户,切换到目标租户,进入 Microsoft Entra ID → 应用注册(App registrations)→ 新注册(New registration)。

项目 填写内容
名称 *************Demo
支持的账户类型 仅此组织目录中的账户(单租户)
重定向 URI 先留空,下一步在 SPA 平台设置

注册后,在「概览」记录 目录(租户)ID 和 应用程序(客户端)ID,下文分别用 <TENANT_ID> 和 <CLIENT_ID> 表示。一个应用、一个 ClientId:浏览器用它发起登录,后端用它检查 v2 Access Token 的受众(aud)。

2. 添加 SPA 重定向地址

进同一个应用的 身份验证(Authentication)→ 添加平台 → 单页应用程序(Single-page application),保存:

https://localhost:7046/

如果这个地址先前加到了 Web,把该地址从 Web 平台移到 SPA 平台。不要为了修复浏览器登录去清空其他应用仍在使用的回调地址。

image

为什么这里是 SPA,而不是 Web?是浏览器里的 MSAL 在兑换授权码。MSAL 使用授权码流程加 PKCE:发起登录时提交 code_challenge,兑换授权码时再出示本次请求的 code_verifier。Entra 用它确认授权码与原请求匹配。PKCE 不是 MFA,也不要求在浏览器中保存 Client Secret,不要开启隐式授权。

3. 在同一个应用公开 mcp.invoke

进 公开 API(Expose an API),把 Application ID URI 设置为 api://<CLIENT_ID>,然后点击 添加范围(Add a scope):

项目 填写内容
Scope name mcp.invoke
同意显示名称 / 说明 例如「调用 MCP 工具」/「允许此应用代表登录用户调用 MCP 工具」
谁可以同意 按租户策略选择,仅管理员或管理员和用户
状态 已启用

保存后,完整范围应为 api://<CLIENT_ID>/mcp.invoke。若管理员要给这个客户端预授权,可在同页 Authorized client applications → Add a client application 中填入同一个 <CLIENT_ID>,勾选 mcp.invoke 后保存。不要为此新注册一个 API 应用,也不需要 Microsoft Graph 权限。
image-1

最后打开应用的 Manifest。在 Microsoft Graph 格式的清单里,把已有 api 对象内的 requestedAccessTokenVersion 改为 2,保留该对象里的其他属性。

{
  "api": {
    "requestedAccessTokenVersion": 2
  }
}

这段只用于定位属性,不要用它覆盖整个清单。使用 /v2.0 登录端点并不自动决定 API Access Token 的版本,还要在发布该 API 的应用上设置版本。

image-2

三:先写配置,暂时不启用 Entra

打开 appsettings.json。在现有的 "ConnectionStrings" 前插入以下片段;如果已经有 Entra 节点,就用原节点,不要添加同名项。

  "Entra": {
    "Enabled": false,
    "Instance": "https://login.partner.microsoftonline.cn/",
    "TenantId": "",
    "ClientId": "",
    "RedirectUri": "https://localhost:7046/"
  },

这个片段结尾的逗号用于分隔后面的 ConnectionStrings。原来的 Jwt:Issuer 不用改成 7046:它是本地 JWT 的签发者标识,不是站点监听地址。

Instance 用中国区的 login.partner.microsoftonline.cn。先保持 Enabled=false,把改造后的本地链路跑通,再填入租户和应用标识并启用。如果本机已有 User Secrets 或 Entra__Enabled 环境变量,也要确认最终生效的值是 false。

四:修改 Program.cs,让同一个 API 验证两类 Token

1. 读取配置并注册 JWT 验证方案

在文件顶部增加两个 using,原有的 Microsoft.AspNetCore.Authentication.JwtBearer 和 Microsoft.IdentityModel.JsonWebTokens 留着:

using Microsoft.AspNetCore.Authorization;
using Microsoft.IdentityModel.Tokens;

找到 .AddDefaultTokenProviders(); 后面的旧 builder.Services.AddAuthentication(JwtBearerDefaults.AuthenticationScheme).AddJwtBearer(...)。从 AddAuthentication 所在语句开头到它的 });,用下面整段替换。前面的 Identity/SQLite 注册和后面的 builder.Services.AddMcpServer() 不动。

const string localJwtScheme = "LocalJwt";
const string entraJwtScheme = "EntraJwt";
const string combinedJwtScheme = "CombinedJwt";

var entraEnabled = builder.Configuration.GetValue<bool>("Entra:Enabled");
var entraTenantId = builder.Configuration["Entra:TenantId"] ?? "";
var entraClientId = builder.Configuration["Entra:ClientId"] ?? "";
var entraRedirectUri = builder.Configuration["Entra:RedirectUri"] ?? "";
var entraInstance = builder.Configuration["Entra:Instance"]
    ?? "https://login.partner.microsoftonline.cn/";
var entraApiScope = string.IsNullOrWhiteSpace(entraClientId)
    ? ""
    : $"api://{entraClientId}/mcp.invoke";
var entraClientAuthority = "";
var entraValidationAuthority = "";

if (entraEnabled)
{
    foreach (var setting in new Dictionary<string, string>
    {
        ["Entra:TenantId"] = entraTenantId,
        ["Entra:ClientId"] = entraClientId,
        ["Entra:RedirectUri"] = entraRedirectUri
    })
    {
        if (string.IsNullOrWhiteSpace(setting.Value))
            throw new InvalidOperationException(
                $"{setting.Key} is required when Entra:Enabled is true.");
    }

    if (!Uri.TryCreate(entraInstance, UriKind.Absolute, out var instanceUri)
        || instanceUri.Scheme != Uri.UriSchemeHttps)
    {
        throw new InvalidOperationException(
            "Entra:Instance must be an absolute HTTPS URL.");
    }

    if (!Uri.TryCreate(entraRedirectUri, UriKind.Absolute, out var redirectUri)
        || redirectUri.Scheme != Uri.UriSchemeHttps)
    {
        throw new InvalidOperationException(
            "Entra:RedirectUri must be an absolute HTTPS URL.");
    }

    entraClientAuthority =
        $"{entraInstance.TrimEnd('/')}/{entraTenantId.TrimEnd('/')}/";
    entraValidationAuthority = $"{entraClientAuthority}v2.0";
}

var authentication = builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = combinedJwtScheme;
    options.DefaultChallengeScheme = combinedJwtScheme;
})
    .AddJwtBearer(localJwtScheme, options =>
    {
        options.MapInboundClaims = false;
        options.TokenValidationParameters = tokenService.CreateValidationParameters();
        options.TokenValidationParameters.AuthenticationType = localJwtScheme;
    });

if (entraEnabled)
{
    authentication.AddJwtBearer(entraJwtScheme, options =>
    {
        options.Authority = entraValidationAuthority;
        options.Audience = entraClientId;
        options.MapInboundClaims = false;
        options.TokenValidationParameters.AuthenticationType = entraJwtScheme;
        options.TokenValidationParameters.NameClaimType = "name";
        options.TokenValidationParameters.RoleClaimType = "roles";
        options.TokenValidationParameters.ValidAlgorithms =
            [SecurityAlgorithms.RsaSha256];
    });
}

var jsonWebTokenHandler = new JsonWebTokenHandler();

authentication.AddPolicyScheme(
    combinedJwtScheme,
    "Local or China Entra ID JWT",
    options =>
    {
        options.ForwardDefaultSelector = context =>
        {
            if (!entraEnabled)
                return localJwtScheme;

            var authorization = context.Request.Headers.Authorization.ToString();
            if (!authorization.StartsWith("Bearer ", StringComparison.OrdinalIgnoreCase))
                return localJwtScheme;

            var token = authorization["Bearer ".Length..].Trim();
            if (string.IsNullOrWhiteSpace(token) ||
                !jsonWebTokenHandler.CanReadToken(token))
            {
                return localJwtScheme;
            }

            var algorithm = jsonWebTokenHandler.ReadJsonWebToken(token).Alg;
            return string.Equals(
                    algorithm,
                    SecurityAlgorithms.RsaSha256,
                    StringComparison.Ordinal)
                ? entraJwtScheme
                : localJwtScheme;
        };
    });

这里有两个判断。if (entraEnabled) 决定是否检查 Entra 配置、是否注册 EntraJwt;ForwardDefaultSelector 决定当前请求交给哪个验证器。启用后,RS256 走 Entra,本地 HS256 走 LocalJwt。读取 alg 只为了分流,不等于验证通过。 两套验证器仍用各自的密钥、签发者、受众和有效期规则验证令牌。

2. 替换 MCP 权限检查

在 AddMcpServer() 注册之后,找到旧的 builder.Services.AddAuthorization(...)。旧代码只接受 scope=mcp:invoke,把整个授权块换成:

builder.Services.AddAuthorization(options =>
{
    options.DefaultPolicy = new AuthorizationPolicyBuilder(combinedJwtScheme)
        .RequireAuthenticatedUser()
        .Build();

    options.AddPolicy("mcp", policy =>
    {
        policy.AddAuthenticationSchemes(combinedJwtScheme);
        policy.RequireAuthenticatedUser();
        policy.RequireAssertion(context =>
            context.User.Identities.Any(identity =>
                identity.IsAuthenticated &&
                (
                    (identity.AuthenticationType == localJwtScheme &&
                     identity.HasClaim("scope", "mcp:invoke"))
                    ||
                    (identity.AuthenticationType == entraJwtScheme &&
                     identity.FindAll("scp").Any(claim =>
                         claim.Value.Split(
                                 ' ',
                                 StringSplitOptions.RemoveEmptyEntries)
                             .Contains("mcp.invoke", StringComparer.Ordinal)))
                )));
    });
});

/weatherforecast 仍使用默认策略,只要求认证成功;/mcp 在此基础上检查权限。本地令牌读 scope,Entra 令牌读 scp。后者可能包含多个空格分隔的权限,所以要拆开匹配,不能拿整串与 "mcp.invoke" 比较。AuthenticationType 由服务端验证方案设置,不取信页面传来的登录类型。

保留 app.UseAuthentication() 在 app.UseAuthorization() 前面,也保留原来的 app.MapMcp("/mcp").RequireAuthorization("mcp");。

3. 给页面提供登录配置和当前用户

在 app.MapControllers(); 后、旧 /api/auth/me 前加一个匿名端点:

app.MapGet("/api/auth/config", () => Results.Ok(new
{
    entra = new
    {
        enabled = entraEnabled,
        clientId = entraClientId,
        authority = entraClientAuthority,
        scopes = string.IsNullOrWhiteSpace(entraApiScope)
            ? []
            : new[] { entraApiScope },
        redirectUri = entraRedirectUri
    }
}));

此处不要加 .RequireAuthorization():页面还没登录就要读它。它只返回浏览器需要的公开参数,不返回 Jwt:Secret、密码或令牌。

再把旧的 app.MapGet("/api/auth/me", ...) 和它结尾的 .RequireAuthorization(); 一起替换成:

app.MapGet("/api/auth/me", (System.Security.Claims.ClaimsPrincipal user) =>
{
    var identity = user.Identities.FirstOrDefault(candidate =>
        candidate.IsAuthenticated);
    if (identity is null)
        return Results.Unauthorized();

    var isLocal = identity.AuthenticationType == localJwtScheme;
    return Results.Ok(new
    {
        provider = isLocal ? "local" : "entra",
        userId = identity.FindFirst(isLocal ? "sub" : "oid")?.Value,
        tenantId = isLocal ? null : identity.FindFirst("tid")?.Value,
        userName = identity.Name ?? identity.FindFirst("preferred_username")?.Value,
        email = identity.FindFirst("email")?.Value
    });
}).RequireAuthorization();

本地用户仍用 sub;Entra 用户用 tid(租户 ID)和 oid(目录对象 ID)组合识别。显示名和邮箱可能改变,也可能不在令牌中,不要据此合并本地与 Entra 账户。

改到这里先做一次检查: 执行 dotnet build,再用 dotnet run --launch-profile https 启动。访问 /api/auth/config 应返回 200 和 entra.enabled: false,未登录访问 /api/auth/me 应返回 401。检查完按 Ctrl+C 停止应用,再改前端。

五:在原登录页上加一个 Entra 入口

1. 添加前端项目文件

如果从上一篇的版本开始,项目根目录还没有 package.json,创建如下文件后执行 npm install,它会生成 package-lock.json。已有 package.json 和锁文件,直接用 npm ci 还原,不用再建一份。

{
  "name": "lb-mcp-jwt-demo-frontend",
  "private": true,
  "scripts": {
    "build:frontend": "esbuild ./wwwroot/app.js --bundle --format=esm --target=es2022 --outfile=./wwwroot/app.bundle.js",
    "watch:frontend": "esbuild ./wwwroot/app.js --bundle --format=esm --target=es2022 --outfile=./wwwroot/app.bundle.js --watch"
  },
  "dependencies": {
    "@azure/msal-browser": "^4.0.0"
  },
  "devDependencies": {
    "esbuild": "^0.25.0"
  }
}

先改下面的 HTML 和 JavaScript,再打包。页面加载生成的 app.bundle.js,因为浏览器不能直接解析源码里的 npm 包名 @azure/msal-browser。

2. 修改 wwwroot/index.html 和 wwwroot/styles.css

在 <head> 找到 <script src="/app.js" defer></script>,替换为:

<script type="module" src="/app.bundle.js"></script>

找到 <section id="auth-panel" ...>。在它的开头插入两个切换按钮,再用 local-method-panel 包住原来的登录/注册切换和整个 auth-form。</form> 后关闭本地面板,然后添加同级的 Entra 面板。结构如下,中间的原表单不要删:

<section id="auth-panel" aria-label="选择登录方式">
  <div class="switch method-switch" aria-label="登录方式">
    <button id="local-method-button" type="button" aria-pressed="true">本地账户</button>
    <button id="entra-method-button" type="button" aria-pressed="false" disabled>Microsoft Entra ID</button>
  </div>

  <section id="local-method-panel" aria-label="本地账户">
    <!-- 在这里保留原有登录/注册切换和 auth-form,原 ID 不变。 -->
  </section>

  <section id="entra-method-panel" aria-label="Microsoft Entra ID" hidden>
    <h2>组织账户登录</h2>
    <p id="entra-status" class="hint">正在读取中国区 Entra ID 配置。</p>
    <button id="entra-login-button" class="primary microsoft-button" type="button">
      使用中国区 Microsoft Entra ID 登录
    </button>
  </section>
</section>

再找到 account-panel 中的 <h2>你好,<span id="account-name"></span></h2>。把它下面原来写着「访问令牌有效期为 15 分钟」的段落换成:

<p id="account-provider" class="hint"></p>
<p class="hint">已通过服务器 JWT 验证。退出后可以重新选择另一种登录方式。</p>

weather-button、weather-body 和 logout-button 保留。可以把退出按钮的文字改为「退出并切换登录方式」。Entra 缓存由 MSAL 管理,旧页脚中「所有令牌只在页面内存里」的说明也要改成只针对本地 Token。

最后在 wwwroot/styles.css 加上三条规则,已有的 [hidden] 规则不用改:

.method-switch { margin-top: 28px; }
.microsoft-button { width: 100%; margin-top: 16px; }
#entra-method-panel { padding: 4px 0 8px; }

同一个登录页的本地账户与 Entra ID 入口

图 1:本地账户仍保留原有登录/注册表单。

中国区 Microsoft Entra ID 登录面板

图 2:切到 Entra 面板,只提供组织账户登录按钮,不在项目里收集组织账户的密码。

3. 修改 wwwroot/app.js:把页面选项和登录状态分开

找到文件开头的 "use strict";、element、mode、tokens 定义,替换为:

import {
  InteractionRequiredAuthError,
  PublicClientApplication
} from "@azure/msal-browser";

const element = (id) => document.getElementById(id);
const entraProviderStorageKey = "lbMcpJwtDemo.entraSignedIn";

let localMode = "login";
let loginMethod = "local";
let authProvider = null;
let localTokens = null;
let entraClient = null;
let entraConfig = null;
let entraAccount = null;

把原 setMode() 改名为 setLocalMode(),调用处一起改。原来用 mode 判断登录/注册的地方改用 localMode,包括 auth-form 提交事件里的两个 if。把 submit-button 的两种文案改为「注册本地账户」和「本地账户登录」。ApiError 和 showMessage() 保留,原来的 tokens 引用在后面逐处替换。

在 setLocalMode() 后、原 api() 前,加入前两个函数,并用下面的 clearSession() 替换旧的同名函数:

function setLoginMethod(nextMethod) {
  loginMethod = nextMethod;
  const usingLocal = loginMethod === "local";
  element("local-method-panel").hidden = !usingLocal;
  element("entra-method-panel").hidden = usingLocal;
  element("local-method-button").setAttribute("aria-pressed", String(usingLocal));
  element("entra-method-button").setAttribute("aria-pressed", String(!usingLocal));
}

function showAuthenticatedSession(user) {
  element("account-name").textContent = user.userName || "用户";
  element("account-provider").textContent =
    user.provider === "entra"
      ? `登录方式:中国区 Microsoft Entra ID${user.tenantId ? `(租户 ${user.tenantId})` : ""}`
      : "登录方式:本地账户";
  element("auth-panel").hidden = true;
  element("account-panel").hidden = false;
  element("weather-button").focus();
}

function clearSession() {
  authProvider = null;
  localTokens = null;
  entraAccount = null;
  sessionStorage.removeItem(entraProviderStorageKey);
  element("auth-panel").hidden = false;
  element("account-panel").hidden = true;
  element("account-name").textContent = "";
  element("account-provider").textContent = "";
  element("weather-body").replaceChildren();
  element("weather-results").hidden = true;
  element("password").value = "";
  setLocalMode("login");
  setLoginMethod("local");
}

loginMethod 只决定显示哪块面板;authProvider 才决定登录后用哪一套令牌。点一下 Entra 标签并不代表完成了认证。

4. 修改 wwwroot/app.js:请求 API 前选择 Access Token

接在 clearSession() 后面、api() 前面加:

function isAuthenticated() {
  return (
    (authProvider === "local" && localTokens !== null) ||
    (authProvider === "entra" && entraClient !== null && entraAccount !== null)
  );
}

async function getAccessToken() {
  if (authProvider === "local" && localTokens) {
    return localTokens.accessToken;
  }

  if (authProvider === "entra" && entraClient && entraAccount && entraConfig) {
    const result = await entraClient.acquireTokenSilent({
      scopes: entraConfig.scopes,
      account: entraAccount
    });
    return result.accessToken;
  }

  throw new ApiError("当前尚未认证,请选择一种登录方式。", 401);
}

在现有 api() 中,只替换原来从 tokens.accessToken 设置请求头的 if (authenticated),后面的 fetch 和响应处理不改。

if (authenticated) {
  headers.Authorization = `Bearer ${await getAccessToken()}`;
}

然后把原来的 perform(action) 整个替换为:

async function perform(action) {
  const buttons = [...document.querySelectorAll("button")].map((button) => ({
    button,
    wasDisabled: button.disabled
  }));
  buttons.forEach(({ button }) => { button.disabled = true; });

  try {
    await action();
  } catch (error) {
    if (error instanceof InteractionRequiredAuthError &&
        authProvider === "entra" && entraClient && entraAccount && entraConfig) {
      await entraClient.acquireTokenRedirect({
        scopes: entraConfig.scopes,
        account: entraAccount
      });
      return;
    }

    if (error instanceof ApiError && error.status === 401 && isAuthenticated()) {
      clearSession();
      showMessage("认证已失效,请重新选择登录方式。", true);
    } else {
      showMessage(error.message, true);
    }
  } finally {
    buttons.forEach(({ button, wasDisabled }) => { button.disabled = wasDisabled; });
  }
}

要重新交互登录的是 MSAL 的 InteractionRequiredAuthError,不是所有 401 或 403。另外,操作结束要还原按钮原来的状态,不能顺手把未配置时禁用的 Entra 按钮打开。

5. 修改 wwwroot/app.js:初始化 MSAL 并处理登录返回

紧接 perform()、在事件绑定前加入:

async function useEntraAccount(account) {
  entraClient.setActiveAccount(account);
  entraAccount = account;
  localTokens = null;
  authProvider = "entra";
  sessionStorage.setItem(entraProviderStorageKey, "true");

  const user = await api("/api/auth/me", { authenticated: true });
  showAuthenticatedSession(user);
  showMessage("已通过中国区 Microsoft Entra ID 验证。");
}

async function initializeAuthentication() {
  const configResponse = await api("/api/auth/config");
  entraConfig = configResponse.entra;

  if (!entraConfig.enabled) {
    element("entra-method-button").disabled = true;
    element("entra-method-button").title =
      "请先在服务端配置 Entra:Enabled 和应用注册信息";
    element("entra-status").textContent =
      "Entra ID 尚未配置;本地登录仍可正常使用。";
    showMessage("请选择本地账户登录或注册。");
    return;
  }

  entraClient = new PublicClientApplication({
    auth: {
      clientId: entraConfig.clientId,
      authority: entraConfig.authority,
      redirectUri: entraConfig.redirectUri,
      knownAuthorities: [new URL(entraConfig.authority).hostname]
    },
    cache: {
      cacheLocation: "sessionStorage",
      storeAuthStateInCookie: false
    }
  });

  await entraClient.initialize();
  const redirectResult = await entraClient.handleRedirectPromise();
  let account = redirectResult?.account ?? entraClient.getActiveAccount();

  if (!account && sessionStorage.getItem(entraProviderStorageKey) === "true") {
    const accounts = entraClient.getAllAccounts();
    if (accounts.length === 1) account = accounts[0];
  }

  element("entra-method-button").disabled = false;
  element("entra-status").textContent =
    "使用组织目录中的账户登录,浏览器采用 Authorization Code + PKCE。";

  if (account) {
    try {
      await useEntraAccount(account);
    } catch (error) {
      if (error instanceof InteractionRequiredAuthError) {
        authProvider = null;
        entraAccount = null;
        sessionStorage.removeItem(entraProviderStorageKey);
        showMessage("Entra 会话已过期,请点击 Entra ID 按钮重新登录。");
      } else {
        throw error;
      }
    }
  } else {
    showMessage("请选择本地账户或 Microsoft Entra ID 登录。");
  }
}

开关关闭就不创建 MSAL 实例,本地表单照常工作。启用后,先 initialize(),再 handleRedirectPromise()。拿到 Entra 账户后还要请求 /api/auth/me,服务端验证通过,页面才显示已登录。

6. 修改 wwwroot/app.js:绑定按钮,按来源登录和退出

在原 login-tab 和 register-tab 的事件前加:

element("local-method-button").addEventListener("click", () => setLoginMethod("local"));
element("entra-method-button").addEventListener("click", () => setLoginMethod("entra"));

保留 auth-form 中提交 /api/auth/register 的分支和它的 return。把之后从 tokens = await api("/api/auth/login", ...) 到显示登录成功的代码换成:

localTokens = await api("/api/auth/login", { body });
authProvider = "local";
entraAccount = null;
sessionStorage.removeItem(entraProviderStorageKey);

const user = await api("/api/auth/me", { authenticated: true });
element("password").value = "";
showAuthenticatedSession(user);
showMessage("已通过本地账户验证。");

在 auth-form 事件结束后、weather-button 事件前添加 Entra 按钮事件。天气渲染不改,api() 已经会带上对应的 Access Token。

element("entra-login-button").addEventListener("click", () => {
  void perform(async () => {
    if (!entraClient || !entraConfig) {
      throw new Error("Entra ID 尚未正确配置。");
    }

    await entraClient.loginRedirect({
      scopes: entraConfig.scopes,
      prompt: "select_account"
    });
  });
});

最后,替换旧 logout-button 的事件和文件末尾的 setMode("login");,不要叠加第二个退出事件:

element("logout-button").addEventListener("click", () => {
  void perform(async () => {
    if (authProvider === "entra" && entraClient && entraAccount) {
      const account = entraAccount;
      const redirectUri = entraConfig.redirectUri;
      clearSession();
      await entraClient.logoutRedirect({
        account,
        postLogoutRedirectUri: redirectUri
      });
      return;
    }

    if (authProvider === "local" && localTokens) {
      await api("/api/auth/logout", {
        body: { refreshToken: localTokens.refreshToken }
      });
    }

    clearSession();
    showMessage("已退出登录,请选择本地账户或 Microsoft Entra ID 重新登录。");
    element("local-method-button").focus();
  });
});

setLocalMode("login");
setLoginMethod("local");

void initializeAuthentication().catch((error) => {
  element("entra-method-button").disabled = true;
  element("entra-status").textContent =
    "Entra ID 初始化失败;本地登录仍可使用。";
  showMessage(`Entra ID 初始化失败:${error.message}`, true);
});

Entra 登录不走 /api/auth/login,退出也不调用本地 /api/auth/logout。反过来,本地退出只撤销自己的 Refresh Token。两种退出都不能保证已经签发的 Bearer Access Token 立即失效。

六:启动项目,验证 Entra ID 登录

本节只验证中国区 Microsoft Entra ID 登录和登录后的 API 访问,不测试本地账户。

在项目appsettings.json文件中将 <TENANT_ID> 和 <CLIENT_ID> 替换为第二节记录的值,再启用 Entra (Enabled:true)并启动应用

1. 在首页选择 Microsoft Entra ID

打开 https://localhost:7046/,选择 Microsoft Entra ID,再点 使用中国区 Microsoft Entra ID 登录。

在项目首页选择中国区 Microsoft Entra ID 登录

图 3:从项目首页进入组织账户登录。

2. 选择组织账户并登录

浏览器跳转到 Entra 的 Pick an account 页面。选择目标中国区租户里的组织账户;如果列表中没有该账户,点 Use another account,按页面提示完成登录。

在 Entra 登录页选择组织账户

图 4:直接使用已有的组织账户,无需在项目中另行注册。

3. 回到项目,确认登录成功

返回首页后,页面提示「已通过中国区 Microsoft Entra ID 验证。」并显示登录方式。也可以在浏览器开发者工具的 Network 面板检查 /api/auth/me:预期返回 200,响应中的 provider 为 entra。

通过中国区 Microsoft Entra ID 验证后返回项目

图 5:页面确认当前登录来源为中国区 Microsoft Entra ID。

4. 点击「获取天气」,查看 API 数据

点 获取天气,页面会携带为本应用申请的 Entra Access Token 调用 GET /weatherforecast。请求返回 200 后,页面显示五条天气数据。这是随机生成的演示数据,重点是确认 Entra 登录后可以访问受保护的 API。

使用 Entra 登录后查看天气 API 返回的数据

图 6:同一个 Entra 会话下,天气 API 返回数据并显示在页面上。

参考

【完】

posted @ 2026-11-21 17:59  编码者卢布  阅读(4)  评论(0)    收藏  举报