szabogyula/saml-sp

SAML服务提供方（SP）镜像

镜像概述

本镜像基于Apache、Shibboleth和PHP构建，是一个高效的SAML 2.0服务提供方（SP）解决方案，支持通过环境变量实现灵活配置，可快速集成到需要单点登录（SSO）认证的系统中。

核心功能

• 支持SAML 2.0协议的单点登录认证流程
• 通过环境变量配置实体ID、元数据提供者、支持联系人等关键参数
• 提供XML静态元数据和动态元数据两种集成方式
• 可选启用断言加密增强安全性
• 支持自定义认证上下文类引用（如多因素认证等级）
• 允许临时禁用SSL（仅用于测试场景）

使用场景

• 企业内部系统的统一身份认证集成
• 教育机构与第三方服务的SSO对接
• 云应用或Web服务的SAML-based登录支持
• 跨组织的身份联合认证场景

配置说明

常用环境变量配置项：

• VIRTUAL_HOST: SP的虚拟主机名（如sp.example.com）
• ENTITY_ID: SP的唯一实体ID（如[***]
• DISCOVERY_URL: IdP发现服务URL（与IDP_ENTITY_ID二选一）
• IDP_ENTITY_ID: 指定的IdP实体ID（与DISCOVERY_URL二选一）
• SUPPORT_CONTACT: 技术支持联系人***
• ALIAS_SECURE: 安全资源的访问路径别名（如/secure）
• XML_METADATA_PROVIDER: XML格式的元数据文件URL（与DYNAMIC_METADATA_PROVIDER二选一）
• DYNAMIC_METADATA_PROVIDER: 动态元数据服务URL（如[***]
• APPLICATION_DEFAULTS_ENCRYPTION: 是否启用断言加密（可选，值为true时生效）
• AUTHN_CONTEXT_CLASS_REF: 认证上下文类引用（可选，如[***]
• NOSSL: 是否禁用SSL（仅测试用，值为true时生效）

使用示例

Docker Run

通过环境变量文件启动镜像：

bash
docker run --rm --env-file .env -p 443:442 --name saml-sp szabogyula/saml-sp

Docker Compose

可使用docker-compose管理服务，参考镜像内example目录的示例文件，结合.env.dist配置环境变量。

构建镜像

bash
docker build -t saml-sp .