druidfi/saml-idp

druidfi/saml-idp 镜像文档

镜像概述

druidfi/saml-idp是一个基于SimpleSAMLphp构建的测试身份提供商(IdP)镜像，主要用于本地开发环境中测试SAML单点登录(SSO)集成。该镜像提供了便捷的配置方式，可快速搭建本地测试IdP服务，支持与服务提供商(SP)进行SAML交互测试。

核心功能和特性

• 基于SimpleSAMLphp构建，符合SAML 2.0标准
• 提供预配置的测试IdP服务，无需复杂的初始设置
• 包含管理界面，便于查看和管理IdP配置
• 支持通过环境变量自定义IdP和SP相关配置
• 可与Traefik等反向代理工具配合使用，实现域名路由

使用场景和适用范围

适用于本地开发环境中需要测试SAML SSO集成的场景，例如：

• 开发人员测试服务提供商(SP)与IdP的SAML协议交互
• 验证SP的断言消费者服务(ACS)和单点登出服务(SLO)配置
• 本地调试SAML身份验证流程

使用方法和配置说明

基本部署示例（使用Docker Compose与Traefik）

以下示例通过Docker Compose配置镜像，并使用Traefik路由流量至容器：

yaml
idp:
  image: druidfi/saml-idp:2.0.2
  environment:
    # IdP的基础URL路径
    SIMPLESAMLPHP_IDP_BASEURLPATH: "https://idp.docker.so/simplesaml/"
    # SP的实体ID
    SIMPLESAMLPHP_SP_ENTITY_ID: "https://sp.docker.so"
    # SP的断言消费者服务(ACS)URL
    SIMPLESAMLPHP_SP_ASSERTION_CONSUMER_SERVICE: "https://sp.docker.so/simplesaml/module.php/saml/sp/saml2-acs.php/default-sp"
    # SP的单点登出服务(SLO)URL
    SIMPLESAMLPHP_SP_SINGLE_LOGOUT_SERVICE: "https://sp.docker.so/simplesaml/module.php/saml/sp/saml2-logout.php/default-sp"
  labels:
    # 启用Traefik路由
    - "traefik.enable=true"
    # 配置HTTPS入口点
    - "traefik.http.routers.idp.entrypoints=https"
    # 路由规则：匹配主机idp.docker.so
    - "traefik.http.routers.idp.rule=Host(`idp.docker.so`)"
    # 启用TLS加密
    - "traefik.http.routers.idp.tls=true"
    # 配置负载均衡器指向容器的8080端口
    - "traefik.http.services.idp.loadbalancer.server.port=8080"

访问管理界面

部署完成后，可通过以下URL访问IdP管理界面：
https://idp.docker.so/simplesaml/admin

默认管理员密码为：debugpass

环境变量说明

Traefik标签说明

示例中使用的Traefik标签用于配置反向代理：

• traefik.enable=true: 启用Traefik对该容器的路由
• traefik.http.routers.idp.entrypoints=https: 指定使用HTTPS入口点
• traefik.http.routers.idp.rule=Host(idp.docker.so): 基于主机名idp.docker.so进行路由匹配
• traefik.http.routers.idp.tls=true: 启用TLS加密
• traefik.http.services.idp.loadbalancer.server.port=8080: 指定容器内部服务端口为8080