Azure Web App认证未保护根URL问题排查求助

一、根路径不触发Auth0重定向的核心原因 #

1. Umbraco路由优先级问题：Umbraco对根路径的请求会直接返回默认首页内容，这个处理逻辑在Azure App Service的Easy Auth（门户Authentication设置）拦截之前执行。而.NET 8基础应用没有这类自定义路由拦截，所以Easy Auth能正常拦截根路径请求。
2. .NET Framework下Easy Auth的拦截顺序：Easy Auth在.NET Framework中是通过Owin中间件（对应传统HTTP模块的扩展）实现的，但Umbraco自身的Owin中间件优先级更高，导致根路径请求没走到认证拦截环节。

二、可行的解决办法 #

方法1：通过Umbraco代码强制根路径认证 #

在项目的OwinStartup.cs（或Startup.cs）中，添加针对根路径的认证校验逻辑：

app.UseUmbracoBackOfficeAuthentication();
app.UseUmbracoPreviewAuthentication();

// 给根路径加上认证拦截
app.Map("/", subApp =>
{
    subApp.Use((context, next) =>
    {
        if (!context.Authentication.User.Identity.IsAuthenticated)
        {
            context.Response.Redirect("/.auth/login/auth0");
            return Task.CompletedTask;
        }
        return next();
    });
    subApp.RunUmbracoPipeline();
});

方法2：通过Web.config添加重写规则拦截根路径 #

直接修改site/wwwroot/web.config，添加URL重写规则，检测未认证的根路径请求并强制跳转：

<system.webServer>
  <rewrite>
    <rules>
      <rule name="Force Auth for Root" stopProcessing="true">
        <match url="^$" /> <!-- 匹配根路径 -->
        <conditions>
          <!-- 检查是否有认证会话Cookie，没有则跳转 -->
          <add input="{HTTP_COOKIE}" pattern="AppServiceAuthSession" negate="true" />
        </conditions>
        <action type="Redirect" url="/.auth/login/auth0" />
      </rule>
    </rules>
  </rewrite>
</system.webServer>

三、关于认证请求的处理流程 #

Azure App Service的Easy Auth在.NET Framework应用中，是通过HTTP模块+Owin中间件的组合实现的：

• 请求先到达Azure平台层的认证拦截逻辑，检查是否存在有效认证会话；
• 未认证的请求会被重定向到Auth0完成登录，认证通过后平台会将用户信息注入HttpContext.User，再把请求转发给你的应用代码；
• 对于Umbraco这类基于Owin的应用，Umbraco自身的路由和中间件优先级高于Easy Auth的拦截逻辑，所以根路径请求会被Umbraco直接处理，绕过了认证检查——这也是为什么需要手动添加根路径的认证拦截。

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