itzg/saml-auth-proxy Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务
itzg/saml-auth-proxyitzg
为后端Web服务提供SAML Service Provider (SP)认证代理，实现无需修改后端服务即可添加SAML 2.0单点登录(SSO)功能。
下载次数: 0状态：社区镜像维护者：itzg仓库类型：镜像最近更新：4 个月前
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=[***] SAML_IDP_METADATA_URL=[***] SAML_SP_ENTITY_ID=[***] SAML_SP_ASSERTION_CONSUMER_SERVICE_URL=[***] 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]([***]
bitnami/oauth2-proxy
bitnami
Bitnami oauth2-proxy安全镜像，提供基于OAuth2协议的认证代理功能，用于保护Web应用访问安全，支持通过第三方OAuth2提供商验证用户身份并控制访问权限。
50 次收藏5000万+ 次下载
5 个月前更新
haproxytech/haproxy-debian
haproxytech
HAProxy社区版Docker Debian镜像，提供高性能的开源负载均衡和应用交付控制功能，支持TCP/HTTP代理、SSL终止、健康检查等特性，适用于构建可靠的流量管理解决方案。
9 次收藏1000万+ 次下载
24 天前更新
haproxytech/haproxy-alpine
haproxytech
HAProxy社区版Docker镜像，基于Alpine Linux构建，提供高性能负载均衡与反向代理功能，适用于构建轻量级、高可用的Web服务或应用集群。
18 次收藏500万+ 次下载
25 天前更新
authelia/authelia
authelia
云就绪的多因素认证门户，用于为应用提供安全认证服务。
204 次收藏5000万+ 次下载
22 天前更新
haproxytech/haproxy-ubuntu
haproxytech
HAProxy社区版Docker Ubuntu镜像
6 次收藏100万+ 次下载
24 天前更新
bitnamicharts/oauth2-proxy
bitnamicharts
Bitnami提供的OAuth2 Proxy Helm chart，用于在Kubernetes环境中简化OAuth2认证代理的部署与管理。
100万+ 次下载
6 个月前更新
镜像拉取常见问题
使用与功能问题
错误码与失败问题
manifest unknown 错误：镜像不存在或标签错误
manifest unknown 错误
TLS/SSL 证书验证失败：Docker pull 时 HTTPS 证书错误
TLS 证书验证失败
DNS 解析超时：无法解析镜像仓库地址或连接超时
DNS 解析超时
410 Gone 错误：Docker 版本过低导致协议不兼容
410 错误：版本过低
402 Payment Required 错误：流量耗尽错误提示
402 错误：流量耗尽
401 UNAUTHORIZED 错误：身份认证失败或登录信息错误
身份认证失败错误
429 Too Many Requests 错误：请求频率超出专业版限制
429 限流错误
Docker login 凭证保存错误：Cannot autolaunch D-Bus（不影响登录）
凭证保存错误
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"