You need to enable JavaScript to run this app. Quarkus实现不同REST端点分别配置Basic Auth与Keycloak认证
优惠活动
大模型
产品
解决方案
定价
更多

Quarkus实现不同REST端点分别配置Basic Auth与Keycloak认证

配置调整方案

先清理原有配置的冲突项

  • 删掉两条泛化度为/*的重复认证规则:quarkus.http.auth.permission.authenticated.paths=/*、重复的quarkus.http.auth.permission.web.paths=/*,这类全局规则优先级会覆盖所有细粒度路径配置
  • 关闭全局Basic Auth开关quarkus.http.auth.basic,避免强制所有请求走Basic Auth逻辑
  • 修正ws路径对应的Basic Auth开启参数,原来写的quarkus.http.auth.ws.basic=true不属于Quarkus OIDC租户的合法配置项,参数格式错误会导致配置失效

分路径配置认证规则

1. /api/web/* 路径(保留原有OIDC认证逻辑)

将全局Web认证规则的匹配路径收窄,仅覆盖Web端点范围,配置如下:

# 默认OIDC租户(对应Web端点)
quarkus.oidc.tenant-id=RealmResolver
quarkus.oidc.auth-server-url=${keycloak.url}/auth/realms/${keycloak.realm}
quarkus.oidc.client-id=${keycloak.client_id}
quarkus.oidc.token-path=${keycloak.url}/auth/realms/${keycloak.realm}/protocol/openid-connect/token
quarkus.oidc.token.refresh-expired=true
quarkus.oidc.application-type=WEB_APP

# Web路径权限规则
quarkus.http.auth.permission.web.paths=/api/web/*
quarkus.http.auth.permission.web.policy=authenticated

2. /api/ws/* 路径(纯Basic Auth认证,绑定Keycloak用户源)

配置独立的命名OIDC租户,专门处理ws路径的认证请求,核心是开启租户级别的Basic Auth凭据解析能力,校验通过后自动注入SecurityIdentity:

# ws路径对应的命名OIDC租户
quarkus.oidc.ws.auth-server-url=${keycloak.url}/auth/realms/${keycloak.realm}
quarkus.oidc.ws.client-id=${keycloak.client_id}
# Hybrid类型租户同时支持Bearer Token校验、Basic Auth凭据校验
quarkus.oidc.ws.application-type=hybrid
# 关键开关:开启租户级Basic Auth能力,收到Basic Auth头时自动调用Keycloak密码模式接口校验用户
quarkus.oidc.ws.basic-auth.credentials-enabled=true

# ws路径专属权限规则
quarkus.http.auth.permission.ws.paths=/api/ws/*
quarkus.http.auth.permission.ws.policy=authenticated
# 关键绑定:指定该路径的认证流程走ws命名租户,不使用全局默认租户
quarkus.http.auth.permission.ws.tenant=ws

效果验证

  • 访问/api/ws/*路径时,只需在请求头携带Authorization: Basic <Base64编码的用户名:密码>,拦截器会自动完成Keycloak用户校验,校验通过后SecurityIdentity会自动填充对应用户的ID、所属角色、关联属性,不需要额外自定义认证逻辑
  • 访问/api/web/*路径时,仍沿用原有WEB_APP模式的OIDC认证逻辑,不受ws路径配置的影响

注意事项

  • 不要重新开启全局quarkus.http.auth.basic开关,否则所有路径都会被强制走Basic Auth解析流程,和web路径的Cookie/Bearer认证逻辑冲突
  • 权限规则不要配置超出实际端点范围的通配路径,避免不同租户的认证逻辑互相抢占匹配

内容的提问来源于stack exchange,提问作者Kai

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.28 15:15:03