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
相关产品推荐
相关产品推荐

