Web 服务器与网关 / 系统课时

配置基础身份认证

配置基础身份认证

本课解决 Nginx 入口保护中的账号访问控制问题,通过 HTTP Basic Authentication 为指定资源增加身份校验,并完成密码文件创建、范围限制和 HTTPS 使用边界验证。

学习目标

  • 理解 Nginx 基础身份认证的工作流程和适用场景
  • 掌握 htpasswd 密码文件创建与 auth_basic 配置方法
  • 学会限制认证范围并验证认证失败行为

HTTP Basic Authentication 工作机制

HTTP Basic Authentication 是一种基于用户名和密码的入口认证方式。客户端访问受保护资源时,Nginx 返回 401 状态码并要求提供认证信息,认证通过后才继续处理请求。

该机制本身只负责身份校验,不负责加密传输。用户名和密码会经过 Base64 编码传输,因此必须配合 HTTPS 使用,避免凭据在网络中被截获。

创建认证文件

Nginx 不直接保存明文密码,而是读取由 htpasswd 生成的密码文件。常见文件格式为用户名和加密后的密码哈希,每次请求认证时由 Nginx 校验。

bash
htpasswd -c /etc/nginx/.htpasswd admin

预期输出

text
New password:
Re-type new password:
Adding password for user admin

首次创建文件需要使用 -c 参数,后续增加用户时不要重复使用,否则会覆盖已有账号。

bash
htpasswd /etc/nginx/.htpasswd ops

预期输出

text
Adding password for user ops

配置认证保护范围

认证通常放在需要保护的 location 中。只对管理接口、内部服务入口等敏感路径开启,避免影响公开访问内容。

nginx
server {
    listen <PORT>;
    server_name example.com;

    location /admin/ {
        auth_basic "Restricted Area";
        auth_basic_user_file /etc/nginx/.htpasswd;

        proxy_pass http://backend;
    }
}

配置生效后,访问 /admin/ 时会触发用户名密码校验,其他 location 不受影响。

验证认证结果

修改配置后需要检查语法并重新加载 Nginx。

bash
nginx -t && nginx -s reload
curl -i http://example.com/admin/

预期结果

text
HTTP/1.1 401 Unauthorized
WWW-Authenticate: Basic realm="Restricted Area"

提供正确账号后,请求会继续进入后端处理流程。

bash
curl -u admin:<PASSWORD> -i http://example.com/admin/

预期结果

text
HTTP/1.1 200 OK

常见错误处理

如果始终返回 401,需要检查密码文件路径、文件权限和用户名是否正确。如果返回认证成功但仍无法访问,应继续排查后端代理、权限控制或应用自身逻辑。

生产环境中不要将 Basic Authentication 作为唯一安全措施。对于公网管理入口,应结合 HTTPS、访问限制、审计日志和更强认证方案共同使用。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置基础身份认证

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通