envirocar/auth-proxy

Authentication Proxy 镜像文档

镜像概述和主要用途

Authentication Proxy是一个用于HTTP BasicAuth端点的简单认证代理服务，基于Spring Boot构建，旨在为HTTP服务提供基础的身份验证代理功能，确保只有通过BasicAuth验证的请求才能访问目标端点。

核心功能和特性

• 支持HTTP BasicAuth身份验证代理
• 基于Spring Boot框架，具备良好的可扩展性和稳定性
• 可配置的日志记录和服务管理
• 支持与Nginx等反向代理服务器集成

使用场景和适用范围

适用于需要对HTTP服务进行基础身份验证保护的场景，尤其适合小型应用或内部服务，作为前置认证层控制对后端服务的访问。

使用方法和配置说明

作为服务运行

1. 主机系统调整

1. 添加系统用户auth-proxy：

   bash
   sudo adduser --system --group --no-create-home --home /opt/auth-proxy auth-proxy
   

2. 创建以下文件夹并设置所有者和组为auth-proxy：
   • /var/log/auth-proxy/（日志目录）
   • /opt/auth-proxy（应用目录）

2. 构建应用

使用Maven构建应用：

bash
mvn install

3. 部署应用

1. 将./target/目录下的*.jar文件复制到主机的/opt/auth-proxy/目录：

   bash
   sudo cp ./target/auth-proxy-0.0.1-SNAPSHOT.jar /opt/auth-proxy/
   

2. 创建指向通用名称的符号链接：

   bash
   sudo ln -sv /opt/auth-proxy/auth-proxy-0.0.1-SNAPSHOT.jar /opt/auth-proxy/auth-proxy.jar
   

4. 服务配置

1. 在/etc/init.d目录创建指向服务脚本的符号链接，名称为auth-proxy
2. 创建配置文件/opt/auth-proxy/auth-proxy.conf，内容如下：

   MODE=service
   JAVA_OPTS="-Djava.security.egd=file:/dev/./urandom"
   RUN_ARGS="--server.servlet.contextPath=/auth-proxy  --logging.file=/var/log/auth-proxy/auth-proxy.log"
   

5. 服务管理

• 测试服务状态：

  bash
  sudo /etc/init.d/auth-proxy start|status|stop
  

• 设置系统启动时自动激活服务：

  bash
  sudo update-rc.d auth-proxy defaults
  

• 重启主机后检查服务运行状态：

  bash
  sudo tail -f /var/log/auth-proxy/auth-proxy.log
  

6. 日志轮转配置

创建/etc/logrotate.d/auth-proxy文件，配置日志轮转：

/var/log/auth-proxy/auth-proxy.log {
  copytruncate
  weekly
  rotate 52
  compress
  missingok
  create 640 auth-proxy auth-proxy
}

7. Nginx代理配置

在Nginx配置文件/etc/nginx/sites-enabled/envirocar中添加以下配置（类似Docker Nginx配置）：

nginx
[...]
upstream auth-proxy {
    server 127.0.0.1:9999 fail_timeout=0;
}
[...]
location /auth-proxy {
    proxy_http_version    1.1;
    proxy_set_header      Connection "";
    proxy_set_header      X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header      Host $http_host;
    proxy_set_header      X-Forwarded-Proto https;
    proxy_redirect        off;
    proxy_connect_timeout 240;
    proxy_send_timeout    240;
    proxy_read_timeout    240;
    proxy_pass            http://auth-proxy;
}
[...]

参考文档

• Spring Boot部署文档 - initd服务
• Spring Boot部署文档 - 脚本自定义