热门搜索:
itzg/saml-auth-proxy
itzg
为后端Web服务提供SAML Service Provider (SP)认证代理，实现无需修改后端服务即可添加SAML 2.0单点登录(SSO)功能。
下载次数: 0状态：社区镜像维护者：itzg仓库类型：镜像最近更新：7 个月前
让 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 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
saml-auth-proxy 镜像文档
镜像概述
saml-auth-proxy是一个轻量级SAML Service Provider (SP)认证代理，通过反向代理模式为后端Web服务提供SAML 2.0认证能力。该镜像能够无缝集成SAML单点登录(SSO)流程，无需修改后端服务代码，即可实现与企业身份提供商(IdP)的认证集成。
核心功能与特性
- SAML 2.0合规：完整支持SAML 2.0协议标准，兼容主流身份提供商(IdP)如Okta、Azure AD、Keycloak、ADFS等
- 透明反向代理：认证通过后自动转发请求至后端服务，并维护用户会话
- 会话管理：支持基于加密Cookie的会话维持，可配置会话超时策略
- 灵活配置：通过环境变量或配置文件实现SAML参数、代理规则和安全策略的自定义
- 证书管理：支持自动生成或导入SP证书，简化部署流程
适用场景
- 为不原生支持SAML的遗留Web服务添加SSO认证
- 企业内部系统统一身份认证改造
- 多服务环境下的单点登录集成部署
- 快速为开发测试环境添加临时认证层
使用方法
基础部署（Docker Run）
bashdocker run --name saml-auth-proxy \ -p proxy_port>: proxy_port> \ -e PROXY_TARGET_URL="<backend_service_url>" \ -e SAML_IDP_METADATA_URL="<idp_metadata_url>" \ itzg/saml-auth-proxy
Docker Compose部署示例
yamlversion: '3.8' services:saml-auth-proxy: imageitzg/saml-auth-proxy ports proxy_port>: proxy_port>\environment PROXY_TARGET_URL=http://backend-service:8080 SAML_IDP_METADATA_URL=https://idp.example.com/metadata SAML_SP_ENTITY_ID=https://proxy.example.com/sp SAML_SP_ASSERTION_CONSUMER_SERVICE_URL=https://proxy.example.com/login/callbackSAML_SP_PRIVATE_KEY_PATH=/certs/sp-key.pem SAML_SP_CERTIFICATE_PATH=/certs/sp-cert.pem SESSION_COOKIE_SECURE=true SESSION_DURATION=PT8Hvolumes ./sp-certs:/certsdepends_on backend-servicebackend-service: image: your-backend-service:latest # 后端服务配置...
关键配置参数
核心代理配置
| 环境变量 | 描述 | 示例值 sp_port> | |---------------------------|"[]> | PROXY_TARGET_URL # 后端服务完整URL []"
SAML SP配置
| 参数 | 描述 sp_entity_id> | |-------------------------------|"urn:example:proxy:sp" SAML_SP_ENTITY_ID # SP实体唯一标识符 "[]" SAML_SP_ASSERTION_CONSUMER_SERVICE_URL | SAML断言消费端点URL "/certs/sp-cert.pem" SAML_SP_CERTIFICATE_PATH # SP公钥证书路径 "/certs/sp-key.pem" SAML_SP_PRIVATE_KEY_PATH # SP私钥路径 "[]"SAML_SP_SINGLE_LOGOUT_SERVICE_URL | 单点登出端点URL
SAML IdP配置
| 参数 # IdP Metadata XML文档URL "[***]" SAML_IDP_METADATA_URL | IdP签名验证证书路径（可选） "/certs/idp-cert.pem" SAML_IDP_CERTIFICATE_PATH | IdP唯一标识符（可选，如果metadata不可用） | "urn:saml:idp:example.com"SAML_IDP_ENTITY_ID
会话配置
| 参数 # 是否启用Secure Cookie标志 true
SESSION_COOKIE_SECURE=true | 会话有效期（ISO 8601格式） PT "SESSION_DURATION PT8H
SESSION_COOKIE_NAME # 用户会话Cookie名称 "_saml_session"
完整文档参考Official Documentation](https://github.comitzg/saml-auth-proxy)%E8%8E%B7%E5%8F%96%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E8%AF%B4%E6%98%8E%E9%AB%98%E7%BA%A7%E7%94%A8%E6%B3%95%E7%A4%BA%E4%BE%8B%E5%92%8C%E6%95%85%E9%9A%9C%E6%8E%92%E9%99%A4%E6%8C%87%E5%8D%97
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 saml-auth-proxy 镜像标签
docker pull docker.xuanyuan.run/itzg/saml-auth-proxy:<标签>
DockerHub 原生拉取命令
docker pull itzg/saml-auth-proxy:<标签>
更多 saml-auth-proxy 镜像推荐
haproxytech/haproxy-debian
haproxytech
HAProxy社区版Docker Debian镜像，提供高性能的开源负载均衡和应用交付控制功能，支持TCP/HTTP代理、SSL终止、健康检查等特性，适用于构建可靠的流量管理解决方案。
9 次收藏1000万+ 次下载
20 天前更新
haproxytech/haproxy-alpine
haproxytech
HAProxy社区版Docker镜像，基于Alpine Linux构建，提供高性能负载均衡与反向代理功能，适用于构建轻量级、高可用的Web服务或应用集群。
18 次收藏500万+ 次下载
20 天前更新
authelia/authelia
authelia
云就绪的多因素认证门户，用于为应用提供安全认证服务。
208 次收藏5000万+ 次下载
19 天前更新
haproxytech/haproxy-ubuntu
haproxytech
HAProxy社区版Docker Ubuntu镜像
6 次收藏100万+ 次下载
20 天前更新
bitnamicharts/oauth2-proxy
bitnamicharts
Bitnami提供的OAuth2 Proxy Helm chart，用于在Kubernetes环境中简化OAuth2认证代理的部署与管理。
100万+ 次下载
10 个月前更新
haproxytech/haproxy-qns
haproxytech
该Docker镜像包含用于HAProxy的QUIC互操作性测试文件
2 次收藏10万+ 次下载
19 天前更新
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"