auth_request

说明

`auth_request` 指令允许 NGINX 通过向指定位置发起子请求来处理认证。该位置用于处理认证请求；如果子请求返回 2xx 状态码，则授予对原始请求的访问权限。若响应不是 2xx 状态，则拒绝访问，原始请求不会被处理。 该指令可在多种上下文中使用，包括 `http`、`server` 和 `location`，便于在不同服务器配置中灵活集成。该参数期望一个单一的位置名或路径，NGINX 将使用它来执行认证检查。通常，这会是一个专门的端点，用于处理检查用户凭据或对所评估请求的访问条件的逻辑。 在使用 `auth_request` 时，必须确保子请求位置已正确配置，以根据认证结果返回正确的状态码。若需要，子请求还可以携带原始请求的头部，从而允许更复杂的认证检查（例如考虑客户端信息）。

配置示例

location /protected {
    auth_request /auth;
}

location = /auth {
    internal;
    # Authentication logic here
    if ($http_authorization = "Bearer valid_token") {
        return 200;
    }
    return 401;
}