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、访问限制、审计日志和更强认证方案共同使用。
按自己的节奏,确认真正理解。