【Azure Developer】.NET 10 搭建登录认证示例(续):接入中国区 Microsoft Entra ID
在上一篇 【Azure Developer】.NET 10搭建登录认证示例(Identity + JWT + Refresh Token) 中,使用本地账户登录。这次在同一个项目里加一个入口:用中国区 Microsoft Entra ID 中已有的组织账户登录并认证授权。
本地登录仍然可用。API 和 MCP 不重写,只调整页面如何取得令牌、服务端如何验证令牌。
最终效果:一张动态图看完整流程

动态图: 首页选择登录方式 → 查看 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 平台。不要为了修复浏览器登录去清空其他应用仍在使用的回调地址。

为什么这里是 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 权限。

最后打开应用的 Manifest。在 Microsoft Graph 格式的清单里,把已有 api 对象内的 requestedAccessTokenVersion 改为 2,保留该对象里的其他属性。
{
"api": {
"requestedAccessTokenVersion": 2
}
}
这段只用于定位属性,不要用它覆盖整个清单。使用 /v2.0 登录端点并不自动决定 API Access Token 的版本,还要在发布该 API 的应用上设置版本。

三:先写配置,暂时不启用 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; }

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

图 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 登录。

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

图 4:直接使用已有的组织账户,无需在项目中另行注册。
3. 回到项目,确认登录成功
返回首页后,页面提示「已通过中国区 Microsoft Entra ID 验证。」并显示登录方式。也可以在浏览器开发者工具的 Network 面板检查 /api/auth/me:预期返回 200,响应中的 provider 为 entra。

图 5:页面确认当前登录来源为中国区 Microsoft Entra ID。
4. 点击「获取天气」,查看 API 数据
点 获取天气,页面会携带为本应用申请的 Entra Access Token 调用 GET /weatherforecast。请求返回 200 后,页面显示五条天气数据。这是随机生成的演示数据,重点是确认 Entra 登录后可以访问受保护的 API。

图 6:同一个 Entra 会话下,天气 API 返回数据并显示在页面上。
参考
【完】
当在复杂的环境中面临问题,格物之道需:浊而静之徐清,安以动之徐生。 云中,恰是如此!

浙公网安备 33010602011771号