












针对你这个"使用外部鉴权接口 http://user.service/check 来校验请求头 Authorization" 的需求,最匹配的插件是 forward-auth。
forward-auth 插件forward-auth 插件实现的就是"经典外部认证"模型。它会将客户端的请求转发给你指定的外部鉴权服务,然后根据该服务的响应来决定是否放行请求,非常适合你已经有独立鉴权服务的场景。
它的工作流程和配置要点如下:
http://user.service/check 发起一个 HTTP 调用。request_headers 属性,你可以明确指定将客户端的 Authorization 请求头转发给鉴权服务。check 服务返回 2xx 状态码,APISIX 会认为请求合法,并将原始请求继续转发给上游后端服务。check 服务返回 非 2xx 状态码(如 401/403),APISIX 会拦截请求,并直接将鉴权服务的错误响应(或配置后的自定义信息)返回给客户端,不会将请求转发到上游。你可以通过 Admin API 或 Dashboard 在路由上启用该插件,一个核心配置示例如下:
{
"plugins": {
"forward-auth": {
"uri": "http://user.service/check",
"request_headers": ["Authorization"]
}
},
"upstream": {
"nodes": {
"your_real_upstream_host:port": 1
}
}
}
除了 forward-auth,APISIX 还有其他相关插件,但它们并非你的场景下的最优解:
openid-connect:如果 check 接口遵循标准的 OIDC 协议,这个插件是更合适的选择,它支持自省等标准流程。但如果 check 接口是自定义协议,使用 forward-auth 灵活性更高。basic-auth / key-auth:这类插件是 APISIX 内置的认证方案,需要将用户凭证(用户名/密码或 Key)预先配置在 APISIX 的 Consumer 对象中,由 APISIX 自己完成校验,而不是转发给外部服务。如果你想进一步确认 forward-auth 的配置细节,比如如何将鉴权服务返回的特定头信息(如 X-User-ID)传递给上游服务,我可以再为你展开说明。
"forward-auth": {
"_meta": {
"disable": false
},
"request_headers": [
"X-API-Key"
],
"uri": "http://youservice.ns:8080/internal/mcp/auth"
},
"serverless-pre-function": {
"functions": [
"return function(conf, ctx) local auth_header = ngx.var.http_authorization; if auth_header then local _, _, token = string.find(auth_header, '^%s*[Bb]earer%s+(.+)$'); if token then ngx.req.set_header('X-API-Key', token); end; end; end"
],
"phase": "rewrite"
}
此内容由惯性聚合(RSS阅读器)自动聚合整理,仅供阅读参考。 原文来自 — 版权归原作者所有。