Nginx: 配置项之access模块、auth_basic模块、auth_request模块

2024-08-24 02:28
文章标签 配置 模块 nginx request access basic auth

本文主要是介绍Nginx: 配置项之access模块、auth_basic模块、auth_request模块，希望对大家解决编程问题提供一定的参考价值，需要的开发者们随着小编来一起学习吧！

access模块

  • 用于限定特定IP或者是网段进行访问的，从而实现Nginx的一个访问权限控制
  • 这个模块，它仅能够针对IP或者网段的一个访问

1 ）指令集

1.1 allow

  • 语法结构: allow address | CIDR | UNIX | all
    • all 是放行所有
    • address 可以是 ip 地址，比如: 1.1.1.1; 还可以是网段 192.168.1.0/24 (子网掩码是24位的)
    • CIDR 和 UNIX 用的不多
  • 默认值: 无
  • 上下文: http、server、location、limit_except
  • 示例
    • allow 192.168.0.10; 只允许一个ip

1.2 deny

  • 语法结构: deny address | CIDR | UNIX | all
    • 这和 allow 完全一样
  • 默认值: 无
  • 上下文: http、server、location、limit_except
    • 也和 allow 完全一样
  • 示例
    • deny 192.168.0.0/24;

2 ）组合示例

location / {deny 192.168.1.1; # 注意这个在下面一个allow的范围之内，要先写上allow 192.168.1.0/24; # 这个范围比上面 deny 的ip范围要大allow 10.1.1.0/16;allow 2001:0db8::/32; # ipv6的写法deny all; # 除了上面的放行，其余一律拒绝
}
  • 被拒绝的服务会显示 403

auth_basic模块

  • 它是限制特定用户访问的模块，对特定的URL来说，它必须通过提供的一个用户名或者密码来进行访问
  • 这在一些应用场景中是有用的，我们可能内部有一些系统针对不同的部门提供特定访问的时候
  • 我们可能针对某一个员工的用户名来进行访问
  • 这样一个模块，其实在这样一个应用场景中是很有效的

1 ）基本功能

  • 基于HTTP Basic Authentication 协议进行用户名密码认证
  • 默认已编译进Nginx，通过 --without-http_auth_basic_module 禁用

2 ) 指令

2.1 auth_basic

  • 语法：auth_basic string | off;
    • 这里的 string 是提示框的信息
  • 默认值：auth_basic off;
  • 上下文：http、server、location、limit_except

2.2 auth_basic_user_file

  • 语法：auth_basic_user_file file;
    • 验证用户名和密码的文件，放在哪里
    • 下面会有如何生成这个密码文件
  • 默认值：-
  • 上下文：http、server、location、limit_except

3 ）生成密码文件工具

  • 可执行程序： htpasswd
  • 所属软件包：httpd-tools
  • 生成新的密码文件：htpasswd -bc encrypt_pass jack 123456
    • -c 是第一次添加时，后续不需要
    • encrypt_pass 是文件名
  • 添加新用户密码：htpasswd -b encrypt_pass mike 123456
    • 再次执行，后面的用户名和密码会覆盖前面的

4 ）配置示例

  • 查看是否安装 which htpasswd, 没有的话，下载后本地安装
  • 先安装依赖：$ yum install apr apr-util
  • $ rpm -ivh httpd-tools-2.4.6-90.el7.centos.x86_64.rpm 这个是本地已有的包
  • 安装成功后，查看里面有哪些文件 $ rpm -ql httpd-tools
    /usr/bin/ab
/usr/bin/htdbm
/usr/bin/htdigest
/usr/bin/htpasswd
/usr/bin/httxt2dbm
/usr/bin/logresolve
/usr/share/doc/httpd-tools-2.4.6
/usr/share/doc/httpd-tools-2.4.6/LICENSE
/usr/share/doc/httpd-tools-2.4.6/NOTICE
/usr/share/man/man1/ab.1.gz
/usr/share/man/man1/htdbm.1.gz
/usr/share/man/man1/htdigest.1.gz
/usr/share/man/man1/htpasswd.1.gz
/usr/share/man/man1/httxt2dbm.1.gz
/usr/share/man/man1/logresolve.1.gz
    • 可以看到，其中包含：/usr/bin/htpasswd
  • 现在我们来生成文件
    • $ cd /opt/nginx/
    • $ mkdir auth
    • $ cd auth
    • $ htpasswd -b -c encrypt_pass wang 123456
      Adding password for user jack
    • $ cat encrypt_pass 查看文件，生成一串秘钥，前面是 wang:$这里跟着一串秘钥
    • $ htpasswd -b encrypt_pass lee 654321
      • 这是第二次生成，并且是一个新用户
      • 这时候会出现两个用户，不会覆盖

