gunet/simple-saml-sp

镜像概述

本镜像为基于simpleSAMLPHP的SAML服务提供者（SP）Docker容器，属于GUNet simpleidentity套件的一部分，支持与CAS SSO服务器或Shibboleth身份提供者（IdP）集成，用于单点登录系统的测试与部署验证。

核心功能

• 作为SAML SP提供身份验证服务，处理来自IdP的断言
• 容器启动时自动通过IDP_ENTITYID环境变量下载IdP元数据
• 支持配置SP主机名、端口及协议参数（如签名认证请求、加密断言等）
• 内置元数据转换工具，可手动处理IdP元数据文件

使用场景

• 测试simpleidentity套件中CAS SSO服务器的工作配置
• 验证自定义CAS或Shibboleth IdP的单点登录流程
• 多容器环境下的单点登录集成测试

配置说明

主要环境变量

• SIMPLESAMLPHP_SP_HOSTNAME：SP的主机名，默认值saml-sp
• SIMPLESAMLPHP_SP_PORT：SP的端口，默认值8080
• IDP_ENTITYID：IdP的实体ID，默认值https://host.docker.internal:8443/cas/idp
• IDP_METADATA_PATH：IdP元数据的路径，默认值/metadata（CAS SSO服务器默认路径）
• IDP_BASE_URL：Shibboleth IdP的基础URL（可选，用于无法通过EntityID直接下载元数据的场景）
• 协议相关变量：
  • SIMPLESAMLPHP_SP_SIGN_AUTHNREQUEST：是否签名认证请求，默认false
  • SIMPLESAMLPHP_SP_ENCRYPT_ASSERTION：是否要求IdP返回加密断言，默认false
  • SIMPLESAMLPHP_SP_SIGN_LOGOUT：是否签名登出请求，默认false

关键路径

• 主访问路径：http://<服务器地址>:8080/simplesaml
• SP元数据URL：http://<服务器地址>:8080/simplesaml/module.php/saml/sp/metadata.php/default-sp

部署示例

Docker Run命令

bash
docker run --rm --name saml-sp -d -p 8080:8080 [-e <环境变量>] gunet/simple-saml-sp

Docker Compose配置

yaml
saml-sp:
  image: gunet/simple-saml-sp
  ports:
    - ${SAML_SP_PORT:-8080}:8080
  environment:
    - IDP_ENTITYID=${CAS_SERVER_NAME:-https://host.docker.internal:8443}/cas/idp
    - SIMPLESAMLPHP_SP_HOSTNAME=${SIMPLESAMLPHP_SP_HOSTNAME:-host.docker.internal}
    - SIMPLESAMLPHP_SP_PORT=${SIMPLESAMLPHP_SP_PORT:-8080}
  extra_hosts:
    - "host.docker.internal:host-gateway"
  depends_on:
    ldap:
      condition: service_healthy
    sso:
      condition: service_healthy

额外文档

• SP配置文件：config/authsources.php
• 远程IdP配置文件：metadata/saml20-idp-remote.php
• SP元数据可通过Web界面的“Federation”标签页查看