barnabassudy/saml-proxy

SAML Proxy

概述

本仓库和Docker镜像提供了一个配置有SAML认证的代理服务器，可实现基于SAML的身份验证并将请求转发至指定后端服务。

启动命令示例：

docker run -ti -p 80:80 -h auth.example.com -v -e BACKEND=https://api.example.com:8443 -e SCHEMA=http barnabassudy/saml-proxy

核心功能

• 支持SAML身份认证流程
• 可将认证后的请求代理至指定后端服务
• 自动生成或自定义SAML SP密钥、证书及元数据
• 通过环境变量配置代理主机、协议及用户属性映射

使用场景

• 需要SAML认证的企业内部服务代理
• 第三方应用与SAML身份提供商的集成
• 简化后端服务的身份验证逻辑

配置说明

端口

• 80：用于HTTP代理请求接收

环境变量

• BACKEND：必填，请求代理的目标后端地址
• PROXY_HOST：代理服务的主机名，默认使用容器主机名
• SCHEMA：代理服务的对外协议（默认https），SSL终止需外部处理
• REMOTE_USER_EMAIL_SAML_ATTRIBUTE：映射为Remote-User-Name头的SAML属性
• REMOTE_USER_NAME_SAML_ATTRIBUTE：映射为Remote-User-Email头的SAML属性
• REMOTE_USER_PREFERRED_USERNAME_SAML_ATTRIBUTE：映射为Remote-User-Preferred-Username头的SAML属性

卷

• /etc/httpd/conf.d/saml_idp.xml：必填，SAML身份提供商（IDP）元数据文件
• /etc/httpd/conf.d/saml_sp.key：SAML服务提供商（SP）密钥，未提供则自动生成
• /etc/httpd/conf.d/saml_sp.cert：SAML SP证书，未提供则自动生成
• /etc/httpd/conf.d/saml_sp.xml：SAML SP元数据，未提供则自动生成

Docker部署示例

docker run \
  -p 80:80 \
  -h auth.example.com \
  -v /local/path/saml_idp.xml:/etc/httpd/conf.d/saml_idp.xml \
  -e BACKEND=https://api.example.com:8443 \
  -e SCHEMA=http \
  -ti \
  barnabassudy/saml-proxy

Docker Compose示例

version: "2"
services:
  saml-proxy:
      image: "barnabassudy/saml-proxy"
      environment:
          BACKEND: "http://your-backend-service:8080"
          PROXY_HOST: "auth.yourdomain.com"
      ports:
          - "80:80"
      volumes:
          - ./saml_idp.xml:/etc/httpd/conf.d/saml_idp.xml

Kubernetes配置

待补充