现在开始进行配置

{location /bbs/ {auth_basic "test user pass";auth_basic_user_file /opt/nginx/auth/encrypt_pass; # 注意，这里最好是绝对路径，防止出错root html;index index.html;}
}
  • 要保证有 /opt/nginx/html/bbs/index.html 文件
  • 按照上述的配置，访问 / 不会有任何提示
  • 访问 /bbs 路径后会有如下提示
  • 输入用户密码后，就可以访问该页面
  • 再次刷新，也不会需要要求输入密码，浏览器已经帮你记住了

auth_request

  • 它也是一个访问控制的模块，在实际的生产环境的应用还是比较多的
  • 比如，基于安全的考虑，通常会有一些鉴权的服务器
  • 当你需要访问特定的应用模块的时候，首先需要去跟这些鉴权服务器发起请求
  • 鉴权服务器再对你鉴权通过以后，才能正常的去访问我们的业务系统

1 ）功能和原理

  • 当它基于一个特定URI发起请求的时候，它会生成一个子请求
  • 这个子请求会是鉴权模块实现的一个能力
  • 这个鉴权模块，如果说对这个请求做完处理之后，会返回一个正常的HTTP的响应码
  • 它会根据 HTTP 响应码去做一定的访问控制, 比如，非 2xx 都认为是鉴权失败的
  • 参考如下图：

2 ）启用和禁用

  • 默认并没有编译进 Nginx, 通过 --with-http_auth_request_module 启用

3 ）指令

3.1 auth_request

  • 语法：auth_request uri | off；
  • 默认值：auth_request off;
  • 上下文：http、server、location

3.2 auth_request_set

  • 语法：auth_request_set $variable value；
  • 默认值：-
  • 上下文：http、server、location

4 ) 配置示例

location /private/ {auth_request /auth; # 类似于重定向
}location /auth {proxy_pass http:/127.0.0.1:8080/verify; # 反向代理，这是一个鉴权服务，返回 2xx 则鉴权成功，才会再去访问 /privateproxy_pass_request_body off;proxy_set_header Content-Length "";proxy_set_header X-Original-URI $request_uri;
}
  • 要请求 /private 的时候，会先发起对 /auth 的请求

5 ) 环境准备

  • 这里在服务器上调试一下, 准备一台服务器，Nginx 默认没有编译该模块, nginx -V 可查看到是否有该模块
  • 找到 nginx 的二进制文件删除 $ rm -rf nginx
  • 找到 configure 文件重新配置, 如下
    ./configure --prefix=/opt/nginx --conf-path=/opt/nginx/conf/nginx.conf --user=nginx--group=nginx--pid-path=/opt/nginx/pid/nginx.pid--error-log-path=/opt/nginx/logs/error.log --with-pcre=/opt/source/pcre-8.43 --with-zlib=/opt/source/zlib-1.2.11 --with-http_ssl_module --with-http image_filter_module --with-http stub_status_module --http-log-path=/opt/nginx/logs/access.log --with-http_perl_module --with-http_auth_request_module
    • 最后一个是要加入的，前面的那么多，从 nginx -V 命令输出中可以拷贝
  • 检查完，没有问题，可以用 $ make 重新编译，
  • 之后，进行安装 $ make install

6 ）配置测试

6.1 普通测试

server {listen 8080；charset utf-8;location /auth.html {return 200 "Success" # 这里模拟鉴权成功# return 403  "Failed, give the Page of Auth Server Success\n"; # 这里模拟错误的鉴权}
}

  • curl http://192.168.184.20:8080/auth.html 返回结果如下

    Success

    或者

    Failed, give the Page of Auth Server Success

  • curl curl http://192.168.184.20:8080/auth.html -I 返回

    HTTP/1.1 200 OK
Server:nginx/1.12.2
Date: Sat, 19 Oct 2019 14：51：24 GMT
Content-Type: text/html; charset=utf-8
Content-Length:44
Connection: keep-alive

    或者

    HTTP/1.1 403 Forbidden
Server:nginx/1.12.2
Date: Sat, 19 Oct 2019 14：51：24 GMT
Content-Type: text/html; charset=utf-8
Content-Length:44
Connection: keep-alive

  • 初步测试，正常

6.2 正式测试

server {listen 8080；charset utf-8;root html;location /OA/ {auth_request /auth;index index.html # 要保证有此文件, 只要鉴权成功，就会返回这个文件内容}location /auth {# 这里是模拟的鉴权接口，成功会返回 200, 失败返回 403# 如果鉴权失败，则会返回下面这个接口返回的错误信息proxy_pass  http://192.168.184.20:8080/auth.html; }
}
  • 注意，替换真实鉴权的接口
  • 整个过程实现了一个鉴权服务器

这篇关于Nginx: 配置项之access模块、auth_basic模块、auth_request模块的文章就介绍到这儿，希望我们推荐的文章对编程师们有所帮助！


http://www.chinasem.cn/article/1101184。

相关文章

检查 Nginx 是否启动的几种方法

检查 Nginx 是否启动的几种方法

《检查Nginx是否启动的几种方法》本文主要介绍了检查Nginx是否启动的几种方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学... 目录1. 使用 systemctl 命令（推荐）2. 使用 service 命令3. 检查进程是否存在4
阅读更多...
Spring配置扩展之JavaConfig的使用小结

Spring配置扩展之JavaConfig的使用小结

《Spring配置扩展之JavaConfig的使用小结》JavaConfig是Spring框架中基于纯Java代码的配置方式,用于替代传统的XML配置,通过注解（如@Bean）定义Spring容器的组... 目录JavaConfig 的概念什么是JavaConfig？为什么使用 JavaConfig？Jav
阅读更多...
Spring Boot Interceptor的原理、配置、顺序控制及与Filter的关键区别对比分析

Spring Boot Interceptor的原理、配置、顺序控制及与Filter的关键区别对比分析

《SpringBootInterceptor的原理、配置、顺序控制及与Filter的关键区别对比分析》本文主要介绍了SpringBoot中的拦截器（Interceptor）及其与过滤器（Filt... 目录前言一、核心功能二、拦截器的实现2.1 定义自定义拦截器2.2 注册拦截器三、多拦截器的执行顺序四、过
阅读更多...
springboot的controller中如何获取applicatim.yml的配置值

springboot的controller中如何获取applicatim.yml的配置值

《springboot的controller中如何获取applicatim.yml的配置值》本文介绍了在SpringBoot的Controller中获取application.yml配置值的四种方式,... 目录1. 使用@Value注解（最常用）application.yml 配置Controller 中
阅读更多...
springboot中配置logback-spring.xml的方法

springboot中配置logback-spring.xml的方法

《springboot中配置logback-spring.xml的方法》文章介绍了如何在SpringBoot项目中配置logback-spring.xml文件来进行日志管理,包括如何定义日志输出方式、... 目录一、在src/main/resources目录下，也就是在classpath路径下创建logba
阅读更多...
C++多线程开发环境配置方法

C++多线程开发环境配置方法

《C++多线程开发环境配置方法》文章详细介绍了如何在Windows上安装MinGW-w64和VSCode,并配置环境变量和编译任务,使用VSCode创建一个C++多线程测试项目,并通过配置tasks.... 目录下载安装 MinGW-w64下载安装VS code创建测试项目配置编译任务创建 tasks.js
阅读更多...
Nginx概念、架构、配置与虚拟主机实战操作指南

Nginx概念、架构、配置与虚拟主机实战操作指南

《Nginx概念、架构、配置与虚拟主机实战操作指南》Nginx是一个高性能的HTTP服务器、反向代理服务器、负载均衡器和IMAP/POP3/SMTP代理服务器,它支持高并发连接,资源占用低,功能全面且... 目录Nginx 深度解析：概念、架构、配置与虚拟主机实战一、Nginx 的概念二、Nginx 的特点
阅读更多...
2025最新版Android Studio安装及组件配置教程(SDK、JDK、Gradle)

2025最新版Android Studio安装及组件配置教程(SDK、JDK、Gradle)

《2025最新版AndroidStudio安装及组件配置教程(SDK、JDK、Gradle)》：本文主要介绍2025最新版AndroidStudio安装及组件配置(SDK、JDK、Gradle... 目录原生 android 简介Android Studio必备组件一、Android Studio安装二、A
阅读更多...
Nginx内置变量应用场景分析

Nginx内置变量应用场景分析

《Nginx内置变量应用场景分析》Nginx内置变量速查表,涵盖请求URI、客户端信息、服务器信息、文件路径、响应与性能等类别,这篇文章给大家介绍Nginx内置变量应用场景分析,感兴趣的朋友跟随小编一... 目录1. Nginx 内置变量速查表2. 核心变量详解与应用场景3. 实际应用举例4. 注意事项Ng
阅读更多...
Python AST 模块实战演示

Python AST 模块实战演示

《PythonAST模块实战演示》Python的ast模块提供了一种处理Python代码的强大工具,通过解析代码生成抽象语法树（AST）,可以进行代码分析、修改和生成,接下来通过本文给大家介绍Py... 目录 什么是抽象语法树（AST）️ ast 模块的核心用法1. 解析代码生成 AST2. 查看 AST
阅读更多...

Copyright China编程 23002807@qq.com

沪ICP备2023033072号-2