kennethkl/saml-auth-proxy
kennethkl
提供SAML服务提供者（SP）认证代理，为后端Web服务添加SAML身份验证和授权能力，支持与SAML身份提供者（IdP）集成，保护服务访问安全。
下载次数: 0状态：社区镜像维护者：kennethkl仓库类型：镜像最近更新：8 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
镜像概述
本Docker镜像提供SAML服务提供者（SP）认证代理，可对后端Web服务进行SAML身份验证和授权，支持与各类SAML身份提供者（IdP）集成，帮助用户快速为后端服务添加单点登录（SSO）能力，保障服务访问的安全性。
核心功能
- 支持SAML SP认证流程，可选开启IdP发起的认证模式
- 将SAML IdP响应中的属性映射到转发给后端的请求头
- 基于SAML属性的细粒度授权机制，可指定授权属性及允许的值
- 提供健康检查端点
/_health，返回200状态码表示代理正常运行 - 新认证事件的Webhook通知功能，便于追踪用户登录行为
- 支持通过命令行参数或环境变量灵活配置
使用场景
- 企业内部Web应用需要统一身份认证（SSO）的场景
- 后端服务无原生SAML支持，需通过代理添加认证的场景
- 需要基于SAML属性（如用户ID、组）进行访问控制的场景
配置说明
主要参数（命令行/环境变量对应关系）
| 命令行参数 | 环境变量 | 说明 |
|---|---|---|
-allow-idp-initiated | SAML_PROXY_ALLOW_IDP_INITIATED | 允许IdP发起的认证流程 |
-attribute-header-mappings | SAML_PROXY_ATTRIBUTE_HEADER_MAPPINGS | SAML属性到请求头的映射（格式：属性=头名，逗号分隔） |
-authorize-attribute | SAML_PROXY_AUTHORIZE_ATTRIBUTE | 开启授权并指定检查的属性（区分大小写） |
-authorize-values | SAML_PROXY_AUTHORIZE_VALUES | 授权属性允许的值（逗号分隔） |
-backend-url | SAML_PROXY_BACKEND_URL | 后端服务的访问URL |
-base-url | SAML_PROXY_BASE_URL | 代理的外部访问URL |
-bind | SAML_PROXY_BIND | 代理监听地址和端口（默认:8080） |
-idp-metadata-url | SAML_PROXY_IDP_METADATA_URL | IdP元数据XML地址（支持本地文件file://） |
-sp-cert-path | SAML_PROXY_SP_CERT_PATH | SP公钥证书路径（默认saml-auth-proxy.cert） |
-sp-key-path | SAML_PROXY_SP_KEY_PATH | SP私钥路径（默认saml-auth-proxy.key） |
Docker部署示例
基础运行命令
bashdocker run -d \ -p 8080:8080 \ -e SAML_PROXY_BASE_URL=http://proxy.example.com:8080 \ -e SAML_PROXY_BACKEND_URL=http://backend:3000 \ -e SAML_PROXY_IDP_METADATA_URL=https://idp.example.com/metadata.xml \ -v /local/path/sp-cert.pem:/app/saml-auth-proxy.cert \ -v /local/path/sp-key.pem:/app/saml-auth-proxy.key \ docker.xuanyuan.run/kennethkl/saml-auth-proxy
带授权的运行命令
bashdocker run -d \ -p 8080:8080 \ -e SAML_PROXY_BASE_URL=http://proxy.example.com:8080 \ -e SAML_PROXY_BACKEND_URL=http://backend:3000 \ -e SAML_PROXY_IDP_METADATA_URL=https://idp.example.com/metadata.xml \ -e SAML_PROXY_AUTHORIZE_ATTRIBUTE=UserID \ -e SAML_PROXY_AUTHORIZE_VALUES=admin,dev \ -v /local/path/sp-cert.pem:/app/saml-auth-proxy.cert \ -v /local/path/sp-key.pem:/app/saml-auth-proxy.key \ docker.xuanyuan.run/kennethkl/saml-auth-proxy
注意事项
- 若后端应用使用AJAX/Fetch请求，需开启"same-origin"凭据模式，以利用代理的认证cookie
- 生成SP证书时，主题/CN需与代理的外部域名一致，否则会出现解密错误
- 授权属性名称需与SAML响应中
<saml:Attribute>的Name属性完全匹配 - 健康检查可通过访问
http://proxy-url/_health验证代理状态
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 saml-auth-proxy 镜像标签
docker pull docker.xuanyuan.run/kennethkl/saml-auth-proxy:<标签>
DockerHub 原生拉取命令
docker pull kennethkl/saml-auth-proxy:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"