Azure Functions 预览版身份验证如何实现单个端点鉴权豁免
Azure Functions 3.x 单端点排除全局内置身份验证的实现方案
当前遇到的拦截问题,本质是Azure App Service内置身份验证(EasyAuth)的执行优先级高于Azure Functions自身的鉴权逻辑——所有请求会先经过网关层的全局AAD令牌校验,才会到达Functions运行时触发函数级的authLevel校验流程,因此直接修改函数的authLevel参数完全无法绕开前置的全局认证拦截。
标准平台配置方案(无代码改造)
这是官方支持的、无需编写业务代码的实现路径,操作步骤:
- 进入对应Function App的身份验证配置页面,定位到预览版功能配套的排除路径配置项
- 将需要放开访问权限的业务端点的完整相对路径加入排除路径列表,例如目标端点路由为
/api/public-notify,则直接将该路径添加到列表中 - 配置保存生效后,所有命中排除路径的请求会直接跳过前置的AAD令牌合规校验,直接流转到Functions运行时层
- 后续鉴权逻辑完全交由Functions自身规则承接:如果需要仅保留函数调用密钥鉴权,保持该函数定义的
authLevel为Function即可;如果需要完全公开访问,将该函数的authLevel调整为Anonymous即可
配置注意:
- 排除路径采用精确匹配规则,对于带动态路由参数的端点,不要直接填入带占位符的路由模板,需确保匹配规则和实际部署后的请求路径完全一致
- 配置排除路径时不要使用宽泛的通配符,避免意外放开其他受保护的端点访问权限
灵活适配方案(适配带动态参数的路由)
如果目标端点路径包含动态参数,无法通过固定排除路径实现匹配,可以搭配URL重写规则完成适配:
- 修改Function App站点根目录
wwwroot下的web.config文件,编写入站重写规则 - 对命中目标端点特征的请求,设置跳过认证上下文校验的标记
- 需确保重写规则的执行优先级高于内置身份验证模块,避免请求被全局规则提前拦截
这种配置方式支持通过正则表达式匹配路由规则,可以覆盖更复杂的路径场景。
内容的提问来源于stack exchange,提问作者Marek Urbanowicz
相关产品推荐
相关产品推荐